# JSON_PATCH

> Застосування JSON MergePatch до документа JSON за допомогою SQL у StackQL для змінення або злиття об'єктів JSON.

Source: https://stackql.io/uk/language-spec/functions/json/json_patch

Застосовує JSON MergePatch (RFC-7396) до документа JSON і змінює його відповідно до вказаних операцій. Цю функцію використовують, щоб додавати, змінювати або видаляти елементи в об'єктах JSON, але масиви JSON вона обробляє як атомарні одиниці.

Див. також:  
[[`SELECT`]](/language-spec/select) [[` JSON_EXTRACT `]](/language-spec/functions/json/json_extract)

* * * 

## Синтаксис

```sql
SELECT JSON_PATCH(target_json, patch_json) FROM <multipartIdentifier>;
```

## Аргументи

__*target_json*__  
Документ JSON, до якого потрібно застосувати патч.

__*patch_json*__  
Документ JSON з описом змін, які потрібно застосувати за алгоритмом MergePatch.

## Значення, що повертається
Повертає змінений документ JSON після застосування патча.

* * *

## Приклади

### Простий MergePatch

```sql
-- Example: Simple merge of new elements into the target JSON object
SELECT JSON_PATCH('{"a":1,"b":2}', '{"c":3,"d":4}') AS patched_json;
```

Вивід: `{"a":1,"b":2,"c":3,"d":4}`

### Заміна масиву значенням

```sql
-- Example: Replacing an array with a single value in the JSON object
SELECT JSON_PATCH('{"a":[1,2],"b":2}', '{"a":9}') AS patched_json;
```

Вивід: `{"a":9,"b":2}`

### Видалення елемента за допомогою null

```sql
-- Example: Removing an element by setting it to null
SELECT JSON_PATCH('{"a":1,"b":2}', '{"a":9,"b":null,"c":8}') AS patched_json;
```

Вивід: `{"a":9,"c":8}`

### Вкладений MergePatch

```sql
-- Example: Nested merge patch updating sub-keys within a nested JSON object
SELECT JSON_PATCH('{"a":{"x":1,"y":2},"b":3}', '{"a":{"y":9},"c":8}') AS patched_json;
```

Вивід: `{"a":{"x":1,"y":9},"b":3,"c":8}`

Ця можливість дає змогу гнучко й динамічно оновлювати JSON, що зберігається в базі даних, і особливо корисна для застосунків, яким потрібні умовні зміни структур даних.
