try_variant_insert Função

Aplica-se a:marcado sim Databricks SQL marcado sim Databricks Runtime 19 e superior

Retorna variantExpr com val inserido em path, ou NULL para campos de objeto duplicados ou tipos intermediários incompatíveis.

Sintaxe

try_variant_insert ( variantExpr, path, val )

Arguments

  • variantExpr: Uma VARIANT expressão.
  • path: Uma STRING expressão com uma expressão de caminho JSON bem formada. Os índices de array são baseados em zero.
  • val: Uma expressão conjectável para VARIANT.

Returns

Um valor do tipo VARIANT.

Argumentos SQL NULL retornam SQL NULL.

A função retorna SQL NULL para campos de objeto duplicados ou tipos intermediários incompatíveis. Para gerar um erro em vez disso, use variant_insert.

Caminhos malformados ou o caminho $ da raiz aumentam INVALID_VARIANT_PATH, e resultados que excedem o limite de tamanho da variante aumentam VARIANT_SIZE_LIMIT.

Condições de erro comuns

Examples

-- Insert an object field
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.b', 2)
  {"a":1,"b":2}

-- Duplicate object field
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.a', 2)
  NULL

-- Incompatible path
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.a.b', 2)
  NULL

-- Invalid root path
> SELECT try_variant_insert(parse_json('{}'), '$', 1)
  Error: INVALID_VARIANT_PATH.