DATALENGTH (Transact-SQL)
Status do tópico: algumas informações neste tópico são de pré-lançamento e estão sujeitas a mudanças em versões futuras. As informações de pré-lançamento descrevem novos recursos ou alterações em recursos existentes no Microsoft SQL Server 2014.
Retorna o número de bytes usado para representar qualquer expressão.
Aplica-se a: SQL Server (SQL Server 2008 até a versão atual), Banco de dados SQL do Windows Azure (versão inicial até a versão atual). |
.gif "Ícone de vínculo de tópico")
Convenções da 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.
Dica
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 AdventureWorks2012;
GO
SELECT length = DATALENGTH(Name), Name
FROM Production.Product
ORDER BY Name;
GO