Typ: VARIANT

Dotyczy: Databricks SQL Databricks Runtime 15.3 i nowsze

Ważny

Ta funkcja znajduje się w fazie publicznej wersji zapoznawczej .

Reprezentuje dane częściowo ustrukturyzowane.

Składnia

VARIANT

Limity

Typ obsługuje przechowywanie dowolnych częściowo ustrukturyzowanych danych, w tym STRUCT, ARRAY, MAP i typów skalarnych. VARIANT może przechowywać tylko typy MAP z kluczami typu STRING.

Literały

Aby uzyskać szczegółowe informacje na temat tworzenia wartości VARIANT, zobacz funkcję , funkcjęparse_json oraz funkcję. Możesz również użyć funkcji CAST, aby przekonwertować literał pewnego typu na VARIANT.

Uwagi

• Aby wyodrębnić wartość z obiektu VARIANT , możesz użyć
  • variant_get funkcji przy użyciu wyrażenia ścieżki JSON , aby przejść do typu złożonego.
  • : (znak dwukropka) operator, aby przeanalizować VARIANT przy użyciu wyrażenia ścieżki JSON.
  • try_variant_get funkcji przy użyciu ścieżki JSON, aby przejść do typu złożonego z tolerancją błędów.
  • cast lub :: (znak dwukropka) operator rzutować VARIANT do określonego typu.
  • try_cast funkcja rzutuje VARIANT na określony typ z tolerancją błędów.
• Aby sprawdzić typ wartości VARIANT, użyj
  • schema_of_variant funkcja dla pojedynczej wartości.
  • schema_of_variant_agg funkcja agregująca dla kolekcji wartości.

Przykłady

> SELECT parse_json('{"key": 123, "data": [4, 5, "str"]}');
  {"data":[4,5,"str"],"key":123}

> SELECT parse_json(null);
  null

> SELECT parse_json('123');
  123

> SELECT CAST(123.456 AS VARIANT);
  1.456

Powiązane

• :: Operator (znak dwukropka)
• cast funkcja
• parse_json funkcja
• schema_of_variant funkcja
• schema_of_variant_agg funkcja agregacji
• try_cast funkcja
• try_variant_get funkcja
• variant_get funkcja