Condividi tramite


COL_NAME (Transact-SQL)

Si applica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema di Piattaforma Analitica (PDW)Database SQL in Microsoft Fabric

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

Convenzioni relative alla sintassi Transact-SQL

Sintassi

COL_NAME ( table_id , column_id )

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 dispone dell'autorizzazione corretta per visualizzare l'oggetto.

Un utente può visualizzare solo i metadati delle entità a protezione diretta di cui l'utente è proprietario o su cui viene concessa l'autorizzazione. Ciò significa che le funzioni predefinite di creazione di metadati, ad COL_NAME esempio , potrebbero restituire NULL, se l'utente non dispone delle 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 numeri di identificazione di tabella e colonna, vedere OBJECT_ID.

Esempi

Gli esempi di codice in questo articolo usano il database di esempio AdventureWorks2025 o AdventureWorksDW2025, che è possibile scaricare dalla home page Microsoft SQL Server Samples and Community Projects.

A. Restituire i nomi delle prime due colonne di una tabella

In questo esempio viene restituito il nome delle prime due colonne della Person.Person tabella.

USE AdventureWorks2022;
GO

SELECT COL_NAME(OBJECT_ID('Person.Person'), 1) AS FirstColumnName,
       COL_NAME(OBJECT_ID('Person.Person'), 2) AS SecondColumnName;

Il set di risultati è il seguente.

FirstColumnName    SecondColumnName
-----------------  -----------------
BusinessEntityID    PersonType