Dukungan jenis varian untuk Apache Iceberg dan Delta Lake

Important

Fitur ini ada di Pratinjau Umum.

VARIANT Tipe data menyimpan data yang setengah terstruktur. Untuk contoh tentang bekerja dengan VARIANT, lihat varian data kueri.

Semua tabel Apache Iceberg v3 menyertakan dukungan untuk tipe VARIANT. Lihat Menggunakan fitur Apache Iceberg v3. Untuk tabel Delta Lake, Anda harus secara eksplisit mengaktifkan dukungan tipe VARIANT.

Anda harus menggunakan Databricks Runtime 15.4 LTS atau lebih tinggi untuk membaca dan menulis tabel dengan dukungan varian diaktifkan.

Mengaktifkan varian pada tabel

Untuk mengaktifkan varian, buat tabel baru dengan VARIANT kolom jenis:

CREATE TABLE table_name (variant_column VARIANT)

Untuk mengaktifkan dukungan pada VARIANT tabel yang sudah ada, gunakan sintaks berikut:

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

Note

Mengaktifkan varian ini memutakhirkan protokol penulisan tabel. Ini dapat memengaruhi kompatibilitas dengan klien Delta Lake eksternal. Lihat Kompatibilitas dan protokol fitur Delta Lake.

Keterbatasan

Dukungan untuk VARIANT jenis data memiliki batasan berikut:

• Anda tidak dapat menggunakan kolom varian untuk mempartisi tabel.
• Kolom varian tidak dapat menjadi kunci pengklusteran untuk tabel.
• Anda tidak dapat menggunakan kolom varian dengan GROUP BY atau ORDER BY klausa.
• Anda tidak dapat memanggil DISTINCT pada kolom varian.
• Anda tidak dapat menggunakan operator set SQL (INTERSECT, , UNIONEXCEPT) dengan kolom varian.
• Anda tidak dapat menggunakan pembuatan kolom untuk membuat kolom varian.
• Kolom varian tidak mendukung minValues atau maxValues statistik.
• Kolom varian tidak boleh berisi nilai yang lebih besar dari 128 MiB (16 MiB di Databricks Runtime 17.1 ke bawah).