COL_LENGTH (Transact-SQL)

 

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)ouiAzure SQL DatabasenonAzure SQL Data WarehousenonParallel Data Warehouse

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

Topic link icon Conventions de la syntaxe Transact-SQL

  
COL_LENGTH ( 'table' , 'column' )   

' 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. colonne est une expression de type nvarchar.

smallint

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 Metadata Visibility Configuration.

Pour les colonnes de type varchar déclarés avec le max spécificateur (varchar (max)), COL_LENGTH renvoie la valeur –&1;.

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.

VarChar     NVarChar  
40          80  

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

Ajouts de la communauté

AJOUTER
Afficher: