COL_LENGTH (Transact-SQL)

  • Статья

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

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

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

Синтаксис

COL_LENGTH ( 'table' , 'column' )

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

'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)