SAMPLE 関数 (DAX)
指定されたテーブルの N 行のサンプルを返します。
構文
SAMPLE(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])
パラメーター
n_value
返す行の数。 単一のスカラー値を返す任意の DAX 式を指定します。式は、行/コンテキストごとに複数回評価されます。 整数以外の値 (または式) が入力された場合、結果は整数としてキャストされます。テーブル
n 行のサンプルを抽出するデータのテーブルを返す任意の DAX 式。orderBy_expression
(省略可能) 結果値を table の各行に対して評価する際に使用される、任意のスカラー DAX 式。order
(省略可能) orderBy_expression の値の並べ替え方法 (昇順または降順) を指定する値。値
代替値
説明
0 (ゼロ)
FALSE
order_by の値を降順に並べ替えます。
これは、order パラメーターを省略した場合の既定値です。
1
TRUE
order_by の昇順に順位付けます。
戻り値
table の N 行のサンプルで構成されたテーブル。n_value が 0 (ゼロ) 以下の場合は空のテーブルになります。 OrderBy 引数が指定された場合、サンプルは安定的かつ決定的になり、最初の行と最後の行に加え、その間に一定間隔で存在する行が返されます。 順序が指定されなかった場合、サンプルはランダムになり、非安定的かつ非決定的になります。
説明
n_value が 0 (ゼロ) 以下の場合、SAMPLE は空のテーブルを返します。
サンプルの値が重複しないようにするには、2 番目の引数として指定されたテーブルが、並べ替えに使用される列でグループ化されていることが必要です。