SAMPLE
Gilt für:Berechnete Spalteberechnete TabelleMeasurevisuelle Berechnung
Gibt einen sample von N-Zeilen aus der angegebenen Tabelle zurück.
Syntax
SAMPLE(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])
Parameter
Begriff | Definition |
---|---|
n_value |
Die Anzahl der zurückzugebenden Zeilen. Es ist ein beliebiger DAX Ausdruck, der einen einzelnen skalaren valuezurückgibt, wobei der Ausdruck mehrmals ausgewertet werden soll (für jede Zeile/jeden Kontext). If ein nicht ganzzahliger value (or Ausdruck) eingegeben wird, wird das Ergebnis als ganze Zahl umgewandelt. |
table |
Jeder DAX Ausdruck, der eine Tabelle mit Daten zurückgibt, aus der die "n" sample Zeilen extrahiert werden sollen. |
orderBy_expression |
Jeder skalare DAX Ausdruck, in dem das Ergebnis value für jede Zeile table ausgewertet wird. |
order |
(Optional) Ein value, der angibt, wie orderBy_expression valuessortiert wird, aufsteigend or absteigend: 0 (Null), sortiert in absteigender Reihenfolge von values von order_by . 1, rangiert in aufsteigender Reihenfolge von order_by . |
value zurückgeben
Eine Tabelle, die aus einer sample von N-Zeilen mit table
or einer leeren Tabelle besteht, ifn_value
0 (Null) or kleiner ist.
If
OrderBy Argumente bereitgestellt werden, ist die sample stabil and deterministisch und gibt die first Zeile, die last Zeile zurück, and gleichmäßig verteilte Zeilen dazwischen zurück.
If keine Sortierung angegeben wird, ist die sample zufällig, not stabil, andnot deterministisch.
Bemerkungen
If
n_value
ist 0 (Null) or kleiner, SAMPLE eine leere Tabelle zurückgibt.Um doppelte values im samplezu vermeiden, sollte die als second Argument angegebene Tabelle nach der spalte gruppiert werden, die für die Sortierung verwendet wird.
Diese Funktion wird not für die Verwendung im DirectQuery-Modus unterstützt, wenn sie in berechneten Spalten or Sicherheitsregeln auf Zeilenebene (RLS) verwendet wird.