sp_sproc_columns (Transact-SQL)
Si applica a: SQL Server database SQL di Azure Istanza gestita di SQL di Azure endpoint di analisi SQL di Azure Synapse Analytics Platform System (PDW) in Microsoft Fabric Warehouse in Microsoft Fabric
Restituisce informazioni relative alle colonne per una sola stored procedure o funzione definita dall'utente nell'ambiente corrente.
Convenzioni relative alla sintassi Transact-SQL
Sintassi
sp_sproc_columns
[ [ @procedure_name = ] N'procedure_name' ]
[ , [ @procedure_owner = ] N'procedure_owner' ]
[ , [ @procedure_qualifier = ] N'procedure_qualifier' ]
[ , [ @column_name = ] N'column_name' ]
[ , [ @ODBCVer = ] ODBCVer ]
[ , [ @fUsePattern = ] fUsePattern ]
[ ; ]
Argomenti
[ @procedure_name = ] N'procedure_name'
Nome della procedura utilizzata per restituire informazioni sul catalogo. @procedure_name è nvarchar(390), con un valore predefinito %
, ovvero tutte le tabelle nel database corrente. La ricerca con caratteri jolly è supportata.
[ @procedure_owner = ] N'procedure_owner'
Nome del proprietario della routine. @procedure_owner è nvarchar(384), con il valore predefinito NULL
. La ricerca con caratteri jolly è supportata. Se non viene specificato @procedure_owner , si applicano le regole di visibilità delle procedure predefinite del sistema di gestione del database sottostante.
Se l'utente corrente è il proprietario di una procedura avente il nome specificato, vengono restituite informazioni su tale procedura. Se @procedure_owner non è specificato e l'utente corrente non possiede una routine con il nome specificato, sp_sproc_columns
cerca una routine con il nome specificato di proprietà del proprietario del database. Se tale procedura viene individuata, vengono restituite informazioni sulle colonne corrispondenti.
[ @procedure_qualifier = ] N'procedure_qualifier'
Nome del qualificatore di routine. @procedure_qualifier è sysname, con il valore predefinito NULL
. Vari prodotti DBMS supportano la denominazione in tre parti per le tabelle (<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 = ] N'column_name'
Una singola colonna e viene utilizzata quando si desidera una sola colonna di informazioni sul catalogo. @column_name è nvarchar(384), con il valore predefinito NULL
. Se @column_name viene omesso, vengono restituite tutte le colonne. La ricerca con caratteri jolly è supportata. 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 utilizzata. @ODBCVer è int, con un valore predefinito 2
, che indica ODBC versione 2.0. Per altre informazioni sulle differenze tra ODBC versione 2.0 e ODBC versione 3.0, vedere la specifica ODBC SQLProcedureColumns
per ODBC versione 3.0.
[ @fUsePattern = ] fUsePattern
Determina se i caratteri di sottolineatura (_
), percentuale (%
) e parentesi quadre ([
e ]
) vengono interpretati come caratteri jolly. @fUsePattern è bit, con un valore predefinito .1
I valori validi sono 0
(la corrispondenza dei criteri è disattivata) e 1
(la corrispondenza dei criteri è attivata).
Valori del codice restituito
Nessuno.
Set di risultati
Nome colonna | Tipo di dati | Descrizione |
---|---|---|
PROCEDURE_QUALIFIER |
sysname | Nome di qualificatore della procedura. Questa colonna può essere NULL . |
PROCEDURE_OWNER |
sysname | Nome del proprietario della procedura. Questa colonna restituisce sempre un valore . |
PROCEDURE_NAME |
nvarchar(134) | Nome della procedura. Questa colonna restituisce sempre un valore . |
COLUMN_NAME |
sysname | Nome colonna per ogni colonna dell'oggetto TABLE_NAME restituito. Questa colonna restituisce sempre 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 eseguire il mapping di questo tipo di dati a un tipo ISO, il valore è NULL . Il nome del tipo di dati nativo viene restituito nella TYPE_NAME colonna . |
TYPE_NAME |
sysname | Rappresentazione in forma di stringa del tipo di dati. Questo valore è il nome del tipo di dati presentato dal sistema DBMS sottostante. |
PRECISION |
int | Numero di cifre significative. Il valore restituito per la PRECISION colonna è 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 numerici. |
NULLABLE |
smallint | Specifica se i valori Null sono supportati o meno:1 = Il tipo di dati può essere creato consentendo valori Null.0 = I valori Null non sono consentiti. |
REMARKS |
varchar(254) | Descrizione della colonna della procedura. SQL Server non restituisce un valore per questa colonna. |
COLUMN_DEF |
nvarchar(4000) | Valore predefinito della colonna. |
SQL_DATA_TYPE |
smallint | Valore del tipo di dati SQL visualizzato nel TYPE campo del descrittore. Questa colonna è la stessa della DATA_TYPE colonna, ad eccezione dei tipi di dati datetime e ISO interval . Questa colonna restituisce sempre un valore . |
SQL_DATETIME_SUB |
smallint | Codice secondario dell'intervallo ISO datetime se il valore di SQL_DATA_TYPE è SQL_DATETIME o SQL_INTERVAL . Per i tipi di dati diversi da datetime e intervallo ISO, questo campo è NULL . |
CHAR_OCTET_LENGTH |
int | Lunghezza massima in byte di una colonna di tipo carattere o binario . Per tutti gli altri tipi di dati, questa colonna restituisce un oggetto NULL . |
ORDINAL_POSITION |
int | Posizione ordinale della colonna nella tabella. La prima colonna della tabella è 1 . Questa colonna restituisce sempre un valore . |
IS_NULLABLE |
varchar(254) | Impostazione relativa al supporto di valori Null nella colonna della tabella. Per determinare il supporto di valori Null vengono seguite le regole ISO. Un DBMS conforme a ISO non può restituire una stringa vuota. Visualizza YES se la colonna può includere valori Null e NO se la colonna non può includere valori Null.Quando non è noto se i valori Null sono supportati, in questa colonna viene restituita una stringa di lunghezza zero. Il valore restituito per questa colonna è diverso dal valore restituito per la NULLABLE colonna. |
SS_DATA_TYPE |
tinyint | Tipo di dati di SQL Server usato dalle stored procedure estese. Per altre informazioni, vedere Tipi di dati (Transact-SQL). |
Osservazioni:
sp_sproc_columns
equivale a SQLProcedureColumns
in ODBC. I risultati restituiti vengono ordinati in PROCEDURE_QUALIFIER
base a , PROCEDURE_OWNER
PROCEDURE_NAME
, e all'ordine in cui i parametri vengono visualizzati nella definizione della routine.
Autorizzazioni
È richiesta SELECT
l'autorizzazione per lo schema.