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_INSERT

Insere novos valores em um documento JSON nos caminhos especificados, sem sobrescrever os valores existentes.

Veja também:
[SELECT] [JSON_EXTRACT] [JSON_SET] [JSON_REPLACE]


Sintaxe​

SELECT JSON_INSERT(json_column, path, new_value) FROM <multipartIdentifier>;

Argumentos​

json_column
A coluna ou expressão JSON a ser modificada.

path
A expressão de caminho JSON em que o novo valor deve ser inserido. Se o caminho já existir, o valor original nesse caminho não é substituído.

new_value
O valor a ser inserido no caminho especificado do documento JSON.

Valor(es) retornado(s)​

Retorna o documento JSON com o novo valor inserido se o caminho especificado ainda não existir; caso contrário, retorna o documento JSON sem alterações.

Comportamento se uma chave existir
FunçãoSobrescreve se já existir?Cria se não existir?
json_insert()NãoSim
json_replace()SimNão
json_set()SimSim

Exemplos​

Inserir um novo par chave-valor em um objeto JSON​

-- Example: Insert a new 'region' key with the value 'Europe' into a JSON object
SELECT JSON_INSERT(json_data, '$.region', 'Europe') as updated_object;

/* expected output...
|-----------------------------------------------------------|
| updated_object |
|-----------------------------------------------------------|
| {"name":"ResourceOne","type":"Storage","region":"Europe"} |
|-----------------------------------------------------------|
*/

Esta consulta insere uma nova chave chamada 'region' com o valor 'Europe' no documento JSON se a chave 'region' ainda não existir. Se 'region' já for uma chave do documento, a consulta retorna o documento original sem alterações.