SAMPLE 函數 (DAX)
傳回指定之資料表中的 N 個資料列範例。
語法
SAMPLE(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])
參數
n_value
要傳回的資料列數目。 它是傳回單一純量值的任何 DAX 運算式,而系統將多次評估此運算式 (針對每個資料列/內容)。 如果輸入的是非整數值 (或運算式),結果會轉換為整數。table
傳回資料表 (從中擷取 ‘n’ 個範例資料列) 的任何 DAX 運算式。orderBy_expression
(選擇性) 任何純量 DAX 運算式,系統會針對 table 的每個資料列評估此結果值。order
(選擇性) 指定要如何排序 orderBy_expression 值的值 (遞增或遞減):value
替代值
說明
0 (零)
FALSE
以 order_by 值的遞減順序排序。
這是省略 order 參數時的預設值。
1
TRUE
以 order_by 的遞增順序排列次序。
傳回值
含有 table 中 N 個資料列範例的資料表,如果 n_value 為 0 (零) 或更小,則為空白資料表。 如果已提供 OrderBy 引數,範例就會穩定並具決定性,會傳回第一列、最後一列,並在其中平均分佈資料列。 如果未指定排序方式,範例就會是隨機的,不穩定也不具決定性。
備註
如果 n_value 為 0 (零) 或更小,則 SAMPLE 會傳回空白資料表。
為了避免範例中產生重複的值,提供做為第二個引數的資料表應該要以用於排序的資料行進行分組。