Delen via


COL_NAME (Transact-SQL)

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Deze functie retourneert de naam van een tabelkolom, op basis van het tabelidentificatienummer en de waarden voor het kolomidentificatienummer van die tabelkolom.

Transact-SQL syntaxis-conventies

Syntaxis

COL_NAME ( table_id , column_id )

Argumenten

table_id

Het identificatienummer van de tabel met die kolom. Het argument table_id heeft een gegevenstype int .

column_id

Het identificatienummer van de kolom. Het argument column_id heeft een gegevenstype int .

Retourtypen

sysname

Uitzonderingen

Retourneert NULL een fout of als een aanroeper niet over de juiste machtiging beschikt om het object weer te geven.

Een gebruiker kan alleen de metagegevens van beveiligbare items bekijken waarvan de gebruiker eigenaar is of waarvoor de gebruiker toestemming krijgt. Dit betekent dat metagegevens die ingebouwde functies verzenden, zoals COL_NAME mogelijk retourneren NULL, als de gebruiker niet over de juiste machtigingen voor het object beschikt. Zie de zichtbaarheidsconfiguratie voor metagegevens voor meer informatie.

Opmerkingen

De parameters table_id en column_id samen produceren een kolomnaamtekenreeks.

Zie OBJECT_ID voor meer informatie over het verkrijgen van tabel- en kolomidentificatienummers.

Voorbeelden

De codevoorbeelden in dit artikel gebruiken de AdventureWorks2022 of AdventureWorksDW2022 voorbeelddatabase die u kunt downloaden van de startpagina van Microsoft SQL Server Samples en Community Projects .

Eén. Namen van de eerste twee kolommen in een tabel retourneren

In dit voorbeeld wordt de naam van de eerste twee kolommen in de Person.Person tabel geretourneerd.

USE AdventureWorks2022;
GO

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

Hier is het resultatenoverzicht.

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