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

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

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