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.
| Função | Sobrescreve se já existir? | Cria se não existir? |
|---|---|---|
json_insert() | Não | Sim |
json_replace() | Sim | Não |
json_set() | Sim | Sim |
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.