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


COL_NAME (Transact-SQL)

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

Значок ссылки на раздел Синтаксические обозначения в 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 (Transact-SQL).

Примеры

Следующий пример возвращает имя первого столбца таблицы Employee базы данных AdventureWorks2012.

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

Ниже приводится результирующий набор.

Column Name

------------------

BusinessEntityID

См. также

Справочник

Выражения (Transact-SQL)

Функции метаданных (Transact-SQL)

COLUMNPROPERTY (Transact-SQL)

COL_LENGTH (Transact-SQL)