sql_variant (Transact-SQL)
Tipo di dati per l'archiviazione di valori per vari tipi di dati supportati da SQL Server.
.gif "Icona di collegamento a un argomento")
Sintassi
sql_variant
Osservazioni
È possibile utilizzare il tipo di dati sql_variant in colonne, parametri, variabili e valori restituiti delle funzioni definite dall'utente. Il tipo di dati sql_variant consente il supporto di valori di altri tipi di dati in questi oggetti di database.
Una colonna di tipo sql_variant può includere righe con tipi di dati diversi, ad esempio, in una colonna di tipo sql_variant è possibile archiviare valori di tipo int, binary e char. Nella tabella seguente sono elencati i tipi di valore che non è possibile archiviare con il tipo di dati sql_variant:
varchar(max) |
varbinary(max) |
nvarchar(max) |
xml |
text |
ntext |
image |
timestamp |
sql_variant |
geography |
hierarchyid |
geometry |
Tipi definiti dall'utente |
La lunghezza massima supportata da sql_variant è pari a 8016 byte. La lunghezza include sia le informazioni sul tipo di base che il valore del tipo di base. La lunghezza massima del valore effettivo del tipo di base è di 8.000 byte.
Per poter utilizzare il tipo di dati sql_variant in operazioni quali l'addizione e la sottrazione, è prima necessario eseguirne il casting al valore del tipo di dati di base corrispondente.
È supportata l'assegnazione di un valore predefinito a sql_variant. A questo tipo di dati è inoltre possibile assegnare NULL come valore sottostante, ma in questo caso ai valori NULL non verrà associato alcun tipo di base. Inoltre, non è consentito impostare un altro valore sql_variant come tipo di base per sql_variant.
Una chiave univoca, primaria o esterna può includere colonne di tipo sql_variant, ma la lunghezza totale dei valori di dati che compongono la chiave di una riga specifica non deve essere maggiore della lunghezza massima di un indice, ovvero 900 byte.
Una tabella può contenere un numero qualsiasi di colonne di tipo sql_variant.
Non è possibile utilizzare il tipo di dati sql_variant in CONTAINSTABLE e FREETEXTTABLE.
ODBC non offre un supporto completo del tipo sql_variant. Quando si utilizza il provider Microsoft OLE DB per ODBC (MSDASQL), pertanto, le query eseguite su colonne di tipo sql_variant restituiscono dati binary. Ad esempio, la stringa di caratteri 'PS2091' di una colonna di tipo sql_variant viene restituita come 0x505332303931.
Confronto di valori sql_variant
Il tipo di dati sql_variant è incluso nella parte iniziale dell'elenco della gerarchia dei tipi di dati per la conversione. Per l'esecuzione di confronti di valori sql_variant, la gerarchia dei tipi di dati di SQL Server viene suddivisa in gruppi di tipi di dati.
Gerarchia dei tipi di dati |
Gruppo di tipi di dati |
|---|---|
sql_variant |
sql_variant |
datetime2 |
Data e ora |
datetimeoffset |
Data e ora |
datetime |
Data e ora |
smalldatetime |
Data e ora |
date |
Data e ora |
time |
Data e ora |
float |
Valori numerici approssimati |
real |
Valori numerici approssimati |
decimal |
Dati numerici esatti |
money |
Dati numerici esatti |
smallmoney |
Dati numerici esatti |
bigint |
Dati numerici esatti |
int |
Dati numerici esatti |
smallint |
Dati numerici esatti |
tinyint |
Dati numerici esatti |
bit |
Dati numerici esatti |
nvarchar |
Unicode |
nchar |
Unicode |
varchar |
Unicode |
char |
Unicode |
varbinary |
Dati binari |
binary |
Dati binari |
uniqueidentifier |
Uniqueidentifier |
Per i confronti sql_variant vengono applicate le regole seguenti:
Nei confronti tra due valori sql_variant con tipi di dati di base diversi appartenenti a gruppi di tipi di dati differenti, il valore appartenente al gruppo di tipi di dati che occupa un livello più alto nella gerarchia viene considerato il valore maggiore dei due valori.
Nei confronti di valori sql_variant con tipi di dati di base diversi appartenenti allo stesso gruppo, il valore del tipo di dati di base che appartiene a un gruppo di livello inferiore nella gerarchia viene convertito in modo implicito nell'altro tipo di dati, dopodiché viene eseguito il confronto.
Quando vengono confrontati i valori sql_variant dei tipi di dati char, varchar, nchar o nvarchar, le regole di confronto vengono messe a confronto innanzitutto in base ai criteri seguenti: LCID, versione LCID, flag di confronto e ID di ordinamento. Per ognuno di questi criteri il confronto viene eseguito con valori integer e nell'ordine elencato. Se tutti questi criteri sono uguali, i valori effettivi della stringa vengono confrontati in base alle regole di confronto.