Tipo VARIANT
Aplica-se a: Databricks Runtime 15.3 e posterior
Representa dados semiestruturados.
Sintaxe
VARIANT
Limites
O tipo suporta o armazenamento de quaisquer dados semiestruturados, incluindo STRUCT
, ARRAY
, MAP
e tipos escalares.
VARIANT
só pode armazenar MAP
tipos com chaves do tipo STRING
.
Literais
Consulte parse_json função para obter detalhes sobre a criação de um VARIANT
valor.
Você também pode usar a CAST
função para converter um literal de algum tipo para VARIANT
.
Notas
- Para extrair um valor de um,
VARIANT
você pode usar o botão- variant_get função usando uma expressão de caminho JSON para navegar em um tipo complexo.
-
: (sinal de dois pontos) para analisar o
VARIANT
usando uma expressão de caminho JSON. - try_variant_get função usando um caminho JSON para navegar em um tipo complexo com tolerância a erros.
-
função cast ou :: (sinal de dois pontos) operador para converter o
VARIANT
para um tipo específico. -
try_cast função para converter o
VARIANT
para um tipo específico com tolerância a erros.
- Para inspecionar o tipo de um
VARIANT
valor, use o botão- schema_of_variant função para um valor individual.
- schema_of_variant_agg função agregada para uma coleção de values.
Exemplos
> 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