COL_NAME (Transact-SQL)

Platí pro:SQL ServerAzure SQL DatabaseSpravovaná instance Azure SQLAzure Synapse AnalyticsKoncový bod analýzy SQL v Microsoft FabricSklad v Microsoft FabricDatabáze SQL v Microsoft Fabric

Tato funkce vrátí název sloupce tabulky na základě identifikačního čísla tabulky a identifikačních čísel sloupců daného sloupce tabulky.

Transact-SQL konvence syntaxe

Syntaxe

COL_NAME ( table_id , column_id )

Argumenty

table_id

Identifikační číslo tabulky obsahující tento sloupec. Argument table_id má datový typ int .

column_id

Identifikační číslo sloupce. Argument column_id má datový typ int .

Návratové typy

sysname

Výjimky

Vrátí NULL chybu nebo pokud volající nemá správné oprávnění k zobrazení objektu.

Uživatel může zobrazit pouze metadata zabezpečitelných, která uživatel vlastní nebo na kterých má udělená oprávnění. To znamená, že pokud uživatel nemá správná oprávnění k objektu, znamená to, že generují metadata předdefinované funkce, například COL_NAME můžou vrátit NULL. Další informace naleznete v tématu Konfigurace viditelnosti metadat.

Poznámky

Parametry table_id a column_id společně vytvoří řetězec názvu sloupce.

Další informace o získání identifikačních čísel tabulek a sloupců najdete v tématu OBJECT_ID.

Příklady

Ukázky kódu v tomto článku používají databázi , AdventureWorksDW2025, neboli AdventureWorksLT2025 ukázkovou databáziAdventureWorks2025, kterou si můžete stáhnout z Azure Data SQL Samples Repository GitHub repository.

A. Vrácení názvů prvních dvou sloupců v tabulce

Tento příklad vrátí název prvních dvou sloupců v Person.Person tabulce.

USE AdventureWorks2022;
GO

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

Tady je soubor výsledků.

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