DATALENGTH (Transact-SQL)

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

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

Примечание.

Чтобы получить количество символов в строковом выражении, используйте функцию LEN.

Соглашения о синтаксисе Transact-SQL

Синтаксис

DATALENGTH ( expression )   

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

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

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

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

Замечания

Функция DATALENGTH особенно полезна при использовании с типами данных переменной длины, как показано ниже.

• Изображение
• ntext
• nvarchar
• text
• varbinary
• varchar

Для значения NULL функция DATALENGTH возвращает NULL.

Примечание.

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

Примечание.

Функция LEN возвращает количество символов, закодированных в определенное строковое выражение, а функция DATALENGTH — размер данных в байтах для определенного строкового выражения. Эти выходные данные могут быть разными в зависимости от типа данных и типа кодировки, используемой в столбце. Дополнительные сведения об отличиях типов кодировок, используемых для хранения данных, см. в статье Collation and Unicode Support (Поддержка параметров сортировки и Юникода).

Примеры

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

USE AdventureWorks2022  
GO
SELECT length = DATALENGTH(EnglishProductName), EnglishProductName  
FROM dbo.DimProduct  
ORDER BY EnglishProductName;  
GO  

См. также

LEN (Transact-SQL)
CAST и CONVERT (Transact-SQL)
Типы данных (Transact-SQL)
Системные функции (Transact-SQL)