try_variant_array_append Funzione

Si applica a:spuntato sì Databricks SQL contrassegnato sì Databricks Runtime 19 e superiori

Restituisce variantExpr con val aggiunto all'array in path, oppure NULL se un valore intermedio ha un tipo incompatibile o se il target non è un array.

Syntax

try_variant_array_append ( variantExpr, path, val )

Arguments

  • variantExpr: Un'espressione VARIANT .
  • path: Un'espressione STRING con un'espressione di percorso JSON ben formata che specifica l'array target. Gli indici degli array sono basati su zero.
  • val: Un'espressione lancabile a VARIANT.

Returns

Valore di tipo VARIANT.

Un percorso mancante rimane variantExpr invariato.

Gli argomenti SQL NULL restituiscono SQL NULL.

La funzione restituisce SQL NULL per tipi intermedi incompatibili o per un target non di array. Per generare un errore invece, usa variant_array_append.

I percorsi malformati aumentano INVALID_VARIANT_PATH, e i risultati che superano il limite di dimensione della variante aumentano VARIANT_SIZE_LIMIT.

Condizioni di errore comuni

Examples

-- Append to a root array
> SELECT try_variant_array_append(parse_json('[1]'), '$', 2)
  [1,2]

-- Append to a nested array
> SELECT try_variant_array_append(parse_json('{"a": [1, 2]}'), '$.a', 3)
  {"a":[1,2,3]}

-- Non-array target
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.a', 2)
  NULL

-- Missing path
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.missing', 2)
  {"a":1}

-- Invalid path
> SELECT try_variant_array_append(parse_json('[]'), 'invalid', 1)
  Error: INVALID_VARIANT_PATH.