Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à :
SQL
Runtime 19 et supérieur
Retourne variantExpr avec val inséré ou défini à path, ou NULL pour des types intermédiaires incompatibles.
Syntax
try_variant_set ( variantExpr, path, val [, create_if_missing] )
Arguments
-
variantExpr: UneVARIANTexpression. -
path: UneSTRINGexpression avec une expression de chemin JSON bien formée. Les index des tableaux sont basés sur zéro. -
val: Une expression lancable àVARIANT. -
create_if_missing: Une expression constante optionnelle (pliableBOOLEAN). Sitrue, crée des champs, éléments de tableau et des objets ou tableaux intermédiaires manquants le longpathde . La valeur par défaut esttrue.
Returns
Valeur de type VARIANT.
Si create_if_missing est false, une cible ou un chemin intermédiaire manquant reste variantExpr inchangé.
Les arguments SQL NULL retournent SQL NULL.
La fonction retourne SQL NULL pour les types intermédiaires incompatibles. Pour générer une erreur à la place, utilisez variant_set.
Les trajectoires mal formées ou le chemin $ de racine 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
-- Replace an object field
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.a', 99)
{"a":99}
-- Incompatible path
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.a.b', 2)
NULL
-- Missing path with creation disabled
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.b', 2, false)
{"a":1}
-- Invalid root path
> SELECT try_variant_set(parse_json('{}'), '$', 1)
Error: INVALID_VARIANT_PATH.