COL_LENGTH (Transact-SQL)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBaza danych SQL w usłudze Microsoft Fabric

Funkcja ta zwraca zdefiniowaną długość kolumny w bajtach.

Transact-SQL konwencje składni

Składnia

COL_LENGTH ( 'table' , 'column' )   

Arguments

'stół'
Nazwa tabeli, której informacje o długości kolumny chcemy określić. Tabela jest wyrażeniem typu Nvarchar.

'kolumna'
Nazwa kolumny, której długość chcemy określić. Kolumna to wyrażenie typu Nvarchar.

Typ zwracany

smallint

Exceptions

Zwraca NULL w przypadku błędu lub jeśli wywołujący nie ma prawidłowego pozwolenia na widok obiektu.

W SQL Server użytkownik może przeglądać tylko metadane zabezpieczalnych obiektów, które posiada lub do których otrzymał uprawnienia. Oznacza to, że wbudowane funkcje emitujące metadane, takie jak COL_LENGTH, mogą zwracać NULL, jeśli użytkownik nie ma prawidłowych uprawnień do obiektu. Więcej informacji można znaleźć w Metadata Visibility Configuration .

Uwagi

Dla kolumn varchara zadeklarowanych za pomocą maksymalnego specyfikatora (varchar(max)), COL_LENGTH zwraca wartość -1.

Przykłady

Ten przykład pokazuje wartości zwrotne dla kolumny typu varchar(40) oraz kolumny 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;  

Oto zestaw wyników.

VarChar     NVarChar  
40          80  

Zobacz także

Wyrażenia (Transact-SQL)
Funkcje metadanych (Transact-SQL)
COL_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)