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)
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по