Apache Iceberg ve Delta Lake için değişken türü desteği

Veri VARIANT türü yarı yapılandırılmış verileri depolar. VARIANT ile çalışmaya dair örnekler için bkz. Değişken verileri sorgulama.

Tüm Apache Iceberg v3 tabloları tür desteği içerir VARIANT . Bkz. Apache Iceberg v3 özelliklerini kullanma. Delta Lake tabloları için tür desteğini açıkça etkinleştirmeniz VARIANT gerekir.

Değişken desteği etkinleştirilmiş tabloları okumak ve yazmak için Databricks Runtime 15.4 LTS veya üzerini kullanmanız gerekir.

Tabloda değişken etkinleştirme

Değişkeni etkinleştirmek için tür sütununa sahip yeni bir VARIANT tablo oluşturun:

CREATE TABLE table_name (variant_column VARIANT)

Var olan bir tabloda desteğini etkinleştirmek için VARIANT aşağıdaki söz dizimini kullanın:

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

Note

Variant'ı etkinleştirmek tablo yazıcı protokolünü yükseltir. Bu, dış Delta Lake istemcileriyle uyumluluğu etkileyebilir. Bkz . Delta Lake özellik uyumluluğu ve protokolleri.

Sınırlamalar

Veri türü desteği VARIANT aşağıdaki sınırlamalara sahiptir:

• Tabloyu bölümlendirmek için değişken sütunları kullanamazsınız.
• Değişken sütun, bir tablo için kümeleme anahtarı olamaz.
• GROUP BY veya ORDER BY yan tümceleriyle değişken sütunları kullanamazsınız.
• Değişken sütun üzerinde DISTINCT kullanamazsınız.
• SQL kümesi işleçlerini (INTERSECT, UNION, EXCEPT) değişken sütunlarla kullanamazsınız.
• Değişken sütun oluşturmak için sütun üretimini kullanamazsınız.
• Değişken sütunlar minValues ve maxValues istatistiklerini desteklemez.
• Değişken sütun, 128 MiB'den (Databricks Runtime 17.1 ve altında 16 MiB) büyük bir değer içeremez.