SAMPLE
指定したテーブルから N 行のサンプルを返します。
構文
SAMPLE(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])
パラメーター
用語 | 定義 |
---|---|
n_value |
返す行数。 1 つのスカラー値を返す任意の DAX 式です。ここで、式は (行/コンテキストごとに) 複数回評価されます。 整数以外の値 (または式) を入力すると、結果は整数としてキャストされます。 |
table |
'n' サンプル行を抽出する場所からデータのテーブルを返す任意の DAX 式。 |
orderBy_expression |
table の各行に対して結果値が評価されるスカラー DAX 式。 |
order |
(省略可能)orderBy_expression 値を昇順または降順で並べ替える方法を指定する値: 0 (ゼロ)、order_by の値の降順で並べ替えます。 1、order_by の昇順でランク付けされます。 |
戻り値
table
の N 行のサンプルから成るテーブル。n_value
が 0 (ゼロ) 以下の場合は空のテーブル。 OrderBy 引数が指定されている場合、サンプルは安定していて確定的になり、最初の行、最後の行、およびそれらの間に均等に分散された行が返されます。 順序が指定されていない場合、サンプルはランダムであり、安定せず、決定論的ではありません。
解説
n_value
が 0 (ゼロ) 以下の場合、SAMPLE は空のテーブルを返します。サンプル内の値が重複しないようにするために、2 番目の引数として指定されたテーブルは、並べ替えに使用される列でグループ化する必要があります。
この関数は、計算列または行レベル セキュリティ (RLS) 規則で使用する場合、DirectQuery モードでは使用できません。