COL_NAME (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Diese Funktion gibt den Namen der Tabellenspalte basierend auf den Werten der Tabellen-ID und der Spalten-ID der entsprechenden Tabellenspalte zurück.

Transact-SQL-Syntaxkonventionen

Syntax

COL_NAME ( table_id , column_id )

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

table_id
Die ID der Tabelle, die diese Spalte enthält. Das Argument table_id weist den Datentyp int auf.

column_id
Die ID der Spalte. Das Argument column_id weist den Datentyp int auf.

Rückgabetypen

sysname

Ausnahmen

Gibt NULL zurück bei einem Fehler oder wenn ein Aufrufer nicht über die korrekte Berechtigung zum Anzeigen des Objekts verfügt.

In SQL Server kann ein Benutzer nur die Metadaten sicherungsfähiger Elemente anzeigen, bei denen der Benutzer entweder der Besitzer ist oder für die dem Benutzer eine Berechtigung erteilt wurde. Dies bedeutet, dass Metadaten ausgebende integrierte Funktionen, z.B. COL_NAME, möglicherweise NULL zurückgeben, wenn dem Benutzer für das Objekt nicht die korrekten Berechtigungen erteilt wurden. Weitere Informationen finden Sie unter Konfigurieren der Sichtbarkeit von Metadaten.

Bemerkungen

Der table_id- und der column_id-Parameter erzeugen zusammen eine Spaltennamenzeichenfolge.

Weitere Informationen zum Abrufen von Tabellen- und Spaltenidentifikationsnummern finden Sie unter OBJECT_ID (Transact-SQL).

Beispiele

Dieses Beispiel gibt den Namen der ersten Spalte in der Beispieltabelle Employee zurück.

-- Uses AdventureWorks  
  
SELECT COL_NAME(OBJECT_ID('dbo.FactResellerSales'), 1) AS FirstColumnName,  
COL_NAME(OBJECT_ID('dbo.FactResellerSales'), 2) AS SecondColumnName;

Hier ist das Resultset.

ColumnName          
------------   
BusinessEntityID

Weitere Informationen

Ausdrücke (Transact-SQL)
Metadatenfunktionen (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)
COL_LENGTH (Transact-SQL)