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
Renvoie variantExpr avec val inséré ou défini à path.
Syntax
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.
Le remplacement d’un élément du tableau ne déplace pas les autres éléments.
Si create_if_missing est true, les champs manquants et les conteneurs intermédiaires sont créés. Un index égal à la longueur du tableau ajoute val. Un index plus grand remplit le tableau avec des valeurs nulles variantes avant d’ajouter val.
Si create_if_missing est false, une cible ou un chemin intermédiaire manquant reste variantExpr inchangé.
Les arguments SQL NULL retournent SQL NULL.
Les types intermédiaires incompatibles font VARIANT_PATH_TYPE_MISMATCH, indépendamment de create_if_missing. Pour retourner SQL NULL à la place, utilisez try_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 variant_set(parse_json('{"a": 1}'), '$.a', 2)
{"a":2}
-- Create a missing path
> SELECT variant_set(parse_json('{}'), '$.a.b', 1)
{"a":{"b":1}}
-- Replace an array element
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[1]', 'z')
["a","z","c"]
-- Append at the array length
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[3]', 'z')
["a","b","c","z"]
-- Missing path with creation disabled
> SELECT variant_set(parse_json('{"a": 1}'), '$.b', 2, false)
{"a":1}
-- Incompatible path
> SELECT variant_set(parse_json('{"a": 1}'), '$.a.b', 2)
Error: VARIANT_PATH_TYPE_MISMATCH.