SAMPLE-Funktion (DAX)

Gibt eine Stichprobe mit N Zeilen aus der angegebenen Tabelle zurück.

Syntax

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

Parameter

• n_value
  Die Anzahl der zurückzugebenden Zeilen. Ist ein DAX-Ausdruck, der einen einzelnen Skalarwert zurückgibt, in dem der Ausdruck mehrmals ausgewertet wird (für jede Zeile/Kontext). Wird ein Wert (oder Ausdruck) eingegeben, der keine ganze Zahl darstellt, wird das Ergebnis in eine ganze Zahl umgewandelt.

• table
  Ein DAX-Ausdruck, der eine Tabelle mit Daten zurückgibt, aus der die 'n' Stichprobenzeilen extrahiert werden sollen.

• orderBy_expression
  (Optional) Ein DAX-Skalarausdruck, in dem der Ergebniswert für jede Zeile von table ausgewertet wird.

• order
  (Optional) Ein Wert, der angibt, wie orderBy_expression-Werte sortiert werden, in aufsteigender oder absteigender Reihenfolge:

  value	alternativer Wert	Beschreibung
  0 (Null)	FALSE	Sortiert in absteigender Reihenfolge der Werte von order_by. Dies ist der Standardwert, wenn der order-Parameter ausgelassen wird.
  1	TRUE	Ränge in aufsteigender Reihenfolge von order_by.

Rückgabewert

Eine Tabelle mit einer Stichprobe von 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 es werden die erste und letzte Zeile und die dazwischenliegenden Zeilen in einer gleichmäßigen Verteilung zurückgegeben. Wird keine Sortierung angegeben, wird die Stichprobe nach dem Zufallsprinzip entnommen und ist weder stabil noch deterministisch.

Hinweise

• Wenn n_value 0 (null) oder kleiner 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 für die Sortierung verwendeten Spalte gruppiert werden.