DATALENGTH (Transact-SQL)

Aplica-se a:Banco de Dados SQL doAzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)Banco de Dados SQL no Microsoft Fabric

Esta função devolve o número de bytes usados para representar qualquer expressão.

Observação

Para devolver o número de caracteres numa expressão de string, use a função LEN .

Transact-SQL convenções de sintaxe

Sintaxe

DATALENGTH ( expression )   

Arguments

expressão
Uma expressão de qualquer tipo de dado.

Tipos de devolução

bigint se a expressão tiver um tipo de dado nvarchar(max),varbinary(max) ou varchar(max ); caso contrário, int.

Observações

DATALENGTH Torna-se realmente útil quando usado com tipos de dados que podem armazenar dados de comprimento variável, tais como:

• image
• ntext
• nvarchar
• texto
• Varbinary
• Varchar

Para um valor NULL, DATALENGTH devolve NULL.

Observação

Os níveis de compatibilidade podem afetar os valores de retorno. Consulte o Nível de Compatibilidade do ALTER DATABASE (Transact-SQL) para mais informações sobre os níveis de compatibilidade.

Observação

Use o LEN para devolver o número de caracteres codificados numa dada expressão de string, e o DATALENGTH para devolver o tamanho em bytes para uma dada expressão de string. Estas saídas podem diferir consoante o tipo de dados e o tipo de codificação utilizada na coluna. Para mais informações sobre diferenças de armazenamento entre diferentes tipos de codificação, veja Collation e Suporte Unicode.

Examples

Este exemplo encontra o comprimento da Name coluna na Product tabela:

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

Consulte também

LEN (Transact-SQL)
CAST e CONVERT (Transact-SQL)
Tipos de dados (Transact-SQL)
Funções do sistema (Transact-SQL)