Argumentos em funções de catálogo

  • Artigo

Todas as funções do catálogo aceitam argumentos com os quais um aplicativo pode restringir o escopo dos dados retornados. Por exemplo, a primeira e a segunda chamadas para SQLTables no código a seguir retornam um conjunto de resultados que contém informações sobre todas as tabelas, enquanto a terceira chamada retorna informações sobre a tabela Orders:

SQLTables(hstmt1, NULL, 0, NULL, 0, NULL, 0, NULL, 0);  
SQLTables(hstmt2, NULL, 0, NULL, 0, "%", SQL_NTS, NULL, 0);  
SQLTables(hstmt3, NULL, 0, NULL, 0, "Orders", SQL_NTS, NULL, 0);

Os argumentos de cadeia de caracteres da função de catálogo se enquadram em quatro tipos diferentes: argumento comum (OA), argumento de valor padrão (PV), argumento de identificador (ID) e argumento de lista de valores (VL). A maioria dos argumentos de cadeia pode ser de um de dois tipos diferentes, dependendo do valor do atributo de instrução SQL_ATTR_METADATA_ID. A tabela a seguir lista os argumentos de cada função de catálogo e descreve o tipo do argumento para um valor SQL_TRUE ou SQL_FALSE de SQL_ATTR_METADATA_ID.

Função Argumento Tipo quando SQL_

ATTR_METADATA_

ID = SQL_FALSE		 Tipo quando SQL_

ATTR_METADATA_

ID = SQL_TRUE
SQLColumnPrivileges CatalogNameSchemaNameTableNameColumnName OA OA OA PV ID ID ID ID
SQLColumns CatalogNameSchemaNameTableNameColumnName OA PV PV PV ID ID ID ID
SQLForeignKeys PKCatalogNamePKSchemaNamePKTableNameFKCatalogNameFKSchemaNameFKTableName OA OA OA OA OA OA ID ID ID ID ID ID
SQLPrimaryKeys CatalogNameSchemaNameTableName OA OA OA ID ID ID
SQLProcedureColumns CatalogNameSchemaNameProcNameColumnName OA PV PV PV ID ID ID ID
SQLProcedures CatalogNameSchemaNameProcName OA PV PV ID ID ID
SQLSpecialColumns CatalogNameSchemaNameTableName OA OA OA ID ID ID
SQLStatistics CatalogNameSchemaNameTableName OA OA OA ID ID ID
SQLTablePrivileges CatalogNameSchemaNameTableName OA PV PV ID ID ID
SQLTables CatalogNameSchemaNameTableNameTableType PV PV PV VL ID ID ID VL

Esta seção contém os tópicos a seguir.