翻譯頁面
本頁面由英文在 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'。