번역된 페이지
이 페이지는 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(json_data, '$.region', 'Europe') as updated_object;
/* expected output...
|-----------------------------------------------------------|
| updated_object |
|-----------------------------------------------------------|
| {"name":"ResourceOne","type":"Storage","region":"Europe"} |
|-----------------------------------------------------------|
*/
이 쿼리는 'region' 키가 아직 없는 경우 값이 'Europe'인 'region'이라는 새 키를 JSON 문서에 삽입합니다. 'region'이 이미 문서의 키이면 원래 문서가 변경 없이 반환됩니다.