DATALENGTH (Transact-SQL)

Возвращает число байтов, использованных для представления выражения.

Соглашения о синтаксическом обозначении в Transact-SQL

Синтаксис

DATALENGTH ( expression ) 

Аргументы

• expression
  Выражение любого типа данных.

Типы возвращаемых данных

bigint если аргумент expression имеет тип varchar(max), nvarchar(max) или varbinary(max); в противном случае int.

Замечания

Функция DATALENGTH особенно полезна при работе с данными типов varchar, varbinary, text, image, nvarchar и ntext, потому что они могут хранить данные переменной длины.

Функция DATALENGTH возвращает NULL, если аргументом является NULL.

Примечание
Уровни совместимости могут повлиять на возвращаемые значения. Дополнительные сведения об уровнях совместимости см. в разделе Уровень совместимости инструкции ALTER DATABASE (Transact-SQL).

Примеры

В следующем примере находится длина столбца Name в таблице Product.

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

См. также

Справочник

LEN (Transact-SQL)

Функции CAST и CONVERT (Transact-SQL)

Типы данных (Transact-SQL)

Системные функции (Transact-SQL)