Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
S’applique à :
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Base de données SQL dans Microsoft Fabric
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 )
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 une erreur ou si un appelant n’a pas l’autorisation correcte d’afficher l’objet.
Un utilisateur peut uniquement afficher les métadonnées des éléments sécurisables que l’utilisateur possède ou sur lequel l’utilisateur est autorisé. Cela signifie que les fonctions intégrées qui émettent des métadonnées, telles que COL_NAME peuvent retourner NULL, si l’utilisateur n’a pas les autorisations appropriées sur l’objet. Pour plus d’informations, consultez la 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.
Exemples
Les exemples de code de cet article utilisent les bases de données d'exemple AdventureWorks2025 ou AdventureWorksDW2025, que vous pouvez télécharger à partir de la page d'accueil Microsoft SQL Server Samples and Community Projects.
A. Retourner les noms des deux premières colonnes d’une table
Cet exemple retourne le nom des deux premières colonnes de la Person.Person table.
USE AdventureWorks2022;
GO
SELECT COL_NAME(OBJECT_ID('Person.Person'), 1) AS FirstColumnName,
COL_NAME(OBJECT_ID('Person.Person'), 2) AS SecondColumnName;
Voici le jeu de résultats.
FirstColumnName SecondColumnName
----------------- -----------------
BusinessEntityID PersonType