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