COL_LENGTH (T-SQL)

Artikel
10/16/2024

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

Fungsi ini mengembalikan panjang kolom yang ditentukan, dalam byte.

Sintaks

COL_LENGTH ( 'table' , 'column' )

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.

Tipe hasil

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 set hasilnya.

VarChar     NVarChar  
40          80

Lihat juga

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

Bagikan melalui