COL_LENGTH (Transact-SQL)

Artigo
03/07/2014

Retorna o comprimento definido, em bytes, de uma coluna.

Aplica-se a: SQL Server (SQL Server 2008 até a versão atual), Banco de dados SQL do Windows Azure (versão inicial até a versão atual).

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

COL_LENGTH ( 'table' , 'column' )

Argumentos

' table '
É o nome da tabela para a qual determinar as informações de comprimento de coluna. table é uma expressão de tipo nvarchar.
' column '
É o nome da coluna para a qual determinar as informações de comprimento de coluna. column é uma expressão do tipo nvarchar.

Tipo de retorno

smallint

Exceções

Retorna NULL em caso de erro ou se um chamador não tiver permissão para exibir o objeto.

No SQL Server, um usuário só pode exibir os metadados de itens protegíveis de sua propriedade ou para os quais ele tenha permissão concedida. Isso significa que as funções internas que emitem metadados, como COL_LENGTH, poderão retornar NULL se o usuário não tiver nenhuma permissão para o objeto. Para obter mais informações, consulte Configuração de visibilidade de metadados.

Comentários

Para colunas do tipo varchar declaradas com o especificador max (varchar(max)), COL_LENGTH retorna o valor –1.

Exemplos

O exemplo a seguir mostra os valores de retorno para uma coluna do tipo varchar(40) e uma coluna do tipo nvarchar(40).

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

Aqui está o conjunto de resultados.