try_variant_set Função

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

Retorna variantExpr com val inserido ou definido em path, ou NULL para tipos intermediários incompatíveis.

Sintaxe

try_variant_set ( variantExpr, path, val [, create_if_missing] )

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.
  • create_if_missing: Uma expressão constante opcional (dobrável BOOLEAN ). Se true, cria campos ausentes, elementos de array e objetos ou arrays intermediários ao longo pathde . O padrão é true.

Returns

Um valor do tipo VARIANT.

Se create_if_missing for false, um alvo ausente ou um caminho intermediário permanece variantExpr inalterado.

Argumentos SQL NULL retornam SQL NULL.

A função retorna SQL NULL para tipos intermediários incompatíveis. Para gerar um erro em vez disso, use variant_set.

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

-- Replace an object field
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.a', 99)
  {"a":99}

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

-- Missing path with creation disabled
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.b', 2, false)
  {"a":1}

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