SAMPLE

  • [アーティクル]

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

指定のテーブルから N 行のサンプルが返されます。

構文

SAMPLE(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])

パラメーター

用語 定義
n_value 返す行数。 1 つのスカラー値を返す任意の DAX 式です。式は、複数回評価されます (行/コンテキストごと)。 整数以外の値 (または式) を入力した場合、結果は整数としてキャストされます。
席 'n' サンプル行が抽出されるデータのテーブルを返す任意の DAX 式。
orderBy_expression table の各行に対して結果値が評価される任意のスカラー DAX 式。
順序 (省略可能) orderBy_expression 値を昇順または降順に並べ替える方法を指定する値。0 (ゼロ) は、order_by の値を降順で並べ替えます。 1 は、order_by を昇順で順位を付けます。

戻り値

table の N 行のサンプルで構成されるテーブル、または n_value が 0 (ゼロ) 以下の場合は空のテーブル。 OrderBy 引数を指定すると、サンプルは安定し、決定的になり、最初の行、最後の行、およびそれらの間で均等に分散された行が返されます。 順序を指定しない場合、サンプルはランダムになり、安定せず、決定的でもありません。

解説

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

  • サンプルの値が重複しないようにするには、2 番目の引数として指定するテーブルを、並べ替えに使用する列でグループ化する必要があります。

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