• Статья

COL_LENGTH (Transact-SQL)

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

Значок ссылки на разделСинтаксические обозначения в 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 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;

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

VarChar     NVarChar
40          80