COL_LENGTH (Transact-SQL)COL_LENGTH (Transact-SQL)

APLICA-SE A: simSQL Server simBanco de Dados SQL do Azure nãoSQL Data Warehouse do Azure nãoParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Essa função retorna o comprimento definido de uma coluna em bytes.This function returns the defined length of a column, in bytes.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

COL_LENGTH ( 'table' , 'column' )   

ArgumentosArguments

' table '' table '
O nome da tabela cujas informações de comprimento de coluna queremos determinar.The name of the table whose column length information we want to determine. table é uma expressão do tipo nvarchar.table is an expression of type nvarchar.

' column '' column '
O nome da coluna cujo comprimento queremos determinar.The column name whose length we want to determine. column é uma expressão do tipo nvarchar.column is an expression of type nvarchar.

Tipo de retornoReturn type

smallintsmallint

ExceçõesExceptions

Retornará NULL em caso de erro ou se um chamador não tiver a permissão correta para exibir o objeto.Returns NULL on error, or if a caller does not have the correct permission to view the object.

No SQL ServerSQL Server, um usuário pode exibir apenas os metadados de itens protegíveis de sua propriedade ou para os quais ele tenha recebido permissão.In SQL ServerSQL Server, a user can only view the metadata of securables that the user owns, or on which the user has been granted permission. Isso significa que as funções internas que emitem metadados, como COL_LENGTH, poderão retornar NULL se o usuário não tiver a permissão correta para o objeto.This means that metadata-emitting, built-in functions such as COL_LENGTH might return NULL, if the user does not have correct permission on the object. Veja Configuração de Visibilidade de Metadados para obter mais informações.See Metadata Visibility Configuration for more information.

RemarksRemarks

Para colunas varchar declaradas com o especificador max (varchar(max) ), COL_LENGTH retornará o valor -1.For varchar columns declared with the max specifier (varchar(max)), COL_LENGTH returns the value -1.

ExemplosExamples

Este exemplo mostra os valores retornados para uma coluna do tipo varchar(40) e uma coluna do tipo nvarchar(40):This example shows the return values for a column of type varchar(40) and a column of type 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.Here is the result set.

VarChar     NVarChar  
40          80  

Confira tambémSee also

Expressões (Transact-SQL)Expressions (Transact-SQL)
Funções de metadados (Transact-SQL)Metadata Functions (Transact-SQL)
COL_NAME (Transact-SQL)COL_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)COLUMNPROPERTY (Transact-SQL)