跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

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 文件中的 'status' 鍵更新為 'active'。如果文件中不存在 '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"} |
|-----------------------------------------------------------------------|
*/

如果 'lastChecked' 尚不存在,此查詢會將值為 '2024-04-29' 的新鍵 'lastChecked' 新增至 JSON 文件。如果已存在,則將現有值更新為 '2024-04-29'。