variant_array_append Funktion

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

Gibt variantExpr mit val an das Array angehängt bei pathzurück.

Syntax

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. val wird als ein Element angehängt, sodass das Anfügen eines Arrays ein verschachteltes Array erzeugt.

SQL-Argumente NULL geben SQL NULLzurück.

Inkompatible Zwischentypen oder ein Nicht-Array-Ziel erheben VARIANT_PATH_TYPE_MISMATCH. Um stattdessen SQL NULL zurückzugeben, verwenden Sie try_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 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.