COL_LENGTH (Transact-SQL)

  • Articolo

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure

La funzione restituisce la lunghezza di una colonna, definita in byte.

Convenzioni di sintassi Transact-SQL

Sintassi

COL_LENGTH ( 'table' , 'column' )

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

'table'
Nome della tabella per cui si vuole ottenere informazioni sulla lunghezza delle colonne. table è un'espressione di tipo nvarchar.

'colonna'
Nome della colonna di cui si vuole determinare la lunghezza. column è un'espressione di tipo nvarchar.

Tipo restituito

smallint

Eccezioni

Restituisce NULL in caso di errore o se un chiamante non ha l'autorizzazione corretta 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 ha l'autorizzazione corretta per l'oggetto. Per altre 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 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;

Questo è il set di risultati.

VarChar     NVarChar  
40          80

Vedi anche

Espressioni (Transact-SQL)
Funzioni dei metadati (Transact-SQL)
COL_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)