Tipo VARIANT

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

Representa dados semiestruturados.

Sintaxe

VARIANT

Limites

O tipo suporta o armazenamento de dados OBJECTsemi-estruturados , ARRAY, 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 a criação de um valor VARIANT. 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, pode usar
  • variant_get função usando uma expressão de caminho JSON para navegar num tipo complexo.
  • : (sinal de dois pontos) operador para analisar o VARIANT usando uma expressão de caminho JSON.
  • try_variant_get função usando um caminho JSON para navegação em um tipo complexo tolerante a erros.
  • cast :: ou operador (sinal de dois pontos) 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 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" }

Relacionado

• :: (sinal de dois pontos) operador
• 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