COL_NAME (T-SQL)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsTitik akhir analitik SQL di Microsoft FabricGudang di Microsoft FabricDatabase SQL di Microsoft Fabric

Fungsi ini mengembalikan nama kolom tabel, berdasarkan jumlah identifikasi tabel dan nilai nomor identifikasi kolom kolom kolom tersebut.

Konvensi sintaks transact-SQL

Sintaks

COL_NAME ( table_id , column_id )

Argumen

table_id

Nomor identifikasi tabel yang berisi kolom tersebut. Argumen table_id memiliki tipe data int .

column_id

Nomor identifikasi kolom. Argumen column_id memiliki tipe data int .

Jenis yang dikembalikan

nama sysname

Pengecualian

NULL Mengembalikan kesalahan, atau jika pemanggil tidak memiliki izin yang benar untuk melihat objek.

Pengguna hanya dapat melihat metadata yang diamankan yang dimiliki pengguna, atau di mana pengguna diberikan izin. Ini berarti bahwa fungsi bawaan yang memancarkan metadata seperti COL_NAME mungkin mengembalikan NULL, jika pengguna tidak memiliki izin yang benar pada objek. Untuk informasi selengkapnya, lihat Konfigurasi visibilitas metadata.

Keterangan

Parameter table_id dan column_id bersama-sama menghasilkan string nama kolom.

Untuk informasi selengkapnya tentang mendapatkan nomor identifikasi tabel dan kolom, lihat OBJECT_ID.

Contoh

Contoh kode dalam artikel ini menggunakan AdventureWorks2025database , AdventureWorksDW2025, atau AdventureWorksLT2025 contoh, yang dapat Anda unduh dari repositori GitHub Azure Data SQL Samples Repository.

A. Mengembalikan nama dua kolom pertama dalam tabel

Contoh ini mengembalikan nama dua kolom pertama dalam Person.Person tabel.

USE AdventureWorks2022;
GO

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

Berikut set hasilnya.

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