sp_sproc_columns (Transact-SQL)

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

Convenzioni 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.

  In SQL Server 2005 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 siano utilizzati solo i caratteri jolly standard SQL-92, 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.

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 SQL-92, 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 corrisponde alla colonna DATA_TYPE, tranne per i tipi di dati datetime e interval SQL-92. In questa colonna viene sempre restituito un valore.
SQL_DATETIME_SUB	smallint	Sottocodice interval SQL-92 per il tipo di dati datetime se il valore di SQL_DATA_TYPE è SQL_DATETIME o SQL_INTERVAL. Per i tipi di dati diversi da datetime e interval SQL-92, il valore di 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 SQL non vengono restituite stringhe vuote. Se la colonna supporta 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.

Valori restituiti

Nessuno

Vedere anche

Riferimento

Stored procedure di catalogo (Transact-SQL)
Stored procedure di sistema (Transact-SQL)

Guida in linea e informazioni

Assistenza su SQL Server 2005