Bagikan melalui

DATALENGTH (Transact-SQL)

  • Artikel

Berlaku untuk: SQL Server 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 sintaks transact-SQL

Sintaks

DATALENGTH ( expression )

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

Lihat juga

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