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