variant_insert Funzione

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

Restituisce variantExpr con val inserito come campo o elemento di array in path.

Syntax

variant_insert ( variantExpr, path, val )

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.

Returns

Valore di tipo VARIANT.

L'inserimento dell'array sposta gli elementi successivi verso destra. Un indice pari alla lunghezza dell'array aggiunge val. Un indice più grande riempie l'array con valori nulli varianti prima dell'inserimento.

Gli oggetti o array intermedi mancanti vengono creati in base al segmento di tracciato successivo.

Gli argomenti SQL NULL restituiscono SQL NULL.

I campi oggetto duplicati sollevano VARIANT_DUPLICATE_KEY. I tipi intermedi incompatibili sollevano VARIANT_PATH_TYPE_MISMATCH. Per restituire SQL NULL invece, usa try_variant_insert.

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

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

-- Create a missing path
> SELECT variant_insert(parse_json('{}'), '$.a[0]', 1)
  {"a":[1]}

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

-- Pad an array with variant nulls
> SELECT variant_insert(parse_json('["a", "b"]'), '$[5]', 'z')
  ["a","b",null,null,null,"z"]

-- Insert a variant null
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', parse_json('null'))
  {"a":1,"b":null}

-- SQL NULL argument
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', CAST(NULL AS VARIANT))
  NULL

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