본문 바로가기

[오라클 레퍼런스 함수] JSON_MERGEPATCH - JSON 문서 병합하여 수정

by ㅇㅍㅍ 2023. 8. 7.
[오라클 레퍼런스 함수] JSON_MERGEPATCH - JSON 문서 병합하여 수정
728x90

 

 

 

JSON_MERGEPATCH

 

구문

JSON_MERGEPATCH
   ( target_expr , patch_expr [ returning_clause ] [ PRETTY ] [ ASCII ] 
     [ TRUNCATE ] [ on_error_clause ] )

 

목적

JSON_MERGEPATCH는 JSON 문서를 수정하는 데 사용되는 표준 기능으로, 머지 패치(merge patch)라고 불리는 JSON 문서를 이용하여 대상 JSON 문서를 수정합니다. 이 함수는 RFC 7396에서 설명되어 있습니다.

target_expr은 대상 문서를 나타내는 JSON 값을 지정합니다.

patch_expr은 머지 패치 문서를 나타내는 JSON 값을 지정합니다.

JSON_MERGEPATCH는 머지 패치 문서를 대상 문서에 적용하여 결과 문서를 생성합니다. 대상 또는 머지 패치 문서가 NULL인 경우 결과도 NULL이 됩니다.

JSON_query_returning_clause는 연산자의 반환 유형을 지정합니다. 기본 반환 유형은 VARCHAR2(4000)입니다.

PRETTY 키워드는 결과를 사람이 읽기 쉽도록 서식화하도록 지정합니다.

ASCII 키워드는 non-ASCII 문자를 JSON 이스케이프 시퀀스(JSON escape sequences)를 사용하여 출력하도록 지정합니다.

TRUNCATE 키워드는 결과 문서를 지정된 반환 유형에 맞게 잘라내도록 지정합니다.

 

on_error_clause는 대상 문서와 패치 문서 처리 중 발생하는 오류를 선택적으로 제어합니다.

  • NULL ON ERROR - 오류가 발생하면 null을 반환합니다. 이것이 기본값입니다.
  • ERROR ON ERROR - 오류가 발생하면 해당하는 Oracle 오류를 반환합니다.

 

참고:

 


출처: 오라클 레퍼런스

원문 링크: Oracle JSON_MERGEPATCH 함수 문서

 

반응형

댓글