TO_APPROX_PERCENTILE

構文

目的

TO_APPROX_PERCENTILEでは、その入力として、近似パーセンタイル情報を含む詳細、パーセンタイル値およびソート指定を取得し、そのソート指定に従ってそのパーセンタイル値に該当する近似値を戻します。

detailには、APPROX_PERCENTILE_DETAILファンクションまたはAPPROX_PERCENTLE_AGGファンクションで作成されたBLOB型の詳細を指定します。

exprには、0から1までの数値と評価されるパーセンタイル値を指定します。ERROR_RATE句またはCONFIDENCE句を指定した場合、パーセンタイル値は適用されません。この場合、exprには、NULLまたは0から1までの数値を指定する必要があります。ただし、値は無視されます。

datatypeには、詳細の近似パーセンタイル情報のデータ型を指定します。これは、詳細を生成したAPPROX_PERCENTILE_DETAILファンクションに指定した式のデータ型です。有効なデータ型は、NUMBER、BINARY_FLOAT、BINARY_DOUBLE、DATE、TIMESTAMP、INTERVAL YEAR TO MONTHおよびINTERVAL DAY TO SECONDです。

DESC | ASC

補間のためにソート指定を指定します。降順のソート順の場合はDESC、昇順のソート順の場合はASCを指定します。デフォルトはASCです。

ERROR_RATE | CONFIDENCE

これらの句により、詳細のパーセンタイル評価の精度を確認できます。これらの句のいずれかを指定すると、おおよその補間された値が戻されるかわりに、次のいずれかの値を表す0から1までの小数値(それらの値を含む)が戻されます。

ERROR_RATEを指定すると、戻り値は、詳細のパーセンタイル評価のエラー率を表します。
CONFIDENCEを指定すると、戻り値は、ERROR_RATEを指定したときに戻されるエラー率の信頼水準を表します。

ERROR_RATEまたはCONFIDENCEを指定した場合、パーセンタイル値exprは無視されます。