COL_LENGTH (Transact-SQL)

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-database in Microsoft Fabric

Deze functie geeft de gedefinieerde lengte van een kolom terug, in bytes.

Transact-SQL syntaxis-conventies

Syntaxis

COL_LENGTH ( 'table' , 'column' )   

Arguments

'tafel'
De naam van de tabel waarvan we de kolomlengte-informatie willen bepalen. table is een uitdrukking van het type Nvarchar.

'kolom'
De kolomnaam waarvan we de lengte willen bepalen. kolom is een uitdrukking van het type nvarchar.

Resultaattype

smallint

Exceptions

Geeft NULL terug bij fout, of als een aanroeper niet de juiste toestemming heeft om het object te bekijken.

In SQL Server kan een gebruiker alleen de metadata bekijken van securables die de gebruiker bezit, of waarop de gebruiker toestemming heeft gekregen. Dit betekent dat metadata-uitzendende, ingebouwde functies zoals COL_LENGTH mogelijk NULL teruggeven, als de gebruiker geen juiste toestemming voor het object heeft. Zie Metadata Visibility Configuration voor meer informatie.

Opmerkingen

Voor varchar-kolommen die zijn gedeclareerd met de max-specificeerder (varchar(max)), geeft COL_LENGTH de waarde -1 terug.

Voorbeelden

Dit voorbeeld toont de retourwaarden voor een kolom van type en varchar(40) een kolom van type nvarchar(40):

USE AdventureWorks2022;  
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;  

Hier is het resultatenoverzicht.

VarChar     NVarChar  
40          80  

Zie ook

Expressies (Transact-SQL)
Metagegevensfuncties (Transact-SQL)
COL_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)