Pular para o conteúdo principal
Página traduzida

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.