SAMPLE
применяется:
вычисляемый столбецвычисляемой таблицыизмерениевизуального вычисления
Возвращает пример N строк из указанной таблицы.
Синтаксис
SAMPLE(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])
Параметры
| Термин | Определение |
|---|---|
n_value |
Количество возвращаемых строк. Это любое выражение DAX, которое возвращает одно скалярное значение, где выражение вычисляется несколько раз (для каждой строки или контекста). Если введено не целочисленное значение (или выражение), результат приводится в виде целого числа. |
table |
Любое выражение DAX, возвращающее таблицу данных, из которой извлекаются примеры строк n. |
orderBy_expression |
Любое скалярное DAX выражение, где значение результата вычисляется для каждой строки table. |
order |
(Необязательно) Значение, указывающее, как сортировать orderBy_expression значения, возрастание или убывание: 0 (ноль), сортирует по убыванию значений order_by. 1, ранжирует в порядке возрастания order_by. |
Возвращаемое значение
Таблица, состоящая из образца строк N table или пустой таблицы, если n_value равно 0 (ноль) или меньше. Если указаны аргументы OrderBy, пример будет стабильным и детерминированным, возвращая первую строку, последнюю строку и равномерно распределенные строки между ними. Если порядок не указан, выборка будет случайной, не стабильной и не детерминированной.
Замечания
Если
n_valueравно 0 (ноль) или меньше, SAMPLE возвращает пустую таблицу.Чтобы избежать повторяющихся значений в примере, таблица, указанная в качестве второго аргумента, должна сгруппироваться по столбцу, используемому для сортировки.
Эта функция не поддерживается для использования в режиме DirectQuery при использовании в вычисляемых столбцах или правилах безопасности на уровне строк (RLS).