COL_NAME (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)

Essa função retorna o nome de uma coluna de tabela com base nos valores de número de identificação de tabela e número de identificação de coluna daquela coluna da tabela.

Convenções de sintaxe de Transact-SQL

Sintaxe

COL_NAME ( table_id , column_id )

Argumentos

table_id
O número de identificação da tabela que contém aquela coluna. O argumento table_id tem um tipo de dados int.

column_id
O número de identificação da coluna. O argumento column_id tem um tipo de dados int.

Tipos de retorno

sysname

Exceções

Retornará NULL em caso de erro ou se um chamador não tiver a permissão correta para exibir o objeto.

No SQL Server, um usuário pode exibir apenas os metadados de itens protegíveis de sua propriedade ou para os quais ele tenha recebido permissão. Isso significa que as funções internas que emitem metadados, como COL_NAME, poderão retornar NULL se o usuário não tiver as permissões corretas para o objeto. Veja Configuração de Visibilidade de Metadados para obter mais informações.

Comentários

Os parâmetros de table_id e column_id juntos produzem uma cadeia de caracteres de nome de coluna.

Veja OBJECT_ID (Transact-SQL) para obter mais informações sobre como obter números de identificação de tabela e de coluna.

Exemplos

Este exemplo retorna o nome da primeira coluna em uma tabela Employee de amostra.

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

Veja a seguir o conjunto de resultados.

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

Confira também

Expressões (Transact-SQL)
funções de metadados (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)
COL_LENGTH (Transact-SQL)