Share via

COL_NAME (T-SQL)

  • Artikel

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

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

Konvensi sintaks transact-SQL

Sintaksis

COL_NAME ( table_id , column_id )

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

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

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

Di SQL Server, pengguna hanya dapat melihat metadata yang diamankan yang dimiliki pengguna, atau di mana pengguna telah 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. Lihat Konfigurasi Visibilitas Metadata untuk informasi selengkapnya.

Keterangan

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

Lihat OBJECT_ID (Transact-SQL) untuk informasi selengkapnya tentang mendapatkan nomor identifikasi tabel dan kolom.

Contoh

Contoh ini mengembalikan nama kolom pertama dalam tabel sampel Employee .

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

Berikut adalah hasil yang ditetapkan.

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

Baca juga

Ekspresi (Transact-SQL)
Fungsi Metadata (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)
COL_LENGTH (T-SQL)