Compartilhar via

  • Artigo

COL_NAME (Transact-SQL)

Retorna o nome de uma coluna de um número de identificação de tabela correspondente especificado e o número de identificação de coluna.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

COL_NAME ( table_id , column_id )

Argumentos

  • table_id
    É o número de identificação da tabela que contém a coluna. table_id é do tipo int.

  • column_id
    É o número de identificação da tabela que contém a coluna. O parâmetro column_id é do tipo int.

Tipos de retorno

sysname

Exceções

Retorna NULL em caso de erro ou se o chamador não tiver permissão para exibir o objeto.

No SQL Server 2008, o usuário só pode exibir os metadados de itens protegíveis de sua propriedade ou para os quais ele tenha recebido permissão. Isso significa que funções internas que emitem metadados, como COL_NAME, poderão retornar o NULL se o usuário não tiver nenhuma permissão para o objeto. Para obter mais informações, consulte Configuração de visibilidade de metadados e Solucionando problemas de visibilidade de metadados.

Comentários

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

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

Exemplos

O exemplo a seguir retorna o nome da primeira coluna da tabela Employee do banco de dados AdventureWorks2008R2.

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

Aqui está o conjunto de resultados.

Column Name        
------------ 
BusinessEntityID

(1 row(s) affected