본문으로 건너뛰기
번역된 페이지

이 페이지는 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'이 이미 문서의 키이면 원래 문서가 변경 없이 반환됩니다.