Condividi tramite

  • Articolo

sp_sproc_columns (Transact-SQL)

Restituisce informazioni relative alle colonne per una sola stored procedure o funzione definita dall'utente nell'ambiente corrente.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

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.