variant_array_append Fonction

S’applique à :coché oui Databricks SQL coché oui Databricks Runtime 19 et supérieur

Renvoie variantExpr avec val ajouté au tableau à path.

Syntax

variant_array_append ( variantExpr, path, val )

Arguments

  • variantExpr: Une VARIANT expression.
  • path: Une STRING expression avec une expression de chemin JSON bien formée spécifiant le tableau cible. Les index des tableaux sont basés sur zéro.
  • val: Une expression lancable à VARIANT.

Returns

Valeur de type VARIANT.

Un chemin manquant reste variantExpr inchangé. val est ajouté comme un seul élément, donc ajouter un tableau crée un tableau imbriqué.

Les arguments SQL NULL retournent SQL NULL.

Types intermédiaires incompatibles ou une hausse cible non matricielle VARIANT_PATH_TYPE_MISMATCH. Pour retourner SQL NULL à la place, utilisez try_variant_array_append.

Les trajectoires mal formées augmentent INVALID_VARIANT_PATH, et les résultats dépassant la limite de taille de la variante augmentent VARIANT_SIZE_LIMIT.

Conditions d’erreur courantes

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.