COL_LENGTH (T-SQL)

Artikel
12/22/2023

Berlaku untuk:SQL Server Azure SQL Database Azure SQL Managed Instance

Fungsi ini mengembalikan panjang kolom yang ditentukan, dalam byte.

Sintaksis

COL_LENGTH ( 'table' , 'column' )

Catatan

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

Argumen

'tabel'
Nama tabel yang informasi panjang kolomnya ingin kita tentukan. tabel adalah ekspresi jenis nvarchar.

'kolom'
Nama kolom yang panjangnya ingin kita tentukan. kolom adalah ekspresi jenis nvarchar.

Jenis Pengembalian

smallint

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_LENGTH mungkin mengembalikan NULL, jika pengguna tidak memiliki izin yang benar pada objek. Lihat Konfigurasi Visibilitas Metadata untuk informasi selengkapnya.

Keterangan

Untuk kolom varchar yang dideklarasikan dengan penentu maks (varchar(maks)), COL_LENGTH mengembalikan nilai -1.

Contoh

Contoh ini memperlihatkan nilai pengembalian untuk kolom jenis varchar(40) dan kolom jenis nvarchar(40):

USE AdventureWorks2022;  
GO  
CREATE TABLE t1(c1 VARCHAR(40), c2 NVARCHAR(40) );  
GO  
SELECT COL_LENGTH('t1','c1')AS 'VarChar',  
      COL_LENGTH('t1','c2')AS 'NVarChar';  
GO  
DROP TABLE t1;

Berikut adalah hasil yang ditetapkan.

VarChar     NVarChar  
40          80