DATALENGTH (Transact-SQL)

式を表すために必要なバイト数を返します。

構文

DATALENGTH ( expression )

expression

任意のデータ型の式を指定します。

expression のデータ型が varchar(max)、nvarchar(max)、または varbinary(max) である場合は bigint 型になり、それ以外の場合は int 型になります。

DATALENGTH は、可変長データを保存できる varchar、varbinary、text、image、nvarchar、および ntext などのデータ型にとって特に効果的です。

NULL の DATALENGTH は NULL です。

メモ :
互換性レベルは、戻り値に影響します。互換性レベルの詳細については、「sp_dbcmptlevel (Transact-SQL)」を参照してください。

次の例は、Product テーブルの Name 列の長さを返します。

USE AdventureWorks;
GO
SELECT length = DATALENGTH(Name), Name
FROM Production.Product
ORDER BY Name;
GO