SAMPLE

  • Статья

Применяется к:вычисляемой таблице вычисляемой таблицы Вычисление визуального элемента измерениявычисляемой таблицы

Возвращает пример N строк из указанной таблицы.

Синтаксис

SAMPLE(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])

Параметры

Термин Определение
n_value Количество возвращаемых строк. Это любое выражение DAX, которое возвращает одно скалярное значение, где выражение должно оцениваться несколько раз (для каждой строки или контекста). Если введено не целочисленное значение (или выражение), результат приводится в виде целого числа.
table Любое выражение DAX, возвращающее таблицу данных, из которого извлекаются примеры строк n.
orderBy_expression Любое скалярное выражение DAX, где значение результата вычисляется для каждой строки таблицы.
заказ (Необязательно) Значение, указывающее порядок сортировки orderBy_expression значений, возрастания или убывания: 0 (ноль), сортировки по убыванию значений order_by. 1, ранжирует в порядке возрастания order_by.

Возвращаемое значение

Таблица, состоящая из образца N строк таблицы или пустой таблицы , если n_value равно 0 (нулю) или меньше. Если указаны аргументы OrderBy, пример будет стабильным и детерминированным, возвращая первую строку, последнюю строку и равномерно распределенные строки между ними. Если порядок не указан, выборка будет случайной, не стабильной и не детерминированной.

Замечания

  • Если n_value равно 0 (ноль) или меньше, образец возвращает пустую таблицу.

  • Чтобы избежать повторяющихся значений в примере, таблица, указанная в качестве второго аргумента, должна сгруппироваться по столбцу, используемому для сортировки.

  • Эта функция не поддерживается для использования в режиме DirectQuery при использовании в вычисляемых столбцах или правилах безопасности на уровне строк (RLS).