COL_NAME (Transact-SQL)

Articolo
12/22/2023

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Analytics Platform System (PDW)

Questa funzione restituisce il nome di una colonna di tabella, in base ai valori del numero di identificazione della tabella e della colonna.

Convenzioni di sintassi Transact-SQL

Sintassi

COL_NAME ( table_id , column_id )

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

table_id
Numero di identificazione della tabella contenente la colonna. L'argomento table_id ha un tipo di dati int.

column_id
Numero di identificazione della colonna. L'argomento column_id ha un tipo di dati int.

Tipi restituiti

sysname

Eccezioni

Restituisce NULL in caso di errore o se un chiamante non ha l'autorizzazione corretta per visualizzare l'oggetto.

In SQL Server un utente può visualizzare esclusivamente i metadati delle entità a sicurezza diretta di cui è proprietario o per cui ha ricevuto un'autorizzazione. Di conseguenza, le funzioni predefinite di creazione dei metadati come COL_NAME possono restituire NULL se l'utente non ha le autorizzazioni corrette per l'oggetto. Per altre informazioni, vedere Configurazione della visibilità dei metadati.

Osservazioni:

La combinazione dei parametri table_id e column_id restituisce la stringa del nome di colonna.

Per altre informazioni su come ottenere i numeri di identificazione di tabelle e colonne, vedere OBJECT_ID (Transact-SQL).

Esempi

Nell'esempio viene restituito il nome della prima colonna di una tabella Employee di esempio.

-- Uses AdventureWorks  
  
SELECT COL_NAME(OBJECT_ID('dbo.FactResellerSales'), 1) AS FirstColumnName,  
COL_NAME(OBJECT_ID('dbo.FactResellerSales'), 2) AS SecondColumnName;

Questo è il set di risultati.

ColumnName          
------------   
BusinessEntityID

Vedi anche

Espressioni (Transact-SQL)
Funzioni dei metadati (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)
COL_LENGTH (Transact-SQL)

Condividi tramite