Supporto dei tipi varianti

Importante

Questa funzionalità è disponibile in anteprima pubblica.

Il VARIANT tipo di dati archivia dati semistrutturati. Per esempi sull'uso di VARIANT, vedere Query sui dati delle varianti.

Tutte le tabelle Apache Iceberg v3 includono il VARIANT supporto per i tipi. Vedere Usare le funzionalità di Apache Iceberg v3. Per le tabelle Delta Lake, è necessario abilitare esplicitamente il supporto per il tipo VARIANT.

È necessario usare Databricks Runtime 15.3 o versione successiva per leggere e scrivere tabelle con supporto variant abilitato.

Abilitare variante in una tabella

Per abilitare il variant, creare una nuova tabella con una colonna di tipo VARIANT.

CREATE TABLE table_name (variant_column VARIANT)

Per abilitare il supporto per VARIANT su una tabella esistente, usare la sintassi seguente.

ALTER TABLE table_name SET TBLPROPERTIES('delta.feature.variantType-preview' = 'supported')

Avviso

Quando si abilita la variante, Azure Databricks aggiorna il protocollo di tabella. I client che non supportano variant non possono leggere la tabella. Vedere Compatibilità e protocolli delle funzionalità delta Lake.

Limiti

Il supporto per il VARIANT tipo di dati presenta le limitazioni seguenti.

  • Non è possibile usare colonne varianti per partizionare una tabella.
  • Una colonna variant non può essere una chiave di clustering per una tabella.
  • Non è possibile utilizzare colonne varianti con le clausole GROUP BY o ORDER BY.
  • Non è possibile chiamare DISTINCT su una colonna variante.
  • Non è possibile usare gli operatori set SQL (INTERSECT, UNION, EXCEPT) con colonne varianti.
  • Non è possibile usare la generazione di colonne per creare una colonna variante.
  • Le colonne varianti non supportano le statistiche minValues o maxValues.
  • Una colonna variant non può contenere un valore maggiore di 128 MiB (16 MiB in Databricks Runtime 17.1 e versioni successive).
  • Last updated on