NÄYTE

Koskee seuraavia: Laskettu sarakeLaskettu taulukkoMittarinvisuaalinen laskutoimitus

Palauttaa N rivin otoksen määritetystä taulukosta.

Syntaksi

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

Parametrit

Termi	Määritelmä
n_value	Palautettavien rivien määrä. Se on mikä tahansa yksittäisen skalaariarvon palauttava DAX-lauseke, jossa lauseke pitää laskea useasti (joka riville tai joka kontekstille). Jos annettu arvo (tai lauseke) ei ole kokonaisluku, tuloksena on kokonaisluku.
table	Mikä tahansa DAX-lauseke, joka palauttaa tietotaulukon, josta poimitaan n-otosrivit.
orderBy_expression	Mikä tahansa DAX-skalaarilauseke, jossa tulosarvo lasketaan kullekin taulukon riville.
järjestys	(Valinnainen) Arvo, joka määrittää, lajitellaanko orderBy_expression arvot nousevasti vai laskevasti: 0 (nolla) lajittelee order_by arvojen laskevaan järjestykseen. 1 sijat nousevassa order_by.

Palautusarvo

Taulukko, joka sisältää taulukon N-otosriviä, tai tyhjä taulukko, jos n_value on 0 (nolla) tai pienempi. Jos OrderBy-argumentit annetaan, otos on vakaa ja deterministinen, ja se palauttaa ensimmäisen rivin, viimeisen rivin ja niiden välillä tasaisesti jaetut rivit. Jos järjestystä ei määritetä, otos on satunnainen, ei vakaa eikä deterministinen.

Huomautukset

• Jos n_value on 0 (nolla) tai vähemmän, SAMPLE palauttaa tyhjän taulukon.

• Jotta vältetään arvojen kaksoiskappaleet mallissa, toisena argumenttina annettu taulukko on ryhmitettävä lajitteluun käytetyn sarakkeen mukaan.

• Tätä funktiota ei tueta DirectQuery-tilassa lasketuissa sarakkeissa tai rivitason suojauksen (RLS) säännöissä käytettäväksi.