JSONExtractValueメソッドとJSONExtractLargeValueメソッドは、JSONインスタンスのエンティティ値のテキスト表現を取得します。JSONExtractLargeValueはJSONExtractValueと同じ入力パラメータを受け取り、同じ操作を実行しますが、戻り値の型とサイズが異なります。
これらのメソッドは、JSON_exprによって指定されるJSONオブジェクトを検索し、JSONPath_exprによって指定されるエンティティ名の値を取得します。エンティティ名は、JSONPath書式設定文字列によって表わされます。
JSONPath_exprには、ゼロのJSON項目または単一のJSON項目(スカラー値またはJSON null)を選択する必要があります。 複数の値がJSONPath_exprと一致する場合は、複数の結果が見つかったことを示す警告とエラー メッセージ文字列が返されます。
| 条件 | 戻り値 |
|---|---|
| JSONインスタンスでエンティティが見つかる。 | エンティティの値である文字列 |
| JSONPath_exprで指定されたクエリー式に一致する値が複数ある。 | 警告およびエラー メッセージ文字列"*** ERROR MULTI RESULT ***" |
| 結果は空の文字列。 | 空の文字列 |
| 結果はJSON null。 | Vantage NULL |
| JSONインスタンスでエンティティが見つからない。 | Vantage NULL |
| JSON_expr引数がnull。 | Vantage NULL |