COL_LENGTH (Transact-SQL)

Mis à jour : 17 juillet 2006

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

Conventions de la syntaxe de 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.

Exceptions

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

Dans SQL Server 2005, 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 et Dépannage 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 renvoie la valeur –1.

Type renvoyé

smallint

Exemple

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

USE AdventureWorks;
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.

VarChar     NVarChar
40          80

Voir aussi

Référence

Expressions (Transact-SQL)
Fonctions de métadonnées (Transact-SQL)
COL_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)

Autres ressources

Modification des propriétés d'une colonne

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
17 juillet 2006	Nouveau contenu : Ajout de la section « Exceptions ».