COL_NAME (Transact-SQL)

A következőkre vonatkozik:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSQL-adatbázis a Microsoft Fabricben

Ez a függvény egy táblaoszlop nevét adja vissza az adott táblaoszlop táblaazonosítási száma és oszlopazonosítási száma alapján.

Transact-SQL szintaxis konvenciók

Szemantika

COL_NAME ( table_id , column_id )

Érvek

table_id

Az oszlopot tartalmazó tábla azonosítószáma. A table_id argumentum int adattípussal rendelkezik.

column_id

Az oszlop azonosítószáma. A column_id argumentum int adattípussal rendelkezik.

Visszatérési típusok

sysname

Kivételek

Hibát ad NULL vissza, vagy ha egy hívó nem rendelkezik a megfelelő engedéllyel az objektum megtekintéséhez.

A felhasználó csak a felhasználó által birtokolt biztonságos adatok metaadatait tekintheti meg, vagy amelyekhez a felhasználó engedélyt kapott. Ez azt jelenti, hogy ha a felhasználó nem rendelkezik megfelelő engedélyekkel az objektumhoz, akkor a metaadatok kibocsátása, a beépített függvények, például COL_NAME a visszatérésük NULLlehetséges. További információ: Metaadatok láthatósági konfigurációja.

Megjegyzések

A table_id és column_id paraméterek együttesen létrehoznak egy oszlopnév-sztringet.

A tábla- és oszlopazonosítási számok beszerzéséről további információt a OBJECT_ID.

Példák

A cikkben szereplő kódminták az AdventureWorks2025 or AdventureWorksDW2025 minta adatbázist használják, amelyet letölthetsz az Azure Data SQL Samples Repository GitHub repository-jából.

Egy. A tábla első két oszlopának nevét adja vissza

Ez a példa a tábla első két oszlopának Person.Person nevét adja vissza.

USE AdventureWorks2022;
GO

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

Itt van az eredmények összessége.

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