Top - チャート関数
Top() テーブルの列セグメント内の最初 (最上部) の行の数式を評価します。どの行が計算されるかは、offset 値により決定されますが、デフォルトは最上部の行です。テーブル以外のチャートでは、Top() 評価はチャートのストレート テーブルに相当する現在の列の最初の行を評価します。
構文:
Top([TOTAL] expr [ , offset [,count ]])
戻り値データ型: dual
引数:
引数 | 説明 |
---|---|
expr | メジャーの対象となるデータが含まれている数式または項目。 |
offset |
offset の n を 1 より大きい値にすると、数式の評価が先頭行から n 行下に移動します。 offset が負の値である場合、Top 関数は、相応する正の offset 値が付いた Bottom 関数と同様に機能します。 |
count | 3 番目のパラメータである count を 1 より大い値に設定すると、この関数は count 値の範囲、つまり現在の列セグメントの最後の count 行の各値を返します。 この形式では、特別な範囲関数の引数として関数を使用できます。 範囲関数 |
TOTAL |
テーブルが 1 軸の場合、または TOTAL 修飾子が引数として使用される場合は、現在の列セグメントは常に列全体と等しくなります。 |
制限事項:
-
再帰呼び出しは NULL を返します。
-
チャートの式いずれかにこのチャート関数が使用されている場合、チャートの y 値のソート、またはテーブルの式列ごとのソートは許可されません。よって、これらのソート機能は自動的に無効になります。ビジュアライゼーションまたはテーブルでこのチャート関数を使用すると、ビジュアライゼーションのソートは、レコード間の関数に対するソートされた入力の状態に戻ります。
例と結果:
1
この例で示されているテーブルのスクリーンショットでは、軸 Customer とメジャー Sum(Sales) および Top(Sum(Sales)) からテーブルのビジュアライゼーションが作成されています。
列 Top(Sum(Sales))はすべての行で 587 を返します (開始行Astrida の値)。
テーブルには、Sum(Sales)+Top(Sum(Sales))から作成されたものと、数式Sum(Sales)+Top(Sum(Sales), 3)を使用して作成され、引数offsetが3に設定されているTop offset 3という、より複雑なメジャーも表示されています。先頭から 3 つ下にある行の値に現在の行の Sum(Sales) 値を加えます (現在の行 + Canutility の値)。
2
この例で示されているテーブルのスクリーンショットでは、より多くの軸がビジュアライゼーションに追加されています。および Month、Product の 2 つのメジャーがあります。 複数の軸が含まれているチャートでは、Above、Below、Top、Bottom 関数を含む数式の結果は、Qlik Sense における列軸のソート順序によって変わります。Qlik Sense は、最後にソートされた軸の結果である列セグメントに基づいて関数を評価します。列のソート順は、[ソート] のプロパティ パネルで制御され、必ずしも列がテーブルに表示される順序ではありません。
詳細については、Above 関数の例 2 を参照してください。
3 |
結果 | ||
---|---|---|---|
Top 関数は、範囲関数への入力として使用できます。例: RangeAvg (Top(Sum(Sales),1,3))。 |
Top() 関数の引数では、offset は 1 に設定され、count は 3 に設定されています。この関数は、列セグメントの最終行の下の行から始まる 3 行 (offset=1 のため) およびその下の 2 行 (行がある場合) で数式 Sum(Sales) の結果を算出します。この 3 つの値は、RangeAvg() 関数への入力として使用され、指定された数値の範囲で平均値を算出します。 軸として Customer を有するテーブルによって、RangeAvg() の数式について次の結果が得られます。 |
||
|