Поделиться через

ДЛИНА ДАННЫХ (Transact-SQL)

Относится к:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsСистема аналитической платформы (PDW)SQL база данных в Microsoft Fabric

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

Примечание.

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

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

Синтаксис

DATALENGTH ( expression )

Аргументы

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

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

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

См. также

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

  • Last updated on