DATALENGTH (Transact-SQL)

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

Convençõ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çã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

Consulte também

Referência

LEN (Transact-SQL)

CAST e CONVERT (Transact-SQL)

Tipos de dados (Transact-SQL)

Funções de sistema (Transact-SQL)