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 inséré comme champ ou élément de tableau en path.
Syntax
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.
L’insertion de tableau déplace les éléments suivants vers la droite. Un index égal à la longueur du tableau ajoute val. Un index plus grand remplit le tableau avec des valeurs nulles variantes avant l’insertion.
Les objets intermédiaires manquants ou les tableaux sont créés selon le segment de tracé suivant.
Les arguments SQL NULL retournent SQL NULL.
Les champs d’objet dupliqués font VARIANT_DUPLICATE_KEY. Les types intermédiaires incompatibles font VARIANT_PATH_TYPE_MISMATCH. Pour retourner SQL NULL à la place, utilisez try_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 variant_insert(parse_json('{"a": 1}'), '$.b', 2)
{"a":1,"b":2}
-- Create a missing path
> SELECT variant_insert(parse_json('{}'), '$.a[0]', 1)
{"a":[1]}
-- Insert an array element
> SELECT variant_insert(parse_json('["a", "b", "c"]'), '$[1]', 'z')
["a","z","b","c"]
-- Pad an array with variant nulls
> SELECT variant_insert(parse_json('["a", "b"]'), '$[5]', 'z')
["a","b",null,null,null,"z"]
-- Insert a variant null
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', parse_json('null'))
{"a":1,"b":null}
-- SQL NULL argument
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', CAST(NULL AS VARIANT))
NULL
-- Duplicate object field
> SELECT variant_insert(parse_json('{"a": 1}'), '$.a', 2)
Error: VARIANT_DUPLICATE_KEY.