Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:
SQL
Runtime 19 e superior
Retorna variantExpr com os campos ou elementos do array nos caminhos especificados removidos.
Sintaxe
variant_delete ( variantExpr, path1 [, path2, ...] )
Arguments
-
variantExpr: UmaVARIANTexpressão. -
path1,path2, ...: Uma ou maisSTRINGexpressões com expressões de caminho JSON bem formadas especificando os caminhos a serem removidos. Os índices de array são baseados em zero.
Returns
Um valor do tipo VARIANT.
Os caminhos são aplicados da esquerda para a direita ao resultado de cada exclusão anterior. Excluir um elemento de array desloca os elementos subsequentes para a esquerda.
Campos ausentes, índices fora de faixa e tipos intermediários incompatíveis são ignorados. Objetos e arrays vazios são preservados.
Se variantExpr for SQL NULL, o resultado é SQL NULL. Caminhos SQL NULL são pulados.
Caminhos malformados ou o caminho $ da raiz elevam INVALID_VARIANT_PATH.
Condições de erro comuns
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}