Bagikan melalui


COL_NAME (T-SQL)

Berlaku untuk:SQL ServerDatabase Azure SQLInstans Terkelola Azure SQLAzure Synapse AnalyticsSistem Platform Analitik (PDW)Database 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

Sampel kode dalam artikel ini menggunakan database sampel AdventureWorks2025 atau AdventureWorksDW2025, yang dapat Anda unduh dari halaman beranda Sampel dan Proyek Komunitas Microsoft SQL Server.

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