DATALENGTH (Transact-SQL)

  • Artikel

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform 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 sintaks transact-SQL

Sintaksis

DATALENGTH ( expression )

Catatan

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

Argumen

expression
Ekspresi jenis data apa pun.

Jenis 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
  • text
  • varbinary
  • varchar

Untuk nilai NULL, DATALENGTH mengembalikan NULL.

Catatan

Tingkat kompatibilitas dapat memengaruhi nilai yang dikembalikan. Lihat MENGUBAH Tingkat Kompatibilitas DATABASE (Transact-SQL) 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 Collation dan Dukungan Unicode.

Contoh

Contoh ini menemukan panjang Name kolom dalam Product tabel:

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

Baca juga

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