Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à :
SQL
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: UneVARIANTexpression. -
path: UneSTRINGexpression 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.