Dela via


COL_NAME (Transact-SQL)

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Den här funktionen returnerar namnet på en tabellkolumn baserat på tabellidentifieringsnumret och kolumnidentifieringsnummervärdena för den tabellkolumnen.

Transact-SQL syntaxkonventioner

Syntax

COL_NAME ( table_id , column_id )

Argumentpunkter

table_id

Identifieringsnumret för tabellen som innehåller den kolumnen. Argumentet table_id har en int-datatyp .

column_id

Kolumnens ID-nummer. Argumentet column_id har en int-datatyp .

Returtyper

sysname

Exceptions

Returnerar NULL vid fel, eller om en anropare inte har rätt behörighet att visa objektet.

En användare kan bara visa metadata för skyddsbara objekt som användaren äger eller som användaren beviljas behörighet för. Det innebär att metadatautsändande, inbyggda funktioner som COL_NAME kan returnera NULL, om användaren inte har rätt behörighet för objektet. Mer information finns i Konfiguration av synlighet för metadata.

Anmärkningar

Parametrarna table_id och column_id skapar tillsammans en kolumnnamnssträng.

Mer information om hur du hämtar tabell- och kolumnidentifieringsnummer finns i OBJECT_ID.

Exempel

Kodexemplen i den här artikeln använder AdventureWorks2022- eller AdventureWorksDW2022-exempeldatabasen, som du kan ladda ned från startsidan Microsoft SQL Server Samples och Community Projects.

A. Returnera namn på de två första kolumnerna i en tabell

Det här exemplet returnerar namnet på de två första kolumnerna Person.Person i tabellen.

USE AdventureWorks2022;
GO

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

Här är resultatet.

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