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 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: UneVARIANTexpression. -
path1,path2, ... : Une ou plusieursSTRINGexpressions 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}