SAMPLE
Gilt für:
berechnete Spaltenberechnete TabellenMeasuresvisuelle Berechnungen
Gibt eine Stichprobe 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. Dabei handelt es sich um einen DAX-Ausdruck, der einen einzelnen Skalarwert zurückgibt, bei dem der Ausdruck mehrmals ausgewertet wird (für jede Zeile/jeden Kontext). Wenn ein nicht ganzzahliger Wert (oder Ausdruck) eingegeben wird, wird das Ergebnis in eine ganze Zahl umgewandelt. |
| Tisch | Ein DAX-Ausdruck, der eine Tabelle mit Daten zurückgibt, aus der die 'n' Stichprobenzeilen extrahiert werden sollen. |
| orderBy_expression | Ein beliebiger skalarer DAX-Ausdruck, bei dem der Ergebniswert für jede Zeile von table ausgewertet wird. |
| order | (Optional) Ein Wert, der angibt, wie orderBy_expression-Werte sortiert werden (aufsteigend oder absteigend): 0 (Null), Sortierung in absteigender Reihenfolge nach Werten von order_by. 1, Ränge in aufsteigender Reihenfolge von order_by. |
Rückgabewert
Eine Tabelle mit Stichproben mit n Zeilen aus table oder eine leere Tabelle, wenn n_value 0 (null) oder kleiner ist. Wenn OrderBy-Argumente angegeben werden, ist die Stichprobe stabil und deterministisch und gibt die erste und die letzte Zeile und gleichmäßig verteilte Zeilen zwischen Start- und Endzeile zurück. Wenn keine Reihenfolge angegeben ist, ist die Probe zufällig, nicht stabil und nicht deterministisch.
Bemerkungen
Wenn „n_value“ kleiner oder gleich 0 (null) ist, gibt SAMPLE eine leere Tabelle zurück.
Um doppelte Werte in der Stichprobe zu vermeiden, sollte die als zweites Argument angegebene Tabelle nach der Spalte gruppiert werden, die für die Sortierung verwendet wird.
Die Verwendung dieser Funktion im DirectQuery-Modus wird nicht unterstützt, wenn sie in berechneten Spalten oder RLS-Regeln (Row-Level Security) eingesetzt wird.