COL_NAME (Transact-SQL)

Статья
12/22/2023

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)

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

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

Синтаксис

COL_NAME ( table_id , column_id )

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

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

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

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

sysname

Исключения

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

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

Замечания

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

Дополнительные сведения о получении идентификационных номеров таблиц и столбцов см. в статье OBJECT_ID (Transact-SQL).

Примеры

В этом примере возвращается имя первого столбца в образце таблицы Employee.

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

Результирующий набор:

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

См. также

Выражения (Transact-SQL)
Функции метаданных (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)
COL_LENGTH (Transact-SQL)