try_variant_array_append Funktion

Gilt für:Angekreuzt ja, Databricks, SQL, angekreuzt ja, Databricks, Laufzeit 19 und höher.

Gibt variantExpr mit val angehängtem Array bei path, oder NULL wenn ein Zwischenwert einen inkompatiblen Typ hat oder das Ziel kein Array ist.

Syntax

try_variant_array_append ( variantExpr, path, val )

Argumente

  • variantExpr: Ein VARIANT Ausdruck.
  • path: Ein Ausdruck mit einem wohlgeformten JSON-Pfadausdruck, der STRING das Ziel-Array angibt. Array-Indizes sind nullbasiert.
  • val: Ein Ausdruck, der auf gewirkt werden VARIANTkann.

Returns

Ein Wert vom Typ VARIANT.

Ein fehlender Weg bleibt variantExpr unverändert.

SQL-Argumente NULL geben SQL NULLzurück.

Die Funktion gibt SQL NULL für inkompatible Zwischentypen oder ein Nicht-Array-Ziel zurück. Um stattdessen einen Fehler auszulösen, verwenden Sie variant_array_append.

Fehlgeformte Pfade erhöhen INVALID_VARIANT_PATH, und Ergebnisse, die das Variantengrößenlimit überschreiten, steigen VARIANT_SIZE_LIMIT.

Häufige Fehlerbedingungen

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.