Compartilhar via

  • Artigo

COL_LENGTH (Transact-SQL)

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

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

COL_LENGTH ( 'table' , 'column' )

Argumentos

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

  • 'column'
    É o nome da coluna para a qual o comprimento deve ser determinado. 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 e Solucionando problemas 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 AdventureWorks2008R2;
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.

VarChar     NVarChar
40          80