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 variantExpr eliminando los campos o elementos del array en las rutas especificadas.
Syntax
variant_delete ( 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 eliminar. Los índices de los arrays son basados en ceros.
Returns
Valor de tipo VARIANT.
Los trazados se aplican de izquierda a derecha al resultado de cada eliminación anterior. Eliminar un elemento de matriz desplaza los elementos posteriores hacia la izquierda.
Se ignoran los campos faltantes, índices fuera de rango y tipos intermedios incompatibles. Se conservan los objetos vacíos y los arrays.
Si variantExpr es SQL NULL, el resultado es SQL NULL. Las rutas SQL NULL se omiten.
Los trayectos malformados o el camino $ de raíz elevan INVALID_VARIANT_PATH.
Condiciones de error comunes
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}