Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.
JSON_SET
Оновлює наявні значення або вставляє нові значення в документ JSON за вказаними шляхами.
Див. також:
[SELECT] [JSON_EXTRACT] [JSON_INSERT] [JSON_REPLACE]
Синтаксис
SELECT JSON_SET(json_column, path, value_to_set) FROM <multipartIdentifier>;
Аргументи
json_column
Стовпець або вираз JSON, який потрібно змінити.
path
Вираз шляху JSON, що вказує, де встановити значення. Якщо шлях існує, значення оновлюється; якщо шляху не існує, додається нова пара "ключ-значення".
value_to_set
Значення, яке потрібно встановити за вказаним шляхом у документі JSON.
Значення, що повертається
Повертає документ JSON зі значенням, встановленим за вказаним шляхом. Якщо шлях існує, наявне значення оновлюється; інакше додається нова пара "ключ-значення".
| Функція | Перезаписати, якщо вже існує? | Створити, якщо не існує? |
|---|---|---|
json_insert() | Ні | Так |
json_replace() | Так | Ні |
json_set() | Так | Так |
Приклади
Оновлення наявного значення в об'єкті JSON
-- Example: Update the 'status' key's value to 'active' in a JSON object
SELECT JSON_SET('{"name":"ServiceOne","status":"pending","region":"US"}', '$.status', 'active') as updated_json;
-- Expected output:
-- |---------------------------------------------------------|
-- | updated_json |
-- |---------------------------------------------------------|
-- | {"name":"ServiceOne","status":"active","region":"US"} |
-- |---------------------------------------------------------|
Цей запит змінює значення ключа 'status' у документі JSON на 'active', якщо ключ 'status' існує. Якщо ключа 'status' у документі немає, його буде додано зі значенням 'active'.
Додавання нової пари "ключ-значення" до об'єкта JSON
-- Example: Add a new key 'lastChecked' with a date value to a JSON object
SELECT JSON_SET('{"name":"ServiceOne","status":"pending"}', '$.lastChecked', '2024-04-29') as updated_json;
/* expected output...
|-----------------------------------------------------------------------|
| updated_json |
|-----------------------------------------------------------------------|
| {"name":"ServiceOne","status":"pending","lastChecked":"2024-04-29"} |
|-----------------------------------------------------------------------|
*/
Цей запит додає до документа JSON новий ключ 'lastChecked' зі значенням '2024-04-29', якщо ключа 'lastChecked' ще немає. Якщо він уже є, наявне значення буде оновлено до '2024-04-29'.