variant_set Funzione

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

Restituisce variantExpr con val inserito o impostato in path.

Syntax

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

Arguments

  • variantExpr: Un'espressione VARIANT .
  • path: Un'espressione STRING con un'espressione di percorso JSON ben formata. Gli indici degli array sono basati su zero.
  • val: Un'espressione lancabile a VARIANT.
  • create_if_missing: Un'espressione costante opzionale (pieghevole BOOLEAN ). Se true, crea campi mancanti, elementi di array e oggetti o array intermedi lungo path. Il valore predefinito è true.

Returns

Valore di tipo VARIANT.

La sostituzione di un elemento dell'array non sposta gli altri elementi.

Se create_if_missing è true, vengono creati campi mancanti e contenitori intermedi. Un indice pari alla lunghezza dell'array aggiunge val. Un indice più grande riempie l'array con valori null varianti prima di aggiungere val.

Se create_if_missing è false, un bersaglio o un percorso intermedio mancante rimane variantExpr invariato.

Gli argomenti SQL NULL restituiscono SQL NULL.

I tipi intermedi incompatibili sollevano VARIANT_PATH_TYPE_MISMATCH, indipendentemente da create_if_missing. Per restituire NULL SQL invece, usa try_variant_set.

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

Condizioni di errore comuni

Examples

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

-- Create a missing path
> SELECT variant_set(parse_json('{}'), '$.a.b', 1)
  {"a":{"b":1}}

-- Replace an array element
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[1]', 'z')
  ["a","z","c"]

-- Append at the array length
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[3]', 'z')
  ["a","b","c","z"]

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

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