COL_LENGTH (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Esta função devolve o comprimento definido de uma coluna, em bytes.

Transact-SQL convenções de sintaxe

Sintaxe

COL_LENGTH ( 'table' , 'column' )   

Arguments

'mesa'
O nome da tabela cuja informação sobre o comprimento da coluna queremos determinar. Table é uma expressão do tipo Nvarchar.

'coluna'
O nome da coluna cujo comprimento queremos determinar. coluna é uma expressão do tipo nvarchar.

Tipo de retorno

smallint

Exceptions

Retorna NULL em caso de erro, ou se um chamador não tiver a permissão correta para visualizar o objeto.

No SQL Server, um utilizador só pode visualizar os metadados de seguráveis que o utilizador possui, ou sobre os quais o utilizador recebeu permissão. Isto significa que funções incorporadas que emitem metadados, como COL_LENGTH, podem devolver NULL, se o utilizador não tiver a permissão correta sobre o objeto. Consulte Configuração de Visibilidade de Metadados para mais informações.

Observações

Para colunas varchar declaradas com o especificador máximo (varchar(max)), COL_LENGTH devolve o valor -1.

Examples

Este exemplo mostra os valores de retorno para uma coluna de tipo varchar(40) e uma coluna de tipo 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;  

Aqui está o conjunto de resultados.

VarChar     NVarChar  
40          80  

Consulte também

Expressões (Transact-SQL)
Funções de metadados (Transact-SQL)
COL_NAME (Transact-SQL)
PROPRIEDADE COLUMNA (Transact-SQL)