SQLProcedureColumns
SQLProcedureColumns restituisce una riga che riporta gli attributi del valore restituito di tutte le stored procedure di SQL Server.
SQLProcedureColumns restituisce SQL_SUCCESS indipendentemente dall'esistenza di valori per i parametri CatalogName, SchemaName, ProcName o ColumnName. SQLFetch restituisce SQL_NO_DATA quando in questi parametri vengono utilizzati valori non validi.
SQLProcedureColumns può essere eseguito su un cursore del server statico. Un tentativo di eseguire SQLProcedureColumns su un cursore aggiornabile (dinamico o keyset) restituirà SQL_SUCCESS_WITH_INFO che indica che il tipo di cursore è stato modificato.
Nella tabella seguente sono elencate le colonne restituite dal set di risultati e le relative modalità di estensione per la gestione dei tipi di dati udt e xml mediante il driver ODBC di SQL Server Native Client:
Nome colonna |
Descrizione |
|---|---|
SS_UDT_CATALOG_NAME |
Restituisce il nome del catalogo contenente il tipo definito dall'utente. |
SS_UDT_SCHEMA_NAME |
Restituisce il nome dello schema contenente il tipo definito dall'utente. |
SS_UDT_ASSEMBLY_TYPE_NAME |
Restituisce il nome completo dell'assembly del tipo definito dall'utente. |
SS_XML_SCHEMACOLLECTION_CATALOG_NAME |
Restituisce il nome del catalogo nel quale è definito il nome di una raccolta di XML Schema. Se non è possibile trovare il nome del catalogo, questa variabile contiene una stringa vuota. |
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME |
Restituisce il nome dello schema nel quale è definito il nome di una raccolta di XML Schema. Se non è possibile trovare il nome dello schema, questa variabile contiene una stringa vuota. |
SS_XML_SCHEMACOLLECTION_NAME |
Restituisce il nome di una raccolta di XML Schema. Se non è possibile trovare il nome, questa variabile contiene una stringa vuota. |
SQLProcedureColumns e parametri con valori di tabella
SQLProcedureColumns gestisce i parametri con valori di tabella in modo analogo ai tipi CLR definiti dall'utente. Nelle righe restituite per i parametri con valori di tabella le colonne presentano i valori seguenti:
Nome colonna |
Descrizione/valore |
|---|---|
DATA_TYPE |
SQL_SS_TABLE |
TYPE_NAME |
Nome del tipo di tabella per il parametro con valori di tabella. |
COLUMN_SIZE |
NULL |
BUFFER_LENGTH |
0 |
DECIMAL_DIGITS |
Il numero delle colonne presenti nel parametro con valori di tabella. |
NUM_PREC_RADIX |
NULL |
NULLABLE |
SQL_NULLABLE |
REMARKS |
NULL |
COLUMN_DEF |
NULL I tipi di tabella potrebbero non avere valori predefiniti. |
SQL_DATA_TYPE |
SQL_SS_TABLE |
SQL_DATEIME_SUB |
NULL |
CHAR_OCTET_LENGTH |
NULL |
IS_NULLABLE |
"YES" |
SS_TYPE_CATALOG_NAME |
Restituisce il nome del catalogo contenente la tabella o il tipo CLR definito dall'utente. |
SS_TYPE_SCHEMA_NAME |
Restituisce il nome dello schema contenente la tabella o il tipo CLR definito dall'utente. |
In SQL Server 2008 e versioni successive sono disponibili le colonne SS_TYPE_CATALOG_NAME e SS_TYPE_SCHEMA_NAME per restituire rispettivamente il catalogo e lo schema per i parametri con valori di tabella. Tali colonne vengono popolate per i parametri con valori di tabella e anche per i parametri del tipo CLR definito dall'utente. Questa funzionalità aggiuntiva non influenza le colonne di catalogo e di schema esistenti per i parametri del tipo CLR definito dall'utente. Vengono popolate anche per mantenere la compatibilità con le versioni precedenti.
In conformità con la specifica ODBC, SS_TYPE_CATALOG_NAME e SS_TYPE_SCHEMA_NAME vengono visualizzati prima di tutte le colonne specifiche del driver che sono state aggiunte nelle versioni precedenti di SQL Server e dopo tutte le colonne richieste da ODBC stesso.
Per ulteriori informazioni sui parametri con valori di tabella, vedere Parametri con valori di tabella (ODBC).
Supporto di SQLProcedureColumns per le caratteristiche avanzate di data e ora
Per informazioni sui valori restituiti per i tipi data/ora, vedere Metadati del catalogo.
Per informazioni più generali, vedere Miglioramenti relativi a data e ora (ODBC).
Supporto di SQLProcedureColumns per tipi CLR definiti dall'utente di grandi dimensioni
SQLProcedureColumns supporta i tipi CLR definiti dall'utente di grandi dimensioni. Per ulteriori informazioni, vedere Tipi CLR definiti dall'utente di grandi dimensioni (ODBC).
Vedere anche
Concetti
Dettagli di implementazione di API ODBC