SAMPLE

Gilt für:Berechnete SpalteBerechnete TabelleMeasurevisuelle Berechnung

Gibt ein Beispiel 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 handelt sich um einen beliebigen DAX Ausdruck, der einen einzelnen skalaren Wert zurückgibt, wobei der Ausdruck mehrmals ausgewertet werden soll (für jede Zeile/jeden Kontext). Wenn ein nicht ganzzahliger Wert (oder Ausdruck) eingegeben wird, wird das Ergebnis als ganze Zahl umgewandelt.
table	Jeder DAX Ausdruck, der eine Datentabelle zurückgibt, aus der die Beispielzeilen "n" extrahiert werden sollen.
orderBy_expression	Ein skalarer DAX Ausdruck, in dem der Ergebniswert für jede Zeile tableausgewertet wird.
order	(Optional) Ein Wert, der angibt, wie orderBy_expression Werte, aufsteigend oder absteigend sortiert werden: 0 (Null), sortiert in absteigender Reihenfolge der Werte von order_by. 1, rangiert in aufsteigender Reihenfolge von order_by.

Rückgabewert

Eine Tabelle, die aus einer Stichprobe von N-Zeilen mit table oder einer leeren Tabelle besteht, wenn n_value 0 (Null) oder kleiner ist. Wenn OrderBy-Argumente angegeben werden, ist das Beispiel stabil und deterministisch, gibt die erste Zeile, die letzte Zeile und gleichmäßig verteilte Zeilen dazwischen zurück. Wenn keine Sortierung angegeben wird, ist die Stichprobe zufällig, nicht stabil und nicht deterministisch.

Bemerkungen

• Wenn n_value 0 (Null) oder kleiner ist, gibt SAMPLE eine leere Tabelle zurück.

• Um doppelte Werte im Beispiel zu vermeiden, sollte die als zweites Argument angegebene Tabelle nach der spalte gruppiert werden, die für die Sortierung verwendet wird.

• Diese Funktion wird für die Verwendung im DirectQuery-Modus nicht unterstützt, wenn sie in berechneten Spalten oder Sicherheitsregeln auf Zeilenebene (RLS) verwendet wird.