Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.Opens in a new tab

For information on migrating to InterSystems IRISOpens in a new tab, see Why Migrate to InterSystems IRIS?

PERCENTILE

セットのすべての要素にわたって、指定された式 (または現在のメジャー) を評価し、指定された百分位数レベルの値を返します。

返りタイプ

この関数は、数値を返します。

構文および詳細

PERCENTILE(set_expression, optional_numeric_expression, optional_percentile_value)

以下は、この指定の説明です。

  • set_expression は、セットに対して評価される式です。このセットは通常、メンバまたはタプルのセットです。

  • optional_numeric_expression は、セット要素ごとにこの関数が評価する数値式です。

    通常、この式の形式は、[MEASURES].[measure_name] です。

    数値式を指定しない場合、DeepSee では、現在の結果セルで使用されるメジャーが使用されます。例えば、0 軸で使用されたメジャーまたは WHERE 節で指定されたメジャーです (これらがある場合)。クエリ自体がメジャーを指定しない場合、DeepSee では、ファクト・テーブル内のレコードをカウントする %COUNT が代わりに使用されます。

  • optional_percentile_valueは、検索する百分位数を表す数値リテラルです。例えば、30 を使用すると、30 番目の百分位数が検索されます。これは、他の値の 30 パーセントより大きい値です。

    この引数を省略すると、DeepSee では 50 番目の百分位数が計算されます。

この関数は、セットの各要素に対して数値を評価し、指定された百分位数となる値を返します。

Tip:

代わりに、最下位レベルのレコード全体の百分位の値を検索するには、サンプル・プラグイン・クラス %DeepSee.PlugIn.PercentileOpens in a new tab%KPI 関数を使用します。SAMPLES ネームスペースの KPIs & Plugins フォルダ内のサンプル・ダッシュボードを参照してください。

参考として、以下のクエリは、aged.year レベルのメンバに関する、Patient Count メジャーを示します。ORDER 関数は、このクエリの今後の結果と比較しやすくするために、これらのメンバを Patient Count の値の順に並べ替えます。

SELECT MEASURES.[%COUNT] ON 0, ORDER(birthd.year.MEMBERS,MEASURES.[%COUNT],BASC) ON 1 FROM patients
 
                             Patient Count
 1 1916                                   1
 2 1921                                   1
 3 1922                                   1
 4 1925                                   1
 5 1941                                   1
 6 1914                                   2
...
82 1967                                  18
83 1969                                  18
84 1973                                  18
85 1978                                  18
86 1979                                  18
87 1981                                  18
88 2002                                  18
89 2009                                  18
90 1968                                  19
91 1998                                  21
92 1991                                  23
93 2003                                  23
94 1977                                  25

次に、以下のクエリは、これらのメンバの 5 番目の百分位数の値を示します。

SELECT MEASURES.[%COUNT] ON 0, PERCENTILE(birthd.year.MEMBERS,,5) ON 1 FROM patients
 
                             Patient Count
5 Percentile                              1

つまり、5 番目の百分位数は、患者数が 1 人以下の誕生年から構成されます。

以下のクエリは、代わりに 95 番目の百分位数を示します。

SELECT MEASURES.[%COUNT] ON 0, PERCENTILE(birthd.year.MEMBERS,,95) ON 1 FROM patients
 
                             Patient Count
95 Percentile                            18

つまり、95 番目の百分位数は、患者数が 18 人以下の誕生年から構成されます。

別の例では、PERCENTILE の 2 番目の引数を使用します。

SELECT PERCENTILE(birthd.year.MEMBERS,MEASURES.[%COUNT],50) ON 1 FROM patients
  
50 Percentile                           10

追加の類似例は、"AVG" を参照してください。

関連項目

FeedbackOpens in a new tab