COL_NAME (Transact-SQL)COL_NAME (Transact-SQL)

Область применения: ДаSQL Server ДаБаза данных SQL Azure ДаAzure Synapse Analytics (Хранилище данных SQL) ДаParallel Data Warehouse APPLIES TO: YesSQL Server YesAzure SQL Database YesAzure Synapse Analytics (SQL DW) YesParallel Data Warehouse

Эта функция возвращает имя столбца таблицы на основе значений идентификационного номера таблицы и столбца для этого столбца таблицы.This function returns the name of a table column, based on the table identification number and column identification number values of that table column.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

COL_NAME ( table_id , column_id )  

АргументыArguments

table_idtable_id
Идентификационный номер таблицы, содержащей этот столбец.The identification number of the table containing that column. Аргумент table_id имеет тип данных int.The table_id argument has an int data type.

column_idcolumn_id
Идентификационный номер столбца.The identification number of the column. Аргумент column_id имеет тип данных int.The column_id argument has an int data type.

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

sysnamesysname

ИсключенияExceptions

Возвращает значение NULL в случае ошибки или если участник не имеет правильных разрешений для просмотра объекта.Returns NULL on error, or if a caller does not have the correct permission to view the object.

В SQL ServerSQL Server пользователь может просматривать только метаданные защищаемых объектов, которыми он владеет или на которые ему были предоставлены разрешения.In SQL ServerSQL Server, a user can only view the metadata of securables that the user owns, or on which the user has been granted permission. Это означает, что встроенные функции, создающие метаданные, такие как COL_NAME, могут вернуть значение NULL в случае, если у пользователя нет правильных разрешений на объект.This means that metadata-emitting, built-in functions such as COL_NAME might return NULL, if the user does not have correct permissions on the object. Дополнительные сведения см. в разделе Metadata Visibility Configuration.See Metadata Visibility Configuration for more information.

RemarksRemarks

Аргументы table_id и column_id совместно образуют строку имени столбца.The table_id and column_id parameters together produce a column name string.

Дополнительные сведения о получении идентификационных номеров таблиц и столбцов см. в статье OBJECT_ID (Transact-SQL).See OBJECT_ID (Transact-SQL) for more information about obtaining table and column identification numbers.

ПримерыExamples

В этом примере возвращается имя первого столбца в образце таблицы Employee.This example returns the name of the first column in a sample Employee table.

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

Результирующий набор:Here is the result set.

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

См. также разделSee also

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