Udostępnij za pośrednictwem

  • Artykuł

COL_LENGTH (Transact-SQL)

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

Topic link iconKonwencje składni języka Transact-SQL

COL_LENGTH ( 'table' , 'column' )

Argumenty

  • 'table'
    Is the name of the table for which to determine column length information.table is an expression of type nvarchar.

  • 'column'
    Is the name of the column for which to determine length.column is an expression of type nvarchar.

Zwracany typ

smallint

Exceptions

Zwraca wartość NULL na błąd, lub jeśli wywołujący nie ma uprawnień do oglądania obiektu.

W SQL Server, użytkownik może tylko przeglądać metadane securables należące do tego użytkownika lub w którym użytkownik ma udzielonego uprawnienia. Oznacza to, czy wysyłających metadane wbudowane działa 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ść metadane i Troubleshooting Metadata Visibility.

Remarks

W przypadku kolumn 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 kolumn typu nvarchar(40).

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

Here is the result set.

VarChar     NVarChar
40          80