COL_NAME (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Cette fonction retourne le nom d’une colonne de table à partir des valeurs du numéro d’identification de table et du numéro d’identification de colonne de cette colonne de table.

Conventions de la syntaxe Transact-SQL

Syntaxe

COL_NAME ( table_id , column_id )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

table_id
Numéro d’identification de la table contenant cette colonne. L’argument table_id a un type de données int.

column_id
Numéro d’identification de la colonne. L’argument column_id a un type de données int.

Types de retour

sysname

Exceptions

Retourne NULL en cas d’erreur ou si un appelant ne dispose pas de l’autorisation appropriée pour voir l’objet.

Dans SQL Server, un utilisateur peut seulement voir les métadonnées des éléments sécurisables qui lui appartiennent ou pour lesquels il dispose d’un droit d’accès. Cela signifie que les fonctions intégrées générant des métadonnées, comme COL_NAME, peuvent retourner NULL si l’utilisateur ne dispose pas des autorisations appropriées sur l’objet. Pour plus d’informations, consultez Configuration de la visibilité des métadonnées.

Notes

Les paramètres table_id et column_id génèrent ensemble une chaîne de nom de colonne.

Pour plus d’informations sur l’obtention des numéros d’identification de table et de colonne, consultez OBJECT_ID (Transact-SQL).

Exemples

L’exemple suivant retourne le nom de la première colonne d’un exemple de table Employee.

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

Voici le jeu de résultats obtenu.

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

Voir aussi

Expressions (Transact-SQL)
Fonctions de métadonnées (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)
COL_LENGTH (Transact-SQL)