• Article

DATALENGTH (Transact-SQL)

Retourne le nombre d'octets utilisés pour représenter une expression.

Icône Lien de rubriqueConventions de syntaxe Transact-SQL

Syntaxe

DATALENGTH ( expression )

Arguments

  • expression
    Expression de n'importe quel type de données.

Type des valeurs retournées

Type bigint si expression est du type de données varchar(max), nvarchar(max) ou varbinary(max) ; sinon int.

Notes

DATALENGTH est particulièrement utile pour les types de données varchar, varbinary, text, image, nvarchar et ntext, car ces types de données permettent le stockage des données de longueur variable.

La fonction DATALENGTH exécutée sur la valeur NULL donne NULL comme résultat.

[!REMARQUE]

Les niveaux de compatibilité peuvent affecter les valeurs de retour. Pour plus d'informations sur les niveaux de compatibilité, consultez Niveau de compatibilité ALTER DATABASE (Transact-SQL).

Exemples

L'exemple suivant recherche la longueur de la colonne Name dans la table Product.

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