COL_LENGTH (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 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;
Ниже приводится результирующий набор.
VarChar NVarChar
40 80
См. также