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 です。
注 |
---|
戻り値は、互換性レベルによって変わることがあります。 互換性レベルの詳細については、「ALTER DATABASE 互換性レベル (Transact-SQL)」を参照してください。 |
使用例
次の例は、Product テーブルの Name 列の長さを返します。
USE AdventureWorks2012;
GO
SELECT length = DATALENGTH(Name), Name
FROM Production.Product
ORDER BY Name;
GO