Partilhar via

COL_NAME (Transact-SQL)

Aplica-se a:Banco de Dados SQL doAzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)Banco de Dados SQL no Microsoft Fabric

Esta função devolve o nome de uma coluna de tabela, com base nos valores do número de identificação da tabela e do número de identificação da coluna dessa tabela.

Transact-SQL convenções de sintaxe

Sintaxe

COL_NAME ( table_id , column_id )

Argumentos

table_id

O número de identificação do quadro que contém essa 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 devolução

sysname

Exceções

Retorna NULL em caso de 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 nos quais o usuário recebe permissão. Isso significa que as funções internas emissoras de metadados, como COL_NAME podem retornar NULL, se o usuário não tiver as permissões corretas no objeto. Para obter mais informações, consulte Configuração de visibilidade de metadados.

Observações

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 coluna, consulte OBJECT_ID.

Exemplos

Os exemplos de código neste artigo usam o banco de dados de exemplo AdventureWorks2025 ou AdventureWorksDW2025, que pode ser descarregado da página inicial de Exemplos e Projetos da Comunidade do Microsoft SQL Server.

Um. Retornar nomes das duas primeiras colunas de uma tabela

Este exemplo retorna o nome das duas primeiras colunas da 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;

Aqui está o conjunto de resultados.

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

Conteúdo relacionado

  • Last updated on