COL_LENGTH (Transact-SQL)

Articolo
06/18/2013

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

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

COL_LENGTH ( 'table' , 'column' )

Argomenti

' table '
Nome della tabella per cui si desidera ottenere informazioni sulla lunghezza delle colonne. 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.

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 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;

Set di risultati: