Freigeben über

sample-Operator

  • Artikel

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Gibt bis zur angegebenen Anzahl zufälliger Zeilen aus der Eingabetabelle zurück.

Hinweis

  • sample ist auf Geschwindigkeit und nicht gleichmäßige Verteilung von Werten ausgerichtet. Insbesondere bedeutet dies, dass es keine "fairen" Ergebnisse erzeugt, wenn sie nach Operatoren verwendet werden, die 2 Datasets unterschiedlicher Größe (z. B. eines union oder join Operatoren) union 2-Datasets aufweisen. Es wird empfohlen, direkt nach dem Tabellenverweis und den Filtern zu verwenden sample .
  • sample ist ein nicht deterministischer Operator und gibt jedes Mal, wenn es während der Abfrage ausgewertet wird, unterschiedliche Resultsets zurück. Die folgende Abfrage z. B. liefert zwei verschiedene Zeilen (auch wenn eine davon ausgehen würde, dass dieselbe Zeile zweimal zurückgegeben wird).

Syntax

T | sample NumberOfRows

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
T string ✔️ Der Tabellarische Eingabeausdruck.
NumberOfRows int, long oder real ✔️ Die Anzahl der zurückzugebenden Zeilen. Sie können einen beliebigen numerischen Ausdruck angeben.

Beispiele

let _data = range x from 1 to 100 step 1;
let _sample = _data | sample 1;
union (_sample), (_sample)

Ausgabe

x
83
3

Um sicherzustellen, dass in Beispiel oben _sample einmal berechnet wird, kann eine Materialize()-Funktion verwenden:

let _data = range x from 1 to 100 step 1;
let _sample = materialize(_data | sample 1);
union (_sample), (_sample)

Ausgabe

x
34
34

Zum Beispiel für einen bestimmten Prozentsatz Ihrer Daten (anstelle einer angegebenen Anzahl von Zeilen) können Sie verwenden

StormEvents | where rand() < 0.1

Um Beispielschlüssel anstelle von Zeilen (z. B. Beispiel 10 IDs und abrufen aller Zeilen für diese IDs) können Sie in Kombination mit dem in Operator verwendensample-distinct.

let sampleEpisodes = StormEvents | sample-distinct 10 of EpisodeId;
StormEvents
| where EpisodeId in (sampleEpisodes)