翻譯頁面
本頁面由英文在 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' 已是文件中的鍵,則傳回未變更的原始文件。