Tipo de VARIANT

Aplica-se a: Databricks SQL Databricks Runtime 15.3 e versões superiores

Representa dados semiestruturados.

Sintaxe

VARIANT

limites

O tipo dá suporte ao armazenamento de dados OBJECTARRAYsemiestruturados e tipos escalares. Para armazenar STRUCT e MAP usar a função to_variant_object . MAP as chaves devem ser do tipo STRING.

Literais

Consulte a função parse_json para obter detalhes sobre como criar um valor VARIANT. Você também pode usar a função CAST para converter um literal de algum tipo em VARIANT.

Observações

• Para extrair um valor de um VARIANT, você pode usar a
  • variant_get função usando uma expressão de caminho JSON para navegar em um tipo complexo.
  • : operador (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.
  • cast função ou operador :: (sinal de dois pontos) para converter o VARIANT em um tipo específico.
  • try_cast função para fazer o VARIANT corresponder a um tipo específico com tolerância a erros.
• Para inspecionar o tipo de um valor VARIANT, use a
  • schema_of_variant função para um valor individual.
  • schema_of_variant_agg função de agregação para uma coleção de valores.

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

> SELECT to_variant_object(map('key', 'val'));
  { "key": "val" }

> SELECT to_variant_object(struct('field', 'val'));
  { "field": "val" }

Relacionados

• :: operador (sinal de dois pontos)
• cast função
• parse_json função
• schema_of_variant função
• schema_of_variant_agg função de agregação
• try_cast função
• try_variant_get função
• variant_get função