Udostępnij za pośrednictwem

  • Artykuł

COL_LENGTH (Transact-SQL)

Zwraca określoną długość w bajtach kolumna.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

COL_LENGTH ( 'table' , 'column' )

Argumenty

  • 'table'
    Jest nazwą tabela , dla którego należy określić informacje o długości kolumna .tableto wyrażenie typu nvarchar.

  • 'column'
    Jest to nazwa kolumna do ustalania długości.column to wyrażenie typu nvarchar.

Zwracany typ

smallint

Wyjątki

Zwraca wartość NULL w błąd lub jeśli wywołujący nie ma uprawnień do wyświetlenia obiektu.

W SQL Server, użytkownik może przeglądać tylko metadane securables, który użytkownik jest właścicielem lub na którym przyznano użytkownikowi uprawnienie.Oznacza to, że metadane-wysyłających, funkcje wbudowane takie jak COL_LENGTH może zwracać wartość NULL, jeśli użytkownik nie ma żadnych uprawnień do obiektu.Aby uzyskać więcej informacji, zobacz Konfiguracja widoczność metadanych i Rozwiązywanie problemów z metadanych widoczności.

Uwagi

Dla kolumny typu varchar zadeklarowana z max specyfikator (varchar(max)), COL_LENGTH zwraca wartość –1.

Przykłady

W poniższym przykładzie pokazano zwracane wartości dla kolumna typu varchar(40) i kolumna typu nvarchar(40).

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