Typ: VARIANT
Dotyczy: Databricks Runtime 15.3 lub nowszy
Reprezentuje dane częściowo ustrukturyzowane.
Składnia
VARIANT
Limity
Typ obsługuje przechowywanie dowolnych częściowo ustrukturyzowanych danych, w tym STRUCT
typów skalarnych , ARRAY
, MAP
i .
VARIANT
może przechowywać MAP
tylko typy z kluczami typu STRING
.
Literały
Aby uzyskać szczegółowe informacje na temat tworzenia VARIANT
wartości, zobacz parse_json funkcji.
Możesz również użyć CAST
funkcji , aby przekonwertować literał 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
użycie 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.
- funkcja rzutowania lub :: (znak dwukropka) operator rzutowania
VARIANT
na określony typ. - try_cast funkcji rzutowania
VARIANT
do określonego typu z tolerancją błędu.
- Aby sprawdzić typ
VARIANT
wartości, użyj elementu- schema_of_variant funkcja dla pojedynczej wartości.
- schema_of_variant_agg funkcja agregacji 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);
123.456