Chuyển tới nội dung chính
Trang được dịch

Trang này được dịch từ tiếng Anh với sự hỗ trợ của AI. Nếu hai bản có chỗ khác nhau, hãy lấy phiên bản tiếng Anh làm chuẩn.

JSON_INSERT

Chèn giá trị mới vào tài liệu JSON tại các đường dẫn được chỉ định mà không ghi đè các giá trị hiện có.

Xem thêm:
[SELECT] [JSON_EXTRACT] [JSON_SET] [JSON_REPLACE]


Cú pháp​

SELECT JSON_INSERT(json_column, path, new_value) FROM <multipartIdentifier>;

Đối số​

json_column
Cột hoặc biểu thức JSON cần sửa đổi.

path
Biểu thức đường dẫn JSON chỉ vị trí cần chèn giá trị mới. Nếu đường dẫn đã tồn tại, giá trị ban đầu tại đường dẫn đó không được thay thế.

new_value
Giá trị cần chèn tại đường dẫn được chỉ định trong tài liệu JSON.

Giá trị trả về​

Trả về tài liệu JSON đã được chèn giá trị mới nếu đường dẫn được chỉ định chưa tồn tại; nếu không, hàm trả về tài liệu JSON không thay đổi.

Hành vi khi khóa đã tồn tại
HàmGhi đè nếu đã tồn tại?Tạo nếu chưa tồn tại?
json_insert()KhôngCó
json_replace()CóKhông
json_set()CóCó

Ví dụ​

Chèn một cặp khóa-giá trị mới vào đối tượng 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"} |
|-----------------------------------------------------------|
*/

Truy vấn này chèn một khóa mới tên là 'region' với giá trị 'Europe' vào tài liệu JSON nếu khóa 'region' chưa tồn tại. Nếu 'region' đã là một khóa trong tài liệu, truy vấn trả về tài liệu ban đầu mà không thay đổi.