Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Se aplica a:
SQL
Runtime 19 y superior
Devuelve una VARIANT que contiene únicamente los campos y elementos del array seleccionados variantExpr por las rutas especificadas.
Syntax
variant_pick ( variantExpr, path1 [, path2, ...] )
Argumentos
-
variantExpr: UnaVARIANTexpresión. -
path1,path2, ...: Una o másSTRINGexpresiones con expresiones de ruta JSON bien formadas que especifican las rutas a conservar. Los índices de los arrays son basados en ceros.
Returns
Valor de tipo VARIANT.
Los campos y elementos seleccionados conservan su estructura principal. Los arrays contienen únicamente elementos seleccionados, en su orden original.
El orden de la ruta y los duplicados no afectan al resultado. Seleccionar un progenitor incluye a todos sus hijos. La ruta $ raíz selecciona el valor completo.
Se ignoran los campos faltantes, índices fuera de rango y tipos intermedios incompatibles. Sin coincidencias, las entradas de objeto y matriz devuelven {} y [], respectivamente. Los escalares y los nulos variantes permanecen sin cambios.
Si variantExpr es SQL NULL, el resultado es SQL NULL. Las rutas SQL NULL se omiten.
Los caminos deformados elevan INVALID_VARIANT_PATH.
Condiciones de error comunes
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}