COL_LENGTH (Transact-SQL)

Статья
03/07/2014

Возвращает определенную длину столбца в байтах.

Применимо для следующих объектов: SQL Server (SQL Server 2008 по текущую версию), База данных SQL Windows Azure (С первоначального выпуска по текущий выпуск).

Значок ссылки на раздел Cинтаксические обозначения в Transact-SQL

Синтаксис

COL_LENGTH ( 'table' , 'column' )

Аргументы

' table '
Имя таблицы, для которой необходимо получить сведения о длине столбца. Аргумент table является выражением типа nvarchar.
' column '
Имя столбца, для которого необходимо определить длину. Аргумент column является выражением типа nvarchar.

Возвращаемый тип

smallint

Исключения

Возвращает значение NULL в случае ошибки или если участник не имеет разрешения на просмотр объекта.

В SQL Server пользователь может просматривать только метаданные защищаемых объектов, которыми он владеет или на которые ему были предоставлены разрешения. Это означает, что встроенные функции, создающие метаданные, такие как COL_LENGTH, могут вернуть значение NULL в случае, если пользователь не имеет разрешений на объект. Дополнительные сведения см. в разделе Настройка видимости метаданных.

Замечания

Для столбцов типа varchar, объявленных с описателем max (varchar(max)), функция COL_LENGTH возвращает значение -1.

Примеры

В следующем примере демонстрируются возвращаемые значения для столбца типа varchar(40) и для столбца типа nvarchar(40).

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

Ниже приводится результирующий набор.