sp_sproc_columns (Transact-SQL)
Restituisce informazioni relative alle colonne per una sola stored procedure o funzione definita dall'utente nell'ambiente corrente.
.gif "Icona di collegamento a un argomento")
Sintassi
sp_sproc_columns [[@procedure_name = ] 'name']
[ , [@procedure_owner = ] 'owner']
[ , [@procedure_qualifier = ] 'qualifier']
[ , [@column_name = ] 'column_name']
[ , [@ODBCVer = ] 'ODBCVer']
[ , [@fUsePattern = ] 'fUsePattern']
Argomenti
[ @procedure_name = ] 'name'
Nome della procedura sulla quale si desidera ottenere informazioni di catalogo. name è di tipo nvarchar(390) e il valore predefinito è %, che indica tutte le tabelle del database corrente. Le ricerche con caratteri jolly sono supportate.[ @procedure_owner =] 'owner'
Nome del proprietario della procedura. owner è di tipo nvarchar(384) e il valore predefinito è NULL. Le ricerche con caratteri jolly sono supportate. Se owner viene omesso, vengono applicate le regole di visibilità predefinite della procedura del sistema DBMS sottostante.Se l'utente corrente è il proprietario di una procedura avente il nome specificato, vengono restituite informazioni su tale procedura. Se owner viene omesso e l'utente corrente non è il proprietario di una procedura avente il nome specificato, sp_sproc_columns esegue la ricerca di una procedura avente il nome specificato e il cui proprietario corrisponde al proprietario del database. Se tale procedura viene individuata, vengono restituite informazioni sulle colonne corrispondenti.
[ @procedure_qualifier =] 'qualifier'
Nome del qualificatore della procedura. qualifier è di tipo sysname e il valore predefinito è NULL. Vari prodotti DBMS supportano i nomi di tabella composti da tre parti, ovvero qualifier.owner.name. In SQL Server questo parametro rappresenta il nome del database. In altri prodotti rappresenta il nome del server dell'ambiente di database della tabella.[ @column_name =] 'column_name'
Colonna singola utilizzata quando si desidera recuperare una sola colonna di informazioni di catalogo. column_name è di tipo nvarchar(384) e il valore predefinito è NULL. Se column_name viene omesso, vengono restituite tutte le colonne. Le ricerche con caratteri jolly sono supportate. Per ottenere la massima interoperabilità, è consigliabile che nel client del gateway vengano utilizzati solo i caratteri jolly dello standard ISO, ovvero i caratteri % e _.[ @ODBCVer =] 'ODBCVer'
Versione di ODBC in uso. ODBCVer è di tipo int e il valore predefinito è 2, che corrisponde a ODBC versione 2.0. Per ulteriori informazioni sulla differenza tra la versione 2.0 e 3.0 di ODBC, vedere la specifica ODBC SQLProcedureColumns di ODBC versione 3.0.[ @fUsePattern =] 'fUsePattern'
Determina se il carattere di sottolineatura ( _ ), il simbolo di percentuale ( % ) e le parentesi quadre ( [ ] ) vengono interpretate come caratteri jolly. I valori validi sono 0 (utilizzo dei criteri di ricerca disattivato) e 1 (utilizzo dei criteri di ricerca attivato). fUsePattern è di tipo bit e il valore predefinito è 1.
Valori restituiti
Nessuno
Set di risultati
Nome colonna |
Tipo di dati |
Descrizione |
|---|---|---|
PROCEDURE_QUALIFIER |
sysname |
Nome del qualificatore della procedura. Questa colonna può essere NULL. |
PROCEDURE_OWNER |
sysname |
Nome del proprietario della procedura. In questa colonna viene sempre restituito un valore. |
PROCEDURE_NAME |
nvarchar(134) |
Nome della procedura. In questa colonna viene sempre restituito un valore. |
COLUMN_NAME |
sysname |
Nome di ogni colonna della tabella TABLE_NAME restituita. In questa colonna viene sempre restituito un valore. |
COLUMN_TYPE |
smallint |
In questo campo viene sempre restituito un valore. 0 = SQL_PARAM_TYPE_UNKNOWN 1 = SQL_PARAM_TYPE_INPUT 2 = SQL_PARAM_TYPE_OUTPUT 3 = SQL_RESULT_COL 4 = SQL_PARAM_OUTPUT 5 = SQL_RETURN_VALUE |
DATA_TYPE |
smallint |
Codice integer di un tipo di dati ODBC. Se non è possibile effettuare il mapping di questo tipo di dati a un tipo ISO, il valore è NULL. Il nome del tipo di dati nativo viene restituito nella colonna TYPE_NAME. |
TYPE_NAME |
sysname |
Rappresentazione in forma di stringa del tipo di dati. Corrisponde al nome del tipo di dati visualizzato dal sistema DBMS sottostante. |
PRECISION |
int |
Numero di cifre significative. Il valore restituito per la colonna PRECISION è in base 10. |
LENGTH |
int |
Dimensioni di trasferimento dei dati. |
SCALE |
smallint |
Numero di cifre a destra del separatore decimale. |
RADIX |
smallint |
Base per i tipi di dati numerici. |
NULLABLE |
smallint |
Specifica se i valori Null sono supportati o meno: 1 = È possibile creare il tipo di dati con supporto per valori Null. 0 = I valori Null non sono supportati. |
REMARKS |
varchar(254) |
Descrizione della colonna della procedura. In SQL Server non viene restituito alcun valore per questa colonna. |
COLUMN_DEF |
nvarchar(4000) |
Valore predefinito della colonna. |
SQL_DATA_TYPE |
smallint |
Valore del tipo di dati SQL visualizzato nel campo TYPE del descrittore. Questa colonna è analoga alla colonna DATA_TYPE, a eccezione dei tipi di dati datetime e ISO interval. In questa colonna viene sempre restituito un valore. |
SQL_DATETIME_SUB |
smallint |
Sottocodice datetime ISO interval se il valore di SQL_DATA_TYPE è SQL_DATETIME o SQL_INTERVAL. Per i tipi di dati diversi da datetime e ISO interval, questo campo è NULL. |
CHAR_OCTET_LENGTH |
int |
Lunghezza massima in byte di una colonna di tipo character o binary. Per gli tutti gli altri tipi di dati, il valore di questa colonna è NULL. |
ORDINAL_POSITION |
int |
Posizione ordinale della colonna nella tabella. 1 corrisponde alla prima colonna nella tabella. In questa colonna viene sempre restituito un valore. |
IS_NULLABLE |
varchar(254) |
Supporto dei valori Null per la colonna nella tabella. Per determinare il supporto di valori Null vengono seguite le regole ISO. In un sistema DBMS conforme a ISO non vengono restituite stringhe vuote. Se la colonna ammette valori Null, viene visualizzato YES. In caso contrario viene visualizzato NO. Questa colonna restituisce una stringa di lunghezza zero quando non è noto se i valori Null sono supportati o meno. Il valore restituito per questa colonna è diverso dal valore restituito per la colonna NULLABLE. |
SS_DATA_TYPE |
tinyint |
Tipo di dati di SQL Server utilizzato dalle stored procedure estese. Per ulteriori informazioni, vedere Tipi di dati (Transact-SQL). |
Osservazioni
sp_sproc_columns corrisponde a SQLProcedureColumns in ODBC. I risultati restituiti vengono ordinati in base alle colonne PROCEDURE_QUALIFIER, PROCEDURE_OWNER e PROCEDURE_NAME e all'ordine dei parametri nella definizione della procedura.
Autorizzazioni
È richiesta l'autorizzazione SELECT per lo schema.
Vedere anche