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.

Syntax

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. val viene aggiunto come un singolo elemento, quindi aggiungere un array crea un array annidato.

Gli argomenti SQL NULL restituiscono SQL NULL.

Tipi intermedi incompatibili o un target non array aumentano VARIANT_PATH_TYPE_MISMATCH. Per restituire SQL NULL invece, usa try_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 variant_array_append(parse_json('[1, 2, 3]'), '$', 4)
  [1,2,3,4]

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

-- Append an array as a single element
> SELECT variant_array_append(parse_json('[1]'), '$', parse_json('[2, 3]'))
  [1,[2,3]]

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

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