SAMPLESAMPLE

Gibt eine Stichprobe von n Zeilen aus der angegebenen Tabelle zurück.Returns a sample of N rows from the specified table.

SyntaxSyntax

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

ParameterParameters

BenennungTerm DefinitionDefinition
n_valuen_value Die Anzahl der zurückzugebenden Zeilen.The number of rows to return. 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).It is any DAX expression that returns a single scalar value, where the expression is to be evaluated multiple times (for each row/context). Wenn ein nicht ganzzahliger Wert (oder Ausdruck) eingegeben wird, wird das Ergebnis in eine ganze Zahl umgewandelt.If a non-integer value (or expression) is entered, the result is cast as an integer.
Tischtable Ein DAX-Ausdruck, der eine Tabelle mit Daten zurückgibt, aus der die 'n' Stichprobenzeilen extrahiert werden sollen.Any DAX expression that returns a table of data from where to extract the 'n' sample rows.
orderBy_expressionorderBy_expression (Optional) Ein skalarer DAX-Ausdruck, bei dem der Ergebniswert für jede Zeile von table ausgewertet wird.(Optional) Any scalar DAX expression where the result value is evaluated for each row of table.
orderorder (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.(Optional) A value that specifies how to sort orderBy_expression values, ascending or descending: 0 (zero), sorts in descending order of values of order_by. 1, Ränge in aufsteigender Reihenfolge von order_by.1, ranks in ascending order of order_by.

RückgabewertReturn value

Eine Tabelle mit Stichproben mit n Zeilen aus table oder eine leere Tabelle, wenn n_value 0 (null) oder kleiner ist.A table consisting of a sample of N rows of table or an empty table if n_value is 0 (zero) or less. 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.If OrderBy arguments are provided, the sample will be stable and deterministic, returning the first row, the last row, and evenly distributed rows between them. Wenn keine Reihenfolge angegeben ist, ist die Probe zufällig, nicht stabil und nicht deterministisch.If no ordering is specified, the sample will be random, not stable, and not deterministic.

BemerkungenRemarks

  • Wenn „n_value“ kleiner oder gleich 0 (null) ist, gibt SAMPLE eine leere Tabelle zurück.If n_value is 0 (zero) or less then SAMPLE returns an empty table.

  • 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.In order to avoid duplicate values in the sample, the table provided as the second argument should be grouped by the column used for sorting.

  • Die Verwendung dieser Funktion im DirectQuery-Modus wird nicht unterstützt, wenn sie in berechneten Spalten oder RLS-Regeln (Row-Level Security) eingesetzt wird.This function is not supported for use in DirectQuery mode when used in calculated columns or row-level security (RLS) rules.