COL_LENGTH (Transact-SQL)

Применимо к:SQL ServerБаза данных SQL AzureУправляемый экземпляр SQL AzureБаза данных SQL в Microsoft Fabric

Эта функция возвращает длину столбца в байтах.

Соглашения о синтаксисе Transact-SQL

Синтаксис

COL_LENGTH ( 'table' , 'column' )   

Аргументы

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

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

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

smallint

Исключения

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

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

Замечания

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

Примеры

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

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

См. также

Выражения (Transact-SQL)
Функции метаданных (Transact-SQL)
COL_NAME (Transact-SQL)
СВОЙСТВО COLUMN (Transact-SQL)