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 à path.
Syntax
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é.
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.