Argomenti nelle funzioni di catalogo

  • Articolo

Tutte le funzioni catalogo accettano argomenti con cui un'applicazione può limitare l'ambito dei dati restituiti. Ad esempio, la prima e la seconda chiamata a SQLTables nel codice seguente restituiscono un set di risultati contenente informazioni su tutte le tabelle, mentre la terza chiamata restituisce informazioni sulla tabella 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);

Gli argomenti della stringa della funzione catalogo rientrano in quattro tipi diversi: argomento ordinario (OA), argomento valore modello (PV), argomento identificatore (ID) e argomento elenco dei valori (VL). La maggior parte degli argomenti della stringa può essere di uno dei due diversi tipi, a seconda del valore dell'attributo dell'istruzione SQL_ATTR_METADATA_ID. Nella tabella seguente sono elencati gli argomenti di ogni funzione catalogo e viene descritto il tipo di argomento per un valore SQL_TRUE o SQL_FALSE di SQL_ATTR_METADATA_ID.

Funzione Argomento 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

Questa sezione descrive gli argomenti seguenti: