DATALENGTH (Transact-SQL)

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Azure Synapse Analytics AnalyticsPlatform 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)