Condividi tramite

  • Articolo

COL_LENGTH (Transact-SQL)

Restituisce la lunghezza definita di una colonna, espressa in byte.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

COL_LENGTH ( 'table' , 'column' )

Argomenti

  • 'table'
    Nome della tabella a cui appartiene la colonna per cui si desidera ottenere informazioni sulla lunghezza. table è un'espressione di tipo nvarchar.

  • 'column'
    Nome della colonna per cui si desidera ottenere informazioni sulla lunghezza. column è un'espressione di tipo nvarchar.

Tipo restituito

smallint

Eccezioni

Restituisce NULL in caso di errore o se un chiamante non dispone dell'autorizzazione necessaria per visualizzare l'oggetto.

In SQL Server un utente può visualizzare esclusivamente i metadati delle entità a sicurezza diretta di cui è proprietario o per cui ha ricevuto un'autorizzazione. Di conseguenza, le funzioni predefinite di creazione dei metadati come COL_LENGTH possono restituire NULL se l'utente non dispone di alcuna autorizzazione per l'oggetto. Per ulteriori informazioni, vedere Configurazione della visibilità dei metadati e Risoluzione dei problemi relativi alla visibilità dei metadati.

Osservazioni

Per le colonne di tipo varchar dichiarate con l'identificatore max (varchar(max)), COL_LENGTH restituisce il valore –1.

Esempi

Nell'esempio seguente vengono illustrati i valori restituiti per una colonna di tipo varchar(40) e una colonna di 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;

Set di risultati:

VarChar     NVarChar
40          80