SQLProcedureColumns

Si applica a: SQL Server database SQL di Azure Istanza gestita di SQL di Azure azure Synapse Analytics Analytics Platform System (PDW)

SQLProcedureColumns restituisce una riga che segnala gli attributi del valore restituito di tutte le stored procedure di SQL Server.

SQLProcedureColumns restituisce SQL_SUCCESS se esistono o meno valori per i parametri CatalogName, SchemaName, ProcName o ColumnName . SQLFetch restituisce SQL_NO_DATA quando in questi parametri vengono usati valori non validi.

SQLProcedureColumns può essere eseguito in un cursore del server statico. Un tentativo di esecuzione di SQLProcedureColumns in un cursore aggiornabile (dinamico o keyset) restituirà SQL_SUCCESS_WITH_INFO indicante che il tipo di cursore è stato modificato.

Nella tabella seguente sono elencate le colonne restituite dal set di risultati e il modo in cui sono state estese per gestire i tipi di dati udt e xml tramite 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 simile 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.

Le colonne SS_TYPE_CATALOG_NAME e SS_TYPE_SCHEMA_NAME sono disponibili rispettivamente in SQL Server 2008 (10.0.x) e versioni successive 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. Le colonne dello schema e del catalogo esistenti per i parametri di tipo CLR definiti dall'utente non sono interessate da questa funzionalità aggiuntiva. Vengono popolati 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 visualizzate prima di tutte le colonne specifiche del driver aggiunte nelle versioni precedenti di SQL Server e dopo tutte le colonne richieste da ODBC stesso.

Per altre 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 i valori restituiti per i tipi di data/ora, vedere Metadati del catalogo.

Per altre informazioni generali, vedere Miglioramenti di data e ora (ODBC).

Supporto di SQLProcedureColumns per tipi CLR definiti dall'utente di grandi dimensioni

SQLProcedureColumns supporta tipi CLR definiti dall'utente di grandi dimensioni. Per altre informazioni, vedere Tipi CLR definiti dall'utente (ODBC) di grandi dimensioni.

Vedi anche

Funzione SQLProcedureColumns
Dettagli di implementazione dell'API ODBC