Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.
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' уже є в документі, функція повертає початковий документ без змін.