try_variant_insert Funzione

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

Restituisce variantExpr inserito val in path, oppure NULL per campi oggetto duplicati o tipi intermedi incompatibili.

Syntax

try_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.

Gli argomenti SQL NULL restituiscono SQL NULL.

La funzione restituisce SQL NULL per campi oggetto duplicati o tipi intermedi incompatibili. Per generare un errore invece, usa 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 try_variant_insert(parse_json('{"a": 1}'), '$.b', 2)
  {"a":1,"b":2}

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

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

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