跳至主要內容
翻譯頁面

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

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"} |
|-----------------------------------------------------------|
*/

如果 'region' 鍵尚不存在,此查詢會將名為 'region'、值為 'Europe' 的新鍵插入 JSON 文件。如果 'region' 已是文件中的鍵,則傳回未變更的原始文件。