JSON_MERGEPATCH
目的
JSON_MERGEPATCH
は標準化された機能のひとつで、マージ・パッチと呼ばれるJSONドキュメントを使用してターゲットJSONドキュメントを変更します。この機能についてはRFC 7396で説明されています。
target_expr
は、JSON値のターゲット・ドキュメントに評価されます。
patch_expr
は、JSON値のパッチ・ドキュメントに評価されます。
JSON_MERGEPATCH
は、ターゲット・ドキュメントと照らしてパッチ・ドキュメントを評価し、その結果をドキュメントとして生成します。ターゲットまたはパッチ・ドキュメントがNULLの場合、結果もNULLです。
JSON_query_returning_clause
には、演算子の戻り型を指定します。デフォルトの戻り型はVARCHAR2(4000)
です。
PRETTY
キーワードは、結果を人が読める形式にするよう指定します。
ASCII
キーワードは、非ASCII文字を、JSONのエスケープ・シーケンスで出力することを指定します。
TRUNCATE
キーワードは、最終的なドキュメントを特定の戻り型に適するように切り捨てるよう指定します。
on_error_clause
(オプション)は、ターゲットおよびパッチ・ドキュメントの処理中に発生するエラーの扱い方を制御します。
NULL ON ERROR
- エラーが発生した場合にnullを戻します。これはデフォルトです。ERROR ON ERROR
- エラーが発生した場合に適切なOracleエラーを戻します。