Перейти до основного вмісту
Перекладена сторінка

Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.

JSON_INSERT

Вставляє нові значення в документ JSON за вказаними шляхами без перезапису наявних значень.

Див. також:
[SELECT] [JSON_EXTRACT] [JSON_SET] [JSON_REPLACE]


Синтаксис​

SELECT JSON_INSERT(json_column, path, new_value) FROM <multipartIdentifier>;

Аргументи​

json_column
Стовпець або вираз JSON, який потрібно змінити.

path
Вираз шляху JSON, за яким потрібно вставити нове значення. Якщо шлях уже існує, початкове значення за цим шляхом не замінюється.

new_value
Значення, яке потрібно вставити за вказаним шляхом у документі JSON.

Значення, що повертається​

Повертає документ JSON зі вставленим новим значенням, якщо вказаного шляху ще немає; інакше функція повертає документ JSON без змін.

Поведінка, якщо ключ уже існує
ФункціяПерезаписати, якщо вже існує?Створити, якщо не існує?
json_insert()НіТак
json_replace()ТакНі
json_set()ТакТак

Приклади​

Вставлення нової пари "ключ-значення" в об'єкт JSON​

-- Example: Insert a new 'region' key with the value 'Europe' into a JSON object
SELECT JSON_INSERT('{"name":"ResourceOne","type":"Storage"}', '$.region', 'Europe') as updated_object;

/* expected output...
|-----------------------------------------------------------|
| updated_object |
|-----------------------------------------------------------|
| {"name":"ResourceOne","type":"Storage","region":"Europe"} |
|-----------------------------------------------------------|
*/

Цей запит вставляє в документ JSON новий ключ 'region' зі значенням 'Europe', якщо ключа 'region' ще немає. Якщо ключ 'region' уже є в документі, функція повертає початковий документ без змін.