COL_LENGTH (Transact-SQL)

Article
08/20/2013

Renvoie la longueur définie d'une colonne, exprimée en octets.

Icône Lien de rubrique Conventions de syntaxe Transact-SQL

Syntaxe

COL_LENGTH ( 'table' , 'column' )

Arguments

'table'
Nom de la table dont les informations de longueur de colonne doivent être déterminées. table est une expression de type nvarchar.
'column'
Nom de la colonne dont la longueur doit être déterminée. column est une expression de type nvarchar.

Type de retour

smallint

Exceptions

Retourne la valeur NULL en cas d'erreur ou si un appelant n'est pas autorisé à afficher l'objet.

Dans SQL Server, un utilisateur peut voir uniquement les métadonnées des éléments sécurisables qui lui appartiennent ou pour lesquels il dispose d'un droit d'accès. Cela signifie que les fonctions intégrées générant des métadonnées, telles que COL_LENGTH, peuvent retourner la valeur NULL si l'utilisateur ne dispose d'aucune autorisation sur l'objet. Pour plus d'informations, consultez Configuration de la visibilité des métadonnées.

Notes

Pour les colonnes de type varchar déclarées avec le spécificateur max (varchar(max)), COL_LENGTH retourne la valeur –1.

Exemples

L'exemple suivant montre les valeurs renvoyées pour une colonne de type varchar(40) et pour une colonne de type nvarchar(40).

USE AdventureWorks2012;
GO
CREATE TABLE t1(c1 varchar(40), c2 nvarchar(40) );
GO
SELECT COL_LENGTH('t1','c1')AS 'VarChar',
      COL_LENGTH('t1','c2')AS 'NVarChar';
GO
DROP TABLE t1;

Voici l'ensemble des résultats.