COL_NAME (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)

此函数根据表列的表标识号和列标识号值返回该表列的名称。

Transact-SQL 语法约定

语法

COL_NAME ( table_id , column_id )

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

自变量

table_id
包含该列的表的标识号。 table_id 自变量具有一个 int 数据类型。

column_id
列的标识号。 column_id 自变量具有一个 int 数据类型。

返回类型

sysname

例外

出现错误时或调用方没有查看对象的正确权限时将返回 NULL。

在 SQL Server 中，用户只能查看其所拥有的安全对象的元数据，或者已对其授予权限的安全对象的元数据。 这意味着，如果用户对该对象没有正确的权限，那些发出元数据的内置函数（如 COL_NAME）则可能会返回 NULL。 有关详细信息，请参阅元数据可见性配置。

备注

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)