COL_NAME (Transact-SQL)

Относится к:SQL ServerБаза данных SQL AzureУправляемый экземпляр SQL AzureAzure Synapse AnalyticsSQL аналитическая конечная точка в Microsoft FabricХранилище в Microsoft FabricSQL база данных в 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или AdventureWorksLT2025 примерную базу данных, которую можно скачать из репозитория GitHub Azure Data Data SQL Samples Repository (Сэмпл SQL).

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

В этом примере возвращается имя первых двух столбцов в 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

Связанный контент

  • Последнее обновление: