SAMPLE

gælder for:beregnet kolonneberegnet tabelberegning af målingvisualisering

Returnerer et eksempel på N-rækker fra den angivne tabel.

Syntaks

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

Parametre

Begreb	Definition
n_value	Det antal rækker, der skal returneres. Det er ethvert DAX udtryk, der returnerer en enkelt skalarværdi, hvor udtrykket skal evalueres flere gange (for hver række/kontekst). Hvis der indtastes en værdi (eller et udtryk), der ikke er heltal, angives resultatet som et heltal.
table	Ethvert DAX udtryk, der returnerer en tabel med data, hvorfra 'n'-eksempelrækkerne skal udtrækkes.
orderBy_expression	Ethvert skalar DAX udtryk, hvor resultatværdien evalueres for hver række i table.
order	(Valgfrit) En værdi, der angiver, hvordan du sorterer orderBy_expression værdier, stigende eller faldende: 0 (nul), sorterer i faldende rækkefølge værdier af order_by. 1, rangerer i stigende rækkefølge efter order_by.

Returværdi

En tabel bestående af et eksempel på N-rækker med table eller en tom tabel, hvis n_value er 0 (nul) eller mindre. Hvis OrderBy-argumenterne er angivet, vil eksemplet være stabilt og deterministisk og returnere den første række, den sidste række og jævnt fordelte rækker mellem dem. Hvis der ikke er angivet nogen rækkefølge, vil stikprøven være tilfældig, ikke stabil og ikke deterministisk.

Bemærkninger

• Hvis n_value er 0 (nul) eller mindre, returnerer SAMPLE en tom tabel.

• For at undgå dublerede værdier i eksemplet skal den tabel, der er angivet som det andet argument, grupperes efter den kolonne, der bruges til sortering.

• Denne funktion understøttes ikke til brug i DirectQuery-tilstand, når den bruges i beregnede kolonner eller RLS-regler (row-level security).