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àm | Ghi đè nếu đã tồn tại? | Tạo nếu chưa tồn tại? |
|---|---|---|
json_insert() | Không | Có |
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.