Udostępnij przez


Obsługa typów wariantów

Ważne

Ta funkcja jest dostępna w publicznej wersji zapoznawczej.

Typ VARIANT danych przechowuje dane częściowo ustrukturyzowane. Przykłady pracy z usługą VARIANTmożna znaleźć w temacie Query variant data (Wykonywanie zapytań dotyczących danych wariantów).

Aby odczytywać i zapisywać tabele z obsługą wariantów, należy użyć środowiska Databricks Runtime w wersji 15.3 lub nowszej.

Włączanie wariantu w tabeli

Aby włączyć wariant, utwórz nową tabelę z kolumną VARIANT typu, na przykład:

CREATE TABLE table_name (variant_column VARIANT)

Aby włączyć obsługę VARIANT na istniejącej tabeli, użyj następującej składni:

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

Ostrzeżenie

Po włączeniu wariantu usługa Databricks uaktualnia protokół tabeli. Klienci, którzy nie obsługują wariantu, nie mogą odczytać tabeli. Zobacz kompatybilność funkcji Delta Lake i protokoły.

Ograniczenia

Istnieją następujące ograniczenia:

  • Nie można używać kolumn wariantów do partycjonowania tabeli.
  • Kolumna wariantu nie może być kluczem klastrowania dla tabeli.
  • Nie można używać kolumn wariantów z klauzulami GROUP BY lub .ORDER BY
  • Nie można wywołać DISTINCT na kolumnie wariantu.
  • Nie można używać operatorów zestawu SQL (INTERSECT, UNION, EXCEPT) z kolumnami wariantów.
  • Nie można użyć generowania kolumn, aby utworzyć kolumnę wariantu.
  • Kolumny wariantów nie obsługują minValues ani maxValues statystyk.
  • Kolumna wariantu nie może zawierać wartości większej niż 128 MiB (16 MiB w środowisku Databricks Runtime 17.1 i poniżej).