try_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 en path, ou NULL si une valeur intermédiaire a un type incompatible ou si la cible n’est pas un tableau.

Syntax

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

Les arguments SQL NULL retournent SQL NULL.

La fonction retourne SQL NULL pour des types intermédiaires incompatibles ou une cible non-tableau. Pour générer une erreur à la place, utilisez 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 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.