Поделиться через

Функция SAMPLE (DAX)

  • Статья

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

Синтаксис

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

Параметры

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

  • table
    Любое выражение DAX, которое возвращает таблицу данных для извлечения образца в n строк.

  • orderBy_expression
    (Необязательно) Любое скалярное выражение DAX, в котором значение результата вычисляется для каждой строки table.

  • order
    (Необязательно) Значение, которое указывает, как сортировать значения orderBy_expression — по возрастанию или по убыванию:

    value

    альтернативное значение

    Описание

    0 (ноль)

    FALSE

    Сортировка по убыванию значений order_by.

    Это значение по умолчанию, если не указан параметр order.

    1

    TRUE

    Ранжирует в порядке возрастания order_by.

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

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

Замечания

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

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