TOPN

適用対象:計算列計算テーブルメジャービジュアル計算

指定のテーブルの上位 N 行を返します。

構文

TOPN(<N_Value>, <Table>, <OrderBy_Expression>, [<Order>[, <OrderBy_Expression>, [<Order>]]…])  

Parameters

パラメーター	定義
N_Value	返す行数。 スカラー値を返す任意の DAX 式。式は、複数回評価されます (行/コンテキストごと)。 返される行数が n_value よりも大きくなる可能性がある場合については、「解説」を参照してください。
テーブル	上位 'n' 行を抽出するデータのテーブルを返す任意の DAX 式。 空のテーブルが返される時間をよりよく理解するには、「解説」を参照してください。
OrderBy_Expression	(省略可能) 結果値がテーブルの並べ替えに使用され、table の各行に対して評価される DAX 式。
Order	(省略可能) OrderBy_Expression 値を並べ替える方法を指定する値。 - 0 (ゼロ) または FALSE。 Order の値を降順で並べ替えます。 Order パラメーターを省略した場合の既定値。 - 1 または TRUE. OrderBy を昇順で順位を付けます。

戻り値

Table の上位 N 行のテーブル、または N_Value が 0 (ゼロ) 以下の場合は空のテーブル。 行は特定の順序で並べ替えられているわけではありません。

解説

• テーブルの N 行目の Order_By 値に同順位の値がある場合、すべての同順位の行が返されます。 また、N 行目に同点の値がある場合、関数から n 行を超える行が返される可能性があります。

• N_Value が 0 (ゼロ) 以下の場合、TOPN からは空のテーブルが返されます。

• TOPN では、結果の並べ替え順序が保証されません。

• この関数は、計算列または行レベルのセキュリティ (RLS) ルールで使用される場合、DirectQuery モードでの使用はサポートされません。

例

次のメジャー式は、売上金額別に上位 10 件の販売製品を返します。

= SUMX(
        TOPN(
            10, 
            SUMMARIZE(
                    InternetSales, 
                    InternetSales[ProductKey], 
                    "TotalSales", SUM(InternetSales[SalesAmount])
            ),
            [TotalSales], DESC
        ),
        [TotalSales]
)