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).