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_SET

Atualiza valores existentes ou insere novos valores em um documento JSON nos caminhos especificados.

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


Sintaxe​

SELECT JSON_SET(json_column, path, value_to_set) FROM <multipartIdentifier>;

Argumentos​

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

path
A expressão de caminho JSON que indica onde definir o valor. Se o caminho existir, a função atualiza o valor; se o caminho não existir, a função adiciona um novo par chave-valor.

value_to_set
O valor a ser definido no caminho especificado do documento JSON.

Valor(es) retornado(s)​

Retorna um documento JSON com o valor definido no caminho especificado. Se o caminho existir, a função atualiza o valor existente; caso contrário, adiciona um novo par chave-valor.

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

Exemplos​

Atualizar um valor existente em um objeto JSON​

-- Example: Update the 'status' key's value to 'active' in a JSON object
SELECT JSON_SET(json_data, '$.status', 'active') as updated_json
FROM cloud_services
WHERE service_id = 'service123';

-- Expected output:
-- |---------------------------------------------------------|
-- | updated_json |
-- |---------------------------------------------------------|
-- | {"name":"ServiceOne", "status":"active", "region":"US"} |
-- |---------------------------------------------------------|

Esta consulta atualiza a chave 'status' para 'active' no documento JSON se a chave 'status' existir. Se 'status' não existir no documento, a consulta a adiciona com o valor 'active'.

Adicionar um novo par chave-valor a um objeto JSON​

-- Example: Add a new key 'lastChecked' with the current date to a JSON object
SELECT JSON_SET(json_data, '$.lastChecked', '2024-04-29') as updated_json
FROM cloud_services
WHERE service_id = 'service123';

/* expected output...
|-----------------------------------------------------------------------|
| updated_json |
|-----------------------------------------------------------------------|
| {"name":"ServiceOne", "status":"pending", "lastChecked":"2024-04-29"} |
|-----------------------------------------------------------------------|
*/

Esta consulta adiciona uma nova chave 'lastChecked' com o valor '2024-04-29' ao documento JSON se 'lastChecked' ainda não existir. Se existir, a consulta atualiza o valor existente para '2024-04-29'.