# JSON_SET

> Atualizar ou inserir valores em um documento JSON com SQL no StackQL.

Source: https://stackql.io/pt-br/language-spec/functions/json/json_set

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

Veja também:  
[[`SELECT`]](/language-spec/select) [[` JSON_EXTRACT `]](/language-spec/functions/json/json_extract) [[` JSON_SET `]](/language-spec/functions/json/json_set) [[` JSON_REPLACE `]](/language-spec/functions/json/json_replace)

* * * 

## Sintaxe

```sql
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.

:::note Comportamento se uma chave existir

| Função                                                       | Sobrescrever se já existir? | Criar se não existir? |
|--------------------------------------------------------------|-----------------------------|-----------------------|
| [`json_insert()`](/language-spec/functions/json/json_insert) | Não                         | Sim                   |
| [`json_replace()`](/language-spec/functions/json/json_replace) | Sim                         | Não                   |
| [`json_set()`](/language-spec/functions/json/json_set)       | Sim                         | Sim                   |

:::

* * *

## Exemplos

### Atualizar um valor existente em um objeto JSON

```sql
-- 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

```sql
-- 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'.
