Udostępnij za pośrednictwem

Funkcja SAMPLE (język DAX)

  • Artykuł

Zwraca próbkę N wierszy z określonej tabeli.

Składnia

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

Parametry

  • n_value
    Liczba wierszy do zwrócenia. Jest to dowolne wyrażenie języka DAX zwracające pojedynczą wartość skalarną; to wyrażenie jest obliczane wielokrotnie (dla każdego wiersza/kontekstu). Jeśli zostanie wprowadzona wartość (lub wyrażenie) niebędąca liczbą całkowitą, wynik będzie rzutowany jako liczba całkowita.

  • table
    Dowolne wyrażenie języka DAX zwracające tabelę danych, z której ma zostać wyodrębniona próbka n wierszy.

  • orderBy_expression
    (Argument opcjonalny) Dowolne skalarne wyrażenie języka DAX, którego wartość wynikowa jest obliczana dla każdego wiersza tabeli table.

  • order
    (Argument opcjonalny) Wartość określająca sposób sortowania wartości określonych w argumencie orderBy_expression (rosnąco lub malejąco):

    wartość

    wartość alternatywna

    Opis

    0 (zero)

    Fałsz

    Wartości określone w argumencie order_by są sortowane w kolejności malejącej.

    Jest to wartość domyślna używana w przypadku pominięcia parametru order.

    1

    TRUE

    Wartości określone w argumencie order_by są sortowane w kolejności rosnącej.

Wartość zwracana

Tabela zawierająca próbkę N wierszy z tabeli table lub pusta tabela, jeśli wartość argumentu n_value jest równa 0 (zero) lub mniej. Jeśli zostaną dostarczone argumenty OrderBy, próbka będzie stabilna i deterministyczna, czyli zostanie zwrócony pierwszy wiersz, ostatni wiersz oraz równomiernie rozłożone wiersze znajdujące się między nimi. Jeśli nie zostanie określone porządkowanie, próbka będzie losowa, niestabilna i niedeterministyczna.

Uwagi

  • Jeśli wartość n_value jest równa 0 (zero) lub mniej, funkcja SAMPLE zwraca pustą tabelę.

  • Aby uniknąć zduplikowanych wartości w próbce, należy pogrupować tabelę określoną jako drugi argument według kolumny używanej do sortowania.