• Artigo

DATALENGTH (Transact-SQL)

Retorna o número de bytes usado para representar qualquer expressão.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

DATALENGTH ( expression )

Argumentos

  • expression
    É uma expressão de qualquer tipo de dados.

Tipos de retorno

bigint se expression for dos tipos de dados varchar(max), nvarchar(max) ou varbinary(max); caso contrário, int.

Comentários

DATALENGTH é especialmente útil com os tipos de dados varchar, varbinary, text, image, nvarchar e ntext porque eles podem armazenar dados de comprimento variável.

O DATALENGTH de NULL é NULL.

ObservaçãoObservação

Os níveis de compatibilidade podem afetar os valores de retorno. Para obter mais informações sobre níveis de compatibilidade, consulte Nível de compatibilidade de ALTER DATABASE (Transact-SQL).

Exemplos

O exemplo a seguir localiza o comprimento da coluna Name na tabela Product.

USE AdventureWorks;
GO
SELECT length = DATALENGTH(Name), Name
FROM Production.Product
ORDER BY Name;
GO