Dimensioni della colonna

La dimensione della colonna (o del parametro) dei tipi di dati numerici è definita come il numero massimo di cifre usate dal tipo di dati della colonna o del parametro o della precisione dei dati. Per i tipi di caratteri, si tratta della lunghezza in caratteri dei dati; per i tipi di dati binari, le dimensioni delle colonne sono definite come la lunghezza in byte dei dati. Per i tipi di dati time, timestamp e tutti gli intervalli, si tratta del numero di caratteri nella rappresentazione di caratteri di questi dati. La dimensione della colonna definita per ogni tipo di dati SQL conciso è illustrata nella tabella seguente.

Identificatore del tipo SQL	Dimensioni colonna
Tutti i tipi di caratteri[a],[b]	Dimensione della colonna definita o massima in caratteri della colonna o del parametro (come contenuto nel campo del descrittore SQL_DESC_LENGTH). Ad esempio, la dimensione della colonna di una colonna di caratteri a byte singolo definita come CHAR(10) è 10.
SQL_DECIMAL SQL_NUMERIC	Numero definito di cifre. Ad esempio, la precisione di una colonna definita come NUMERIC(10,3) è 10.
SQL_BIT[c]	1
SQL_TINYINT[c]	3
SQL_SMALLINT[c]	5
SQL_INTEGER[c]	10
SQL_BIGINT[c]	19 (se firmato) o 20 (se non firmato)
SQL_REAL[c]	7
SQL_FLOAT[c]	15
SQL_DOUBLE[c]	15
Tutti i tipi binari[a],[b]	Lunghezza definita o massima in byte della colonna o del parametro. Ad esempio, la lunghezza di una colonna definita come BINARY(10) è 10.
SQL_TYPE_DATE[c]	10 (numero di caratteri nel formato aaaa-mm-gg ).
SQL_TYPE_TIME[c]	8 (il numero di caratteri nel formato hh-mm-ss ) o 9 + s (il numero di caratteri nel formato hh:mm:ss[.fff...] , dove s è la precisione dei secondi).
SQL_TYPE_TIMESTAMP	16 (il numero di caratteri nel formato a-mm-gg hh:mm ) 19 (il numero di caratteri nel formato aa-mm-gghh:mm:ss ) oppure 20 + s (il numero di caratteri nel formato aaaa-mm-gg hh:mm:ss[.fff...] , dove s è la precisione dei secondi).
SQL_INTERVAL_SECOND	Dove p è la precisione iniziale dell'intervallo e s è la precisione dei secondi, p (se s=0) o p+s+1 (se s>0).[ d]
SQL_INTERVAL_DAY_TO_SECOND	Dove p è la precisione iniziale dell'intervallo e s è la precisione dei secondi, 9+p (se s=0) o 10+p+s (se s>0).[ d]
SQL_INTERVAL_HOUR_TO_SECOND	Dove p è la precisione iniziale dell'intervallo e s è la precisione dei secondi, 6+p (se s=0) o 7+p+s (se s>0).[ d]
SQL_INTERVAL_MINUTE_TO_SECOND	Dove p è la precisione iniziale dell'intervallo e s è la precisione dei secondi, 3+p (se s=0) o 4+p+s (se s>0).[ d]
SQL_INTERVAL_YEAR SQL_INTERVAL_MONTH SQL_INTERVAL_DAY SQL_INTERVAL_HOUR SQL_INTERVAL_MINUTE	p, dove p è la precisione iniziale dell'intervallo.[ d]
SQL_INTERVAL_YEAR_TO_MONTH SQL_INTERVAL_DAY_TO_HOUR	3+p, dove p è la precisione iniziale dell'intervallo.[ d]
SQL_INTERVAL_DAY_TO_MINUTE	6+p, dove p è la precisione iniziale dell'intervallo.[ d]
SQL_INTERVAL_HOUR_TO_MINUTE	3+p, dove p è la precisione iniziale dell'intervallo.[ d]
SQL_GUID	36 (numero di caratteri nel formato aaaa-bbbb-cccc-dddd-eeeee)

[a] Per un'applicazione ODBC 1.0 che chiama SQLSetParam in un driver ODBC 2.0 e per un'applicazione ODBC 2.0 che chiama SQLBindParameter in un driver ODBC 1.0, quando *StrLen_or_IndPtr è SQL_DATA_AT_EXEC per un tipo SQL_LONGVARCHAR o SQL_LONGVARBINARY, ColumnSize deve essere impostato sulla lunghezza totale dei dati da inviare, non la precisione definita in questa tabella.

[b] Se il driver non è in grado di determinare la lunghezza della colonna o del parametro per un tipo variabile, restituisce SQL_NO_TOTAL.

[c] L'argomento ColumnSize di SQLBindParameter viene ignorato per questo tipo di dati.

[d] Per le regole generali sulla lunghezza delle colonne nei tipi di dati intervallo, vedere Intervallo lunghezza del tipo di dati, più indietro in questa appendice.

I valori restituiti per la dimensione della colonna (o del parametro) non corrispondono ai valori in un campo descrittore. I valori possono provenire dal SQL_DESC_PRECISION o dal campo SQL_DESC_LENGTH, a seconda del tipo di dati, come illustrato nella tabella seguente.

Tipo SQL	Campo descrittore corrispondente a dimensione colonna o parametro
Tutti i tipi di caratteri e binari	LENGTH
Tutti i tipi numerici	PRECISION
Tutti i tipi datetime e interval	LENGTH
SQL_BIT	LENGTH