COL_LENGTH (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 protezione 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 AdventureWorks;
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

Vedere anche

Riferimento

Concetti