Condividi tramite

sp_columns (Transact-SQL)

  • Articolo

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW) Endpoint di analisi SQL in Microsoft Fabric Warehouse in Microsoft Fabric

Vengono restituite le informazioni di colonna per gli oggetti specificati per cui è possibile eseguire una query nell'ambiente corrente.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_columns
    [ @table_name = ] N'table_name'
    [ , [ @table_owner = ] N'table_owner' ]
    [ , [ @table_qualifier = ] N'table_qualifier' ]
    [ , [ @column_name = ] N'column_name' ]
    [ , [ @ODBCVer = ] ODBCVer ]
[ ; ]

Argomenti

[ @table_name = ] N'table_name'

@table_name è nvarchar(384), senza impostazione predefinita.

Nome dell'oggetto utilizzato per restituire informazioni sul catalogo. @table_name può essere una tabella, una vista o un altro oggetto che è una colonna, ad esempio funzioni con valori di tabella. @table_name è nvarchar(384), senza impostazione predefinita. La ricerca con caratteri jolly è supportata.

[ @table_owner = ] N'table_owner'

Proprietario dell'oggetto utilizzato per restituire informazioni sul catalogo. @table_owner è nvarchar(384), con il valore predefinito NULL. La ricerca con caratteri jolly è supportata. Se non viene specificato @table_owner , si applicano le regole di visibilità degli oggetti predefinite del sistema DBMS sottostante.

Se l'utente corrente è il proprietario di un oggetto con il nome specificato, vengono restituite le colonne di tale oggetto. Se @table_owner non è specificato e l'utente corrente non è proprietario di un oggetto con il @table_name specificato, sp_columns cerca un oggetto con il @table_name specificato di proprietà del proprietario del database. Se viene individuato, vengono restituite le colonne di tale oggetto.

[ @table_qualifier = ] N'table_qualifier'

@table_qualifier è sysname, con un valore predefinito .NULL

Nome del qualificatore dell'oggetto. @table_qualifier è sysname, con un valore predefinito .NULL Vari prodotti DBMS supportano la denominazione in tre parti per gli oggetti (<qualifier>.<owner>.<name>). In SQL Server questa colonna rappresenta il nome del database. In alcuni prodotti rappresenta il nome del server dell'ambiente di database dell'oggetto.

[ @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 non viene specificato, vengono restituite tutte le colonne. In SQL Server @column_name rappresenta il nome della colonna come indicato nella syscolumns tabella. La ricerca con caratteri jolly è supportata. Per garantire l'interoperabilità massima, il client gateway deve presupporre solo la corrispondenza dei criteri standard DI SQL-92 (caratteri % jolly e _ ).

[ @ODBCVer = ] ODBCVer

Versione di ODBC in uso. @ODBCVer è int, con un valore predefinito .2 che indica ODBC versione 2. I valori validi sono 2 o 3. Per le differenze di comportamento tra le versioni 2 e 3, vedere la specifica ODBC SQLColumns .

Valori del codice restituito

Nessuno.

Set di risultati

La sp_columns stored procedure del catalogo equivale a SQLColumns in ODBC. I risultati restituiti vengono ordinati in TABLE_QUALIFIERbase a , TABLE_OWNERe TABLE_NAME.

Nome colonna Tipo di dati Descrizione
TABLE_QUALIFIER sysname Nome del qualificatore dell'oggetto. Questo campo può essere NULL.
TABLE_OWNER sysname Nome del proprietario dell'oggetto. Questo campo restituisce sempre un valore.
TABLE_NAME sysname Nome dell'oggetto. Questo campo restituisce sempre un valore.
COLUMN_NAME sysname Nome colonna, per ogni colonna dell'oggetto TABLE_NAME restituito. Questo campo restituisce sempre un valore.
DATA_TYPE smallint Codice integer per il tipo di dati ODBC. Se questo tipo di dati non può essere mappato a un tipo ODBC, è NULL. Il nome del tipo di dati nativo viene restituito nella TYPE_NAME colonna .
TYPE_NAME sysname Stringa che rappresenta un tipo di dati. Il DBMS sottostante utilizza questo nome del tipo di dati.
PRECISION int Numero di cifre significative. Il valore restituito per la PRECISION colonna è in base 10.
LENGTH int Dimensioni di trasferimento dei dati. 1
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.

1 = NULL è possibile.
0 = NOT NULL.
REMARKS varchar(254) Questo campo restituisce NULLsempre .
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 è la stessa della DATA_TYPE colonna, ad eccezione dei tipi di dati datetime e SQL-92 interval . Questa colonna restituisce sempre un valore .
SQL_DATETIME_SUB smallint Codice del sottotipo per i tipi di dati datetime e SQL-92 interval . Per altri tipi di dati, questa colonna restituisce NULL.
CHAR_OCTET_LENGTH int Lunghezza massima, espressa in byte, di una colonna di tipo carattere o integer. Per tutti gli altri tipi di dati, questa colonna restituisce NULL.
ORDINAL_POSITION int Posizione ordinale della colonna nell'oggetto. La prima colonna nell'oggetto è 1. Questa colonna restituisce sempre un valore .
IS_NULLABLE varchar(254) Supporto di valori Null della colonna dell'oggetto. Per determinare il supporto di valori Null vengono seguite le regole ISO. Un DBMS conforme a ISO SQL non può restituire una stringa vuota.

YES = La colonna può includere NULL.
NO = La colonna non può includere 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 ulteriori informazioni, vedi Tipi di dati.

1 Per altre informazioni, vedere Panoramica di ODBC.

Autorizzazioni

Richiede SELECT le autorizzazioni e VIEW DEFINITION per lo schema.

Osservazioni:

sp_columns segue i requisiti per gli identificatori delimitati. Per altre informazioni, vedere Identificatori di database.

Esempi

Gli esempi di codice Transact-SQL in questo articolo utilizzano il database campione AdventureWorks2022 o AdventureWorksDW2022, che è possibile scaricare dalla home page di Esempi di Microsoft SQL Server e progetti collettivi.

Nell'esempio seguente vengono restituite informazioni sulle colonne della tabella specificata.

USE AdventureWorks2022;
GO

EXEC sp_columns
    @table_name = N'Department',
    @table_owner = N'HumanResources';

Esempi: Azure Synapse Analytics e Piattaforma di strumenti analitici (PDW)

Nell'esempio seguente vengono restituite informazioni sulle colonne della tabella specificata.

USE AdventureWorksDW2022;
GO

EXEC sp_columns
    @table_name = N'DimEmployee',
    @table_owner = N'dbo';

Contenuto correlato