DATALENGTH (SQL Bertransaksi)

Berlaku untuk: SQL Server (semua versi yang didukung) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Fungsi ini mengembalikan jumlah byte yang digunakan untuk mewakili ekspresi apa pun.

Catatan

Untuk mengembalikan jumlah karakter dalam ekspresi string, gunakan fungsi LEN .

Konvensi Sintaksis T-SQL

Sintaks

DATALENGTH ( expression )   

Catatan

Untuk melihat sintaks transact-SQL untuk SQL Server 2014 dan yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

ekspresi
Ekspresi jenis data apa pun.

Tipe yang dikembalikan

bigint jika ekspresi memiliki jenis data nvarchar(max), varbinary(max), atau varchar(max ) ; jika tidak , int.

Keterangan

DATALENGTH menjadi sangat membantu ketika digunakan dengan jenis data yang dapat menyimpan data dengan panjang variabel, seperti:

• gambar
• ntext
• nvarchar
• teks
• varbinary
• varchar

Untuk nilai NULL, DATALENGTH mengembalikan NULL.

Catatan

Tingkat kompatibilitas dapat memengaruhi nilai yang dikembalikan. Lihat MENGUBAH Tingkat Kompatibilitas DATABASE (SQL Transact) untuk informasi selengkapnya tentang tingkat kompatibilitas.

Catatan

Gunakan LEN untuk mengembalikan jumlah karakter yang dikodekan ke dalam ekspresi string tertentu, dan DATALENGTH untuk mengembalikan ukuran dalam byte untuk ekspresi string tertentu. Output ini mungkin berbeda tergantung pada jenis data dan jenis pengodean yang digunakan dalam kolom. Untuk informasi selengkapnya tentang perbedaan penyimpanan antara jenis pengodean yang berbeda, lihat Kolate dan Dukungan Unicode.

Contoh

Contoh ini menemukan panjang Name kolom dalam Product tabel:

USE AdventureWorks2016  
GO
SELECT length = DATALENGTH(EnglishProductName), EnglishProductName  
FROM dbo.DimProduct  
ORDER BY EnglishProductName;  
GO  

Lihat juga

LEN (SQL Bertransaksi)
CAST dan CONVERT (transact-SQL)
Tipe Data (Transact-SQL)
Fungsi Sistem (SQL T-SQL)