JSON_SCALAR

構文

目的

JSON_SCALARは、SQLスカラー値を入力として受け入れ、対応するJSONスカラー値をJSON型のインスタンスとして返します。値は、JSON標準に含まれていない、Oracle固有のJSON言語型にできます(日付など)。

JSON_SCALARを使用するには、データベース初期化パラメータcompatibleを少なくとも20に設定する必要があります。それ以外の場合、エラーが発生します。

JSON_SCALARの引数は、SQLデータ型BINARY_DOUBLE、BINARY_FLOAT、BLOB、CLOB、DATE、INTERVAL YEAR TO MONTH、INTERVAL DAY TO SECOND、JSON、NUMBER、RAW、TIMESTAMP、VARCHAR、VARCHAR2、VECTORのいずれかのインスタンスにできます。

返されるJSON型インスタンスは、OracleでサポートされるJSON言語スカラー値です。

JSON_SCALARの引数がSQL NULL値である場合は、次のように戻り値を取得できます:

SQL NULL (デフォルトの動作)
JSON null (キーワードNULL ON NULLを使用)
空のJSON文字列" " (キーワードEMPTY STRING ON NULLを使用)

SQL NULLを返すデフォルトの動作は、JSONスカラー値が返されるルールの唯一の例外です。