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é à path, ou NULL pour des champs d’objet dupliqués ou des types intermédiaires incompatibles.
Syntax
try_variant_insert ( variantExpr, path, val )
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.
Returns
Valeur de type VARIANT.
Les arguments SQL NULL retournent SQL NULL.
La fonction retourne SQL NULL pour les champs d’objets dupliqués ou les types intermédiaires incompatibles. Pour générer une erreur à la place, utilisez variant_insert.
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
-- Insert an object field
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.b', 2)
{"a":1,"b":2}
-- Duplicate object field
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.a', 2)
NULL
-- Incompatible path
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.a.b', 2)
NULL
-- Invalid root path
> SELECT try_variant_insert(parse_json('{}'), '$', 1)
Error: INVALID_VARIANT_PATH.