COL_LENGTH (Transact-SQL)

A következőkre vonatkozik:SQL ServerAzure SQL DatabaseFelügyelt Azure SQL-példánySQL-adatbázis a Microsoft Fabricben

Ez a függvény adja vissza az oszlop definiált hosszát bájtokban.

Transact-SQL szintaxis konvenciók

Szemantika

COL_LENGTH ( 'table' , 'column' )   

Arguments

'asztal'
Az a tábla neve, amelynek oszlophossz információját szeretnénk meghatározni. a táblázata nvarchar típus kifejezése.

'oszlop'
Az oszlop neve, amelynek hosszát szeretnénk meghatározni. Az oszlopa nvarchar típus kifejezése.

Visszatérési típus

smallint

Exceptions

Hibával vagy ha a hívó nem rendelkezik a megfelelő jogosultsággal a tárgy megtekintésére, NULL-t ad vissza.

Az SQL Serverben a felhasználó csak azokat a biztonsági eszközök metaadatait tekintheti meg, amelyek a felhasználó tulajdonában vannak, vagy amelyekre engedélyt kapott. Ez azt jelenti, hogy metaadatot kibocsátó, beépített funkciók, mint az COL_LENGTH, akár a NULL-t is visszaadhatják, ha a felhasználónak nincs megfelelő engedélye az objektumra. További információért lásd a Metadata Visibility Configuration (Metadata Visibility Configuration ) oldalt.

Megjegyzések

A maximális specifikátorral (varchar(max)) deklarált varchar oszlopok esetén COL_LENGTH -1 értéket ad.

Példák

Ez a példa egy típusú varchar(40) oszlop és egy típusú nvarchar(40)oszlop visszaküldési értékeit mutatja:

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;  

Itt van az eredmények összessége.

VarChar     NVarChar  
40          80  

Lásd még

Kifejezések (Transact-SQL)
Metaadatfüggvények (Transact-SQL)
COL_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)