Udostępnij za pomocą


COL_NAME (Transact-SQL)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Database w Microsoft Fabric

Ta funkcja zwraca nazwę kolumny tabeli na podstawie numeru identyfikacyjnego tabeli i wartości numeru identyfikacyjnego kolumny tej kolumny tabeli.

Transact-SQL konwencje składni

Składnia

COL_NAME ( table_id , column_id )

Argumenty (w programowaniu)

table_id

Numer identyfikacyjny tabeli zawierającej kolumnę. Argument table_id ma typ danych int .

column_id

Numer identyfikacyjny kolumny. Argument column_id ma typ danych int .

Typy zwracane

sysname

Wyjątki

Zwraca błąd NULL lub jeśli obiekt wywołujący nie ma odpowiednich uprawnień do wyświetlania obiektu.

Użytkownik może wyświetlać tylko metadane zabezpieczanych, które użytkownik jest właścicielem, lub na którym użytkownik ma uprawnienia. Oznacza to, że wbudowane funkcje emitujące metadane, takie jak COL_NAME mogą zwracać NULLwartość , jeśli użytkownik nie ma odpowiednich uprawnień do obiektu. Aby uzyskać więcej informacji, zobacz Konfiguracja widoczności metadanych.

Uwagi

Parametry table_id i column_id razem tworzą ciąg nazwy kolumny.

Aby uzyskać więcej informacji na temat uzyskiwania numerów identyfikacyjnych tabel i kolumn, zobacz OBJECT_ID.

Przykłady

Przykłady kodu w tym artykule korzystają z przykładowej bazy danych AdventureWorks2025 lub AdventureWorksDW2025, którą można pobrać ze strony głównej Przykładów programu Microsoft SQL Server i projektów społeczności.

Odp. Zwraca nazwy pierwszych dwóch kolumn w tabeli

Ten przykład zwraca nazwę pierwszych dwóch kolumn w Person.Person tabeli.

USE AdventureWorks2022;
GO

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

Oto zestaw wyników.

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