COL_NAME (Transact-SQL)

Mis à jour : 17 juillet 2006

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

Conventions 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.

Exceptions

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

Dans SQL Server 2005, 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).

Type des valeurs renvoyées

sysname

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

Voir aussi

Référence

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

Autres ressources

Modification des propriétés d'une colonne

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
17 juillet 2006	Nouveau contenu : Ajout de la section « Exceptions ».