COL_NAME (Transact-SQL)

Renvoie le nom d'une colonne à partir des numéros d'identification de table et de colonne correspondants.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

COL_NAME ( table_id , column_id )

Arguments

  • table_id
    Numéro d'identification de la table contenant la colonne. table_id est de type int.

  • column_id
    Numéro d'identification de la colonne. column_id est de type int.

Type des valeurs renvoyées

sysname

Exceptions

Retourne la valeur NULL en cas d'erreur ou si un appelant n'est pas autorisé à afficher l'objet.

Dans SQL Server 2008, un utilisateur peut voir uniquement 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, telles que COL_NAME, peuvent retourner la valeur NULL si l'utilisateur ne dispose d'aucune autorisation sur l'objet. Pour plus d'informations, consultez Configuration de la visibilité des métadonnées et Dépannage de la visibilité des métadonnées.

Notes

La combinaison des paramètres table_id et column_id génère une chaîne de nom de colonne.

Pour plus d'informations sur les numéros d'identification de table et de colonne, consultez OBJECT_ID (Transact-SQL).

Exemples

L'exemple suivant renvoie le nom de la première colonne de la table Employee de la base de données AdventureWorks.

USE AdventureWorks;
GO
SET NOCOUNT OFF;
GO
SELECT COL_NAME(OBJECT_ID('HumanResources.Employee'), 1) AS 'Column Name';
GO

Voici l'ensemble des résultats.

Column Name        
------------ 
EmployeeID

(1 row(s) affected