sp_sproc_columns (Transact-SQL)

  • Articolo

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_QUALIFIERbase a , PROCEDURE_OWNERPROCEDURE_NAME, e all'ordine in cui i parametri vengono visualizzati nella definizione della routine.

Autorizzazioni

È richiesta SELECT l'autorizzazione per lo schema.

Contenuto correlato