SAMPLE

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.