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 les champs ou éléments du tableau situés sur les chemins spécifiés supprimés.
Syntax
variant_delete ( variantExpr, path1 [, path2, ...] )
Arguments
-
variantExpr: UneVARIANTexpression. -
path1,path2, ... : Une ou plusieursSTRINGexpressions avec des expressions de tracés JSON bien formées spécifiant les chemins à supprimer. Les index des tableaux sont basés sur zéro.
Returns
Valeur de type VARIANT.
Les tracés sont appliqués de gauche à droite au résultat de chaque suppression précédente. La suppression d’un élément de tableau déplace les éléments suivants vers la gauche.
Les champs manquants, les index hors plage et les types intermédiaires incompatibles sont ignorés. Les objets vides et les tableaux sont conservés.
Si variantExpr est SQL NULL, le résultat est SQL NULL. Les chemins SQL NULL sont sautés.
Les chemins mal formés ou le chemin $ de la racine relèvent INVALID_VARIANT_PATH.
Conditions d’erreur courantes
Examples
-- Remove object fields
> SELECT variant_delete(parse_json('{"a": 1, "b": 2, "c": 3}'), '$.a', '$.c')
{"b":2}
-- Remove an array element
> SELECT variant_delete(parse_json('[1, 2, 3]'), '$[1]')
[1,3]
-- Apply paths from left to right
> SELECT variant_delete(parse_json('[1, 2, 3]'), '$[0]', '$[0]')
[3]
-- Missing and incompatible paths
> SELECT variant_delete(parse_json('{"a": 1}'), '$.missing', '$.a.b')
{"a":1}
-- Preserve an empty object
> SELECT variant_delete(parse_json('{"a": {"b": 1}}'), '$.a.b')
{"a":{}}
-- Skip a SQL NULL path
> SELECT variant_delete(parse_json('{"a": 1, "b": 2}'), '$.a', CAST(NULL AS STRING))
{"b":2}