Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.
JSON_REMOVE
Remove os elementos especificados de um documento JSON usando expressões de caminho. Se um caminho especificado não existir no documento, ele é ignorado. O processamento sequencial dos caminhos pode afetar a estrutura para as remoções seguintes.
Veja também:
[SELECT] [JSON_EXTRACT]
Sintaxe
SELECT JSON_REMOVE(json_document, path1, path2, ...) FROM <multipartIdentifier>;
Argumentos
json_document
O documento JSON do qual os elementos serão removidos.
path1, path2, ...
Uma ou mais expressões de caminho que apontam para os elementos do documento JSON a serem removidos.
Valor(es) retornado(s)
Retorna uma cópia do documento JSON sem os elementos especificados. Se nenhum caminho for informado, retorna o JSON de entrada reformatado, sem o espaço em branco excedente.
Exemplos
Remover um elemento de um array JSON
-- Example: Remove the third element from a JSON array
SELECT JSON_REMOVE('[0,1,2,3,4]', '$[2]') AS modified_json;
Saída: '[0,1,3,4]'
Remover vários elementos de um array JSON
-- Example: Remove the first and third elements from a JSON array
SELECT JSON_REMOVE('[0,1,2,3,4]', '$[2]', '$[0]') AS modified_json;
Saída: '[1,3,4]'
Remover o último elemento usando um índice negativo
-- Example: Remove the last and first elements from a JSON array
SELECT JSON_REMOVE('[0,1,2,3,4]', '$[#-1]', '$[0]') AS modified_json;
Saída: '[1,2,3]'
Remover um caminho inexistente
-- Example: Attempt to remove a non-existent key from a JSON object
SELECT JSON_REMOVE('{"x":25,"y":42}', '$.z') AS modified_json;
Saída: '{"x":25,"y":42}'
Remover uma chave existente de um objeto JSON
-- Example: Remove the 'y' key from a JSON object
SELECT JSON_REMOVE('{"x":25,"y":42}', '$.y') AS modified_json;
Saída: '{"x":25}'
Caso limite: remoção com o caminho raiz
-- Example: Attempt to remove using the root path
SELECT JSON_REMOVE('{"x":25,"y":42}', '$') AS modified_json;
Saída: NULL
Estes exemplos mostram como usar json_remove() para manipular dados JSON dinamicamente, em vários cenários, de exclusões simples ao tratamento de casos limite em modificações de estruturas de dados.