COL_LENGTH (Transact-SQL)

Статья
10/16/2024

Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure

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

Синтаксис

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)
COLUMNPROPERTY (Transact-SQL)

Поделиться через