UKÁZKA
Platí pro:
Výpočet počítané tabulky Počítaná tabulka Výpočet vizuálu
Vrátí vzorek N řádků ze zadané tabulky.
Syntaxe
SAMPLE(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])
Parametry
| Pojem | definice |
|---|---|
| n_value | Počet řádků, které se mají vrátit. Jedná se o libovolný výraz DAX, který vrací jednu skalární hodnotu, kde se má výraz vyhodnotit vícekrát (pro každý řádek nebo kontext). Pokud je zadána jiná než celočíselná hodnota (nebo výraz), výsledek se přetypuje jako celé číslo. |
| table | Libovolný výraz DAX, který vrací tabulku dat, ze které se mají extrahovat řádky vzorku "n". |
| orderBy_expression | Libovolný skalární výraz DAX, ve kterém se výsledná hodnota vyhodnocuje pro každý řádek tabulky. |
| order | (Volitelné) Hodnota, která určuje, jak řadit orderBy_expression hodnoty, vzestupně nebo sestupně: 0 (nula), seřadí sestupně podle hodnot order_by. 1, řadí se vzestupně podle order_by. |
Vrácená hodnota
Tabulka skládající se z vzorku N řádků tabulky nebo prázdné tabulky, pokud je n_value 0 (nula) nebo menší. Pokud jsou zadané argumenty OrderBy, bude ukázka stabilní a deterministická, vrátí první řádek, poslední řádek a rovnoměrně rozdělené řádky mezi nimi. Pokud není zadáno žádné řazení, bude vzorek náhodný, ne stabilní a ne deterministický.
Poznámky
Pokud je n_value 0 (nula) nebo méně, vrátí funkce SAMPLE prázdnou tabulku.
Aby se zabránilo duplicitním hodnotám v ukázce, měla by být tabulka zadaná jako druhý argument seskupována podle sloupce použitého k řazení.
Tato funkce není podporována pro použití v režimu DirectQuery při použití v počítaných sloupcích nebo pravidlech zabezpečení na úrovni řádků (RLS).