COL_LENGTH (Transact-SQL)

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-databas i Microsoft Fabric

Denna funktion returnerar den definierade längden på en kolumn, i bytes.

Transact-SQL syntaxkonventioner

Syntax

COL_LENGTH ( 'table' , 'column' )   

Arguments

'bord'
Namnet på tabellen vars kolumnlängdsinformation vi vill bestämma. Tabell är ett uttryck av typen nvarchar.

'kolumn'
Kolumnnamnet vars längd vi vill bestämma. kolumn är ett uttryck av typen nvarchar.

Returtyp

smallint

Exceptions

Returnerar NULL vid fel, eller om en anropare inte har rätt behörighet att visa objektet.

I SQL Server kan en användare endast se metadata för värdepappersfiler som användaren äger eller har fått tillstånd till. Detta innebär att inbyggda funktioner som COL_LENGTH kan returnera NULL om användaren inte har rätt behörighet på objektet. Se Metadata Visibility Configuration för mer information.

Anmärkningar

För varchar-kolumner deklarerade med max-specificeraren (varchar(max)) returnerar COL_LENGTH värdet -1.

Examples

Detta exempel visar returvärdena för en kolumn av typen varchar(40) och en kolumn av typen 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;  

Här är resultatet.

VarChar     NVarChar  
40          80  

Se även

Uttryck (Transact-SQL)
Metadata functions (Transact-SQL)
COL_NAME (Transact-SQL)
KOLUMNEGENSKAP (Transact-SQL)