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.
Aplica-se a: SQL Server (SQL Server 2008 até a versão atual), Banco de dados SQL do Windows Azure (versão inicial até a versão atual). |
.gif "Ícone de vínculo de tópico")
Convenções da 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. O table_id é do tipo int.column_id
É o número de identificação da coluna. O parâmetro column_id é do tipo int.
Tipos de retorno
sysname
Exceções
Retorna NULL em caso de erro ou se um chamador não tiver permissão para exibir o objeto.
Um usuário só pode exibir metadados de protegíveis de sua propriedade ou para os quais tenha recebido permissão. Isso significa que funções internas que emitem metadados, como COL_NAME, poderão retornar NULL se o usuário não tiver permissão para o objeto. Para obter mais informações, consulte Configuração 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 AdventureWorks2012.
USE AdventureWorks2012;
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