variant_pick Fonction

S’applique à :coché oui Databricks SQL coché oui Databricks Runtime 19 et supérieur

Renvoie un VARIANT contenant uniquement les champs et éléments du tableau sélectionnés variantExpr par les chemins spécifiés.

Syntax

variant_pick ( variantExpr, path1 [, path2, ...] )

Arguments

  • variantExpr: Une VARIANT expression.
  • path1, path2, ... : Une ou plusieurs STRING expressions avec des expressions de chemin JSON bien formées spécifiant les chemins à conserver. Les index des tableaux sont basés sur zéro.

Returns

Valeur de type VARIANT.

Les champs et éléments sélectionnés conservent leur structure parente. Les tableaux ne contiennent que des éléments sélectionnés, dans leur ordre d’origine.

L’ordre des tracés et les doublons n’affectent pas le résultat. Le choix d’un parent inclut tous ses enfants. Le tracé $ racine sélectionne la valeur entière.

Les champs manquants, les index hors plage et les types intermédiaires incompatibles sont ignorés. Sans correspondances, les entrées d’objet et de tableau retournent {} respectivement et []. Les scalaires et les nulls variants restent inchangés.

Si variantExpr est SQL NULL, le résultat est SQL NULL. Les chemins SQL NULL sont sautés.

Des trajectoires mal formées INVALID_VARIANT_PATH.

Conditions d’erreur courantes

Examples

-- Select object fields
> SELECT variant_pick(parse_json('{"a": 1, "b": 2, "c": 3}'), '$.a', '$.c')
  {"a":1,"c":3}

-- Select a nested field
> SELECT variant_pick(parse_json('{"a": {"b": 1, "c": 2}, "d": 3}'), '$.a.b')
  {"a":{"b":1}}

-- Preserve array order and ignore duplicate paths
> SELECT variant_pick(parse_json('[10, 20, 30, 40]'), '$[2]', '$[0]', '$[2]')
  [10,30]

-- Overlapping paths
> SELECT variant_pick(parse_json('{"a": {"b": 1, "c": 2}}'), '$.a.b', '$.a')
  {"a":{"b":1,"c":2}}

-- Missing path
> SELECT variant_pick(parse_json('{"a": {"b": 1}}'), '$.a.missing')
  {}

-- Skip a SQL NULL path
> SELECT variant_pick(parse_json('{"a": 1, "b": 2}'), '$.a', CAST(NULL AS STRING))
  {"a":1}