Поделиться через


COL_NAME (Transact-SQL)

Относится к:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsСистема аналитической платформы (PDW)SQL база данных в Microsoft Fabric

Эта функция возвращает имя столбца таблицы на основе значений идентификационного номера таблицы и столбца для этого столбца таблицы.

Соглашения о синтаксисе Transact-SQL

Синтаксис

COL_NAME ( table_id , column_id )

Аргументы

table_id

Идентификационный номер таблицы, содержащей этот столбец. Аргумент table_id имеет тип данных int.

column_id

Идентификационный номер столбца. Аргумент column_id имеет тип данных int.

Типы возвращаемых данных

sysname

Исключения

Возвращает NULL ошибку или если вызывающий объект не имеет правильного разрешения на просмотр объекта.

Пользователь может просматривать только метаданные защищаемых объектов, принадлежащих пользователю, или разрешения на доступ пользователя. Это означает, что встроенные функции метаданных, такие как COL_NAME могут возвращать NULL, если у пользователя нет правильных разрешений на объект. Дополнительные сведения см. в разделе "Конфигурация видимости метаданных".

Замечания

Аргументы table_id и column_id совместно образуют строку имени столбца.

Дополнительные сведения о получении идентификации таблиц и столбцов см. в OBJECT_ID.

Примеры

Примеры кода в этой статье используют базу данных образца AdventureWorks2025 или AdventureWorksDW2025, которую можно скачать с домашней страницы образцов и проектов сообщества Microsoft SQL Server и.

А. Возвращаемые имена первых двух столбцов в таблице

В этом примере возвращается имя первых двух столбцов в Person.Person таблице.

USE AdventureWorks2022;
GO

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

Вот результирующий набор.

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