COL_LENGTH (Transact-SQL)
Restituisce la lunghezza definita di una colonna, espressa in byte.
Si applica a: SQL Server (SQL Server 2008 tramite versione corrente), Database SQL di Windows Azure (versione iniziale tramite versione corrente). |
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:
VarChar NVarChar
40 80