メニュー
Amazon Redshift
データベース開発者ガイド (API Version 2012-12-01)

PERCENTILE_CONT 関数

PERCENTILE_CONT は、連続型分散モデルを前提とする逆分散関数です。これは、パーセンタイル値とソート仕様を取得し、ソート仕様を基準として、そのパーセンタイル値に該当する補間値を返します。

PERCENTILE_CONT は、値の順序付けを行った後に値の間の線形補間を計算します。この関数は、パーセンタイル値 (P) と集計グループの Null ではない行の数 (N) を使用して、ソート使用に従って行の順序付けを行った後に行番号を計算します。この行番号 (RN) は、計算式 RN = (1+ (P*(N-1)) に従って計算されます。集計関数の最終結果は、行番号 CRN = CEILING(RN) および FRN = FLOOR(RN) にある行の値の間の線形補間に基づいて計算されます。

最終結果は次のとおりです。

(CRN = FRN = RN) である場合、結果は (value of expression from row at RN)

そうでない場合、結果は

(CRN - RN) * (value of expression for row at FRN) + (RN - FRN) * (value of expression for row at CRN).

構文

Copy
PERCENTILE_CONT ( percentile ) WITHIN GROUP (ORDER BY expr)

引数

percentile

0 と 1 の間の数値定数。Null は計算では無視されます。

WITHIN GROUP ( ORDER BY expr)

パーセンタイルをソートして計算するための数値または日付/時間値を指定します。

戻り値

戻り型は、WITHIN GROUP 句の ORDER BY 式のデータ型に基づいて決定されます。次の表は、各 ORDER BY 式のデータ型に対応する戻り型を示しています。

入力の型 戻り型
INT2、INT4、INT8、NUMERIC、DECIMAL DECIMAL
FLOAT、DOUBLE DOUBLE
DATE DATE
TIMESTAMP TIMESTAMP
TIMESTAMPTZ TIMESTAMPTZ

使用に関する注意事項

ORDER BY 式が DECIMAL データ型であり、その最大精度が 38 桁である場合、PERCENTILE_CONT が不正確な結果またはエラーを返す可能性があります。PERCENTILE_CONT 関数の戻り値が 38 桁を超える場合、結果は 38 桁までとなり、39 桁以降は切り捨てられるため、精度が失われます。補間中に中間結果が最大精度を超えた場合には、数値オーバーフローが発生し、この関数はエラーを返します。このような状態を回避するため、精度が低いデータ型を使用するか、ORDER BY 式を低い精度にキャストすることをお勧めします。

ステートメントにソートベースの集計関数 (LISTAGG、PERCENTILE_CONT、または MEDIAN) に対する複数の呼び出しが含まれる場合、すべて同じ ORDER BY 値を使用する必要があります。MEDIAN では、式の値による暗黙的な順序が適用されることに注意してください。

たとえば、次のステートメントはエラーを返します。

Copy
select top 10 salesid, sum(pricepaid), percentile_cont(0.6) within group (order by salesid), median (pricepaid) from sales group by salesid, pricepaid; An error occurred when executing the SQL command: select top 10 salesid, sum(pricepaid), percentile_cont(0.6) within group (order by salesid), median (pricepaid) from sales group by salesid, pricepai... ERROR: within group ORDER BY clauses for aggregate functions must be the same

以下のステートメントは正常に実行されます。

Copy
select top 10 salesid, sum(pricepaid), percentile_cont(0.6) within group (order by salesid), median (salesid) from sales group by salesid, pricepaid;

以下は、MEDIAN が PERCENTILE_CONT(0.5) と同じ結果を生成する例です。

Copy
select top 10 distinct sellerid, qtysold, percentile_cont(0.5) within group (order by qtysold), median (qtysold) from sales group by sellerid, qtysold; sellerid | qtysold | percentile_cont | median ---------+---------+-----------------+------- 1 | 1 | 1.0 | 1.0 2 | 3 | 3.0 | 3.0 5 | 2 | 2.0 | 2.0 9 | 4 | 4.0 | 4.0 12 | 1 | 1.0 | 1.0 16 | 1 | 1.0 | 1.0 19 | 2 | 2.0 | 2.0 19 | 3 | 3.0 | 3.0 22 | 2 | 2.0 | 2.0 25 | 2 | 2.0 | 2.0