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 番目の引数として指定されたテーブルが、並べ替えに使用される列でグループ化されていることが必要です。