SAMPLE

Dotyczy:kolumna obliczeniowatabela obliczeniowaMiarawizualizacji

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

Składnia

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

Parametry

Termin	Definicja
n_value	Liczba wierszy do zwrócenia. Jest to dowolne wyrażenie DAX zwracające pojedynczą wartość skalarną, gdzie wyrażenie ma być obliczane wiele razy (dla każdego wiersza/kontekstu). Jeśli wprowadzono wartość inną niż liczba całkowita (lub wyrażenie), wynik jest rzutowy jako liczba całkowita.
table	Dowolne wyrażenie DAX zwracające tabelę danych, z której ma być wyodrębnione przykładowe wiersze "n".
orderBy_expression	Dowolne wyrażenie DAX skalarne, w którym wartość wyniku jest obliczana dla każdego wiersza table.
order	(Opcjonalnie) Wartość określająca sposób sortowania orderBy_expression wartości, rosnąco lub malejąco: 0 (zero), sortuje w kolejności malejącej wartości order_by. 1, plasuje się w kolejności rosnącej order_by.

Wartość zwracana

Tabela składająca się z próbki N wierszy table lub pustej tabeli, jeśli n_value wynosi 0 (zero) lub mniej. Jeśli podano argumenty OrderBy, próbka będzie stabilna i deterministyczna, zwracając pierwszy wiersz, ostatni wiersz i równomiernie rozłożone wiersze między nimi. Jeśli nie określono kolejności, próbka będzie losowa, nie stabilna, a nie deterministyczna.

Uwagi

• Jeśli n_value wynosi 0 (zero) lub mniej, SAMPLE zwraca pustą tabelę.

• Aby uniknąć zduplikowanych wartości w przykładzie, tabela podana jako drugi argument powinna być pogrupowana według kolumny używanej do sortowania.

• Ta funkcja nie jest obsługiwana w trybie DirectQuery w przypadku użycia w kolumnach obliczeniowych lub regułach zabezpieczeń na poziomie wiersza.