DATALENGTH (Transact-SQL)

  • Статья
  • Чтение занимает 2 мин

Область применения:yesSQL Server (все поддерживаемые версии) YesБаза данных SQL Azure YesУправляемый экземпляр SQL Azure yesAzure Synapse Analytics yesAnalytics Platform System (PDW)

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

Примечание

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

Topic link iconСинтаксические обозначения в Transact-SQL

Синтаксис

DATALENGTH ( expression )

Примечание

Ссылки на описание синтаксиса Transact-SQL для SQL Server 2014 и более ранних версий, см. в статье Документация по предыдущим версиям.

Аргументы

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

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

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

Примечания

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

  • image
  • ntext
  • nvarchar
  • text
  • varbinary
  • varchar

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

Примечание

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

Примечание

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

Примеры

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

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

См. также раздел

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