COL_LENGTH (Transact-SQL)

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL databáze v Microsoft Fabric

Tato funkce vrací definovanou délku sloupce v bajtech.

Transact-SQL konvence syntaxe

Syntaxe

COL_LENGTH ( 'table' , 'column' )   

Arguments

'stůl'
Název tabulky, jejíž délku sloupce chceme určit. Tabulka je výraz typu Nvarchar.

'sloupec'
Název sloupce, jehož délku chceme určit. Sloupec je výraz typu Nvarchar.

Návratový typ

smallint

Exceptions

Vrací NULL při chybě nebo pokud volající nemá správné oprávnění k zobrazení objektu.

V SQL Serveru může uživatel zobrazit pouze metadata zabezpečených zařízení, která vlastní nebo na která mu byla udělena oprávnění. To znamená, že vestavěné funkce vysílající metadata, jako je COL_LENGTH, mohou vrátit NULL, pokud uživatel nemá správné oprávnění k objektu. Pro více informací viz Metadata Visibility Configuration .

Poznámky

Pro varcharovy sloupce deklarované pomocí max specifikátoru (varchar(max)) COL_LENGTH vrací hodnotu -1.

Examples

Tento příklad ukazuje návratové hodnoty sloupce typu varchar(40) a sloupce typu 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;  

Tady je soubor výsledků.

VarChar     NVarChar  
40          80  

Viz také

Výrazy (Transact-SQL)
Funkce metadat (Transact-SQL)
COL_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)