COL_NAME (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada SQL do AzureBanco de Dados SQL do Azure Synapse Analyticsno 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 utilizam a AdventureWorks2025 base de dados de exemplos ORAdventureWorksDW2025, que pode descarregar do repositório GitHub do Azure Data SQL Samples Repository.

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