DATALENGTH (Transact-SQL)

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

トピック リンク アイコン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 AdventureWorks2008R2;
GO
SELECT length = DATALENGTH(Name), Name
FROM Production.Product
ORDER BY Name;
GO