JSON_SERIALIZE
構文
目的
json_serializeは、任意のSQLデータ型(JSON、VARCHAR2、CLOBまたはBLOB)のJSONデータを入力として使用し、そのテキスト表現を返します。通常は、問合せの結果を変換するために使用します。
json_serializeを使用すると、バイナリのJSONデータをテキスト形式(CLOBまたはVARCHAR2)に変換することや、フォーマット出力やASCII Unicode以外の文字のエスケープによってテキストのJSONデータを変換することができます。
expr
exprは入力式です。JSON、VARCHAR2、CLOBまたはBLOBのいずれかの型になります。
JSON_returning_clause::=
JSON_returning_clauseを使用すると、ファンクションの戻り型を指定できます。VARCHAR2、CLOB、BLOBまたはJSONのいずれか。
デフォルトの戻り型はBLOBです。
戻り型がRAWまたはBLOBの場合は、UTF8エンコードしたJSONテキストが含まれます。
PRETTY
結果を読みやすい形式にする場合は、PRETTYを指定します。
ASCII
JSONエスケープ・シーケンスを使用して非ASCII文字を出力する場合は、ASCIIを指定します。
TRUNCATE
結果ドキュメントのテキスト出力を、指定した戻り型のバッファに収める場合はTRUNCATEを指定します。
JSON_on_error_clause::=
JSON_on_error_clauseを指定すると、処理エラーの処理を制御できます。
NULL ON ERRORがデフォルトです。
EMPTY ON ERRORはサポートされません。
JSON_on_error_clauseでTRUNCATEを指定すると、戻り型の値が大きすぎてバッファに収まらない場合は、エラーが発生するかわりに切り捨てられます。
例
SELECT JSON_SERIALIZE ('{a:[1,2,3,4]}' RETURNING VARCHAR2(3) TRUNCATE ERROR ON ERROR) from dual
–-------
{"a