SQLProcedureColumns
Si applica a:
SQL ServerDatabase SQL di AzureIstanza gestita di SQL di AzureAzure Synapse AnalyticsPiattaforma di strumenti analitici (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_DATETIME_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