COL_NAME (Transact-SQL)

COL_NAME (Transact-SQL)

 

THIS TOPIC APPLIES TO: yesSQL Server (starting with 2008) yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

Returns the name of a column from a specified corresponding table identification number and column identification number.

Topic link icon Transact-SQL Syntax Conventions


COL_NAME ( table_id , column_id )
-- Azure SQL Data Warehouse and Parallel Data Warehouse
COL_NAME (table_id,column_id )

table_id

Is the identification number of the table that contains the column. table_id is of type int.

column_id

Is the identification number of the column. column_id parameter is of type int.

sysname

Returns NULL on error or if a caller does not have permission to view the object.

A user can only view the metadata of securables that the user owns or on which the user has been granted permission. This means that metadata-emitting, built-in functions such as COL_NAME may return NULL if the user does not have any permission on the object. For more information, see Metadata Visibility Configuration.

Exception Condition

The table_id and column_id parameters together produce a column name string.

For more information about obtaining table and column identification numbers, see OBJECT_ID (Transact-SQL).

The following example returns the name of the first column in the Employee table of the AdventureWorks2012 database.

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

Here is the result set.

Column Name

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

BusinessEntityID

The following 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

Community Additions

ADD
Show:
© 2016 Microsoft