variant_delete Fonction

S’applique à :coché oui Databricks SQL coché oui Databricks 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: Une VARIANT expression.
  • path1, path2, ... : Une ou plusieurs STRING expressions 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}