Compartilhar via

COL_NAME (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Banco de dados SQL no Microsoft Fabric

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

Retorna NULL com erro ou se um chamador não tiver a permissão correta para exibir o objeto.

Um usuário só pode exibir os metadados de protegíveis que o usuário possui ou sobre os quais o usuário recebe permissão. Isso significa que as funções internas que emitem metadados, como COL_NAME podem retornar NULL, se o usuário não tiver permissões corretas no objeto. Para obter mais informações, consulte a configuração de visibilidade de metadados.

Comentários

Os parâmetros de 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 coluna, consulte OBJECT_ID.

Exemplos

Os exemplos de código neste artigo usam o banco de dados de exemplo AdventureWorks2025 ou AdventureWorksDW2025, que você pode baixar na página inicial Microsoft SQL Server Samples and Community Projects.

Um. Retornar nomes das duas primeiras colunas em uma tabela

Este exemplo retorna o nome das duas primeiras colunas na Person.Person tabela.

USE AdventureWorks2022;
GO

SELECT COL_NAME(OBJECT_ID('Person.Person'), 1) AS FirstColumnName,
       COL_NAME(OBJECT_ID('Person.Person'), 2) AS SecondColumnName;

Veja a seguir o conjunto de resultados.

FirstColumnName    SecondColumnName
-----------------  -----------------
BusinessEntityID    PersonType

Conteúdo relacionado

  • Last updated on