arg_min() (Aggregationsfunktion)

Gilt für: ✅Microsoft Fabric

Sucht eine Zeile in der Tabelle, die den angegebenen Ausdruck minimiert. Sie gibt alle Spalten der Eingabetabelle oder der angegebenen Spalten zurück.

Veraltete Aliase: argmin()

Syntax

arg_min ( ExprToMinimize,* | ExprToReturn [, ...])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Nullbehandlung

Wenn ExprToMinimize für alle Zeilen in einer Tabelle null ist, wird eine Zeile in der Tabelle ausgewählt. Andernfalls werden Zeilen, in denen ExprToMinimize null ist, ignoriert.

Gibt zurück

Gibt eine Zeile in der Tabelle zurück, die ExprToMinimizeminimiert, und die Werte von Spalten, die in ExprToReturnangegeben sind. Verwenden oder * zurückgeben Sie die gesamte Zeile.

Beispiele

Im folgenden Beispiel wird der maximale Breitengrad eines Sturmereignisses in jedem Zustand ermittelt.

StormEvents 
| summarize arg_min(BeginLat, BeginLocation) by State

Ausgabe

Die angezeigte Ergebnistabelle enthält nur die ersten 10 Zeilen.

Suchen Sie das erste Mal, wenn ein Ereignis mit einem direkten Tod in jedem Zustand aufgetreten ist, in dem alle Spalten angezeigt werden.

Die Abfrage filtert zuerst die Ereignisse, um nur diejenigen einzuschließen, bei denen mindestens ein direkter Tod aufgetreten ist. Anschließend gibt die Abfrage die gesamte Zeile mit dem niedrigsten Wert für StartTime zurück.

StormEvents
| where DeathsDirect > 0
| summarize arg_min(StartTime, *) by State

Ausgabe

Die angezeigte Ergebnistabelle enthält nur die ersten 10 Zeilen und die ersten drei Spalten.

Im folgenden Beispiel wird die Nullbehandlung veranschaulicht.

datatable(Fruit: string, Color: string, Version: int) [
    "Apple", "Red", 1,
    "Apple", "Green", int(null),
    "Banana", "Yellow", int(null),
    "Banana", "Green", int(null),
    "Pear", "Brown", 1,
    "Pear", "Green", 2,
]
| summarize arg_min(Version, *) by Fruit

Ausgabe

Vergleich mit min()

Die funktion arg_min() unterscheidet sich von der min() function. Mit der funktion arg_min() können Sie zusätzliche Spalten zusammen mit dem Minimalwert zurückgeben, und min() nur den minimalen Wert selbst zurückgibt.

Beispiele

Im folgenden Beispiel wird arg_min() verwendet, um das letzte Mal zu finden, wenn ein Ereignis mit einem direkten Tod in jedem Zustand aufgetreten ist, wobei alle Spalten angezeigt werden.

StormEvents
| where DeathsDirect > 0
| summarize arg_min(StartTime, *)

Die Ergebnistabelle gibt alle Spalten für die Zeile zurück, die den niedrigsten Wert im angegebenen Ausdruck enthält.

Im folgenden Beispiel wird die Min()-Funktion verwendet, um das letzte Mal zu finden, wenn ein Ereignis mit einem direkten Tod in jedem Zustand aufgetreten ist, aber nur den Minimalwert von StartTime zurückgibt.

StormEvents
| where DeathsDirect > 0
| summarize min(StartTime)

Die Ergebnistabelle gibt den niedrigsten Wert nur in der spezifischen Spalte zurück.

Zugehöriger Inhalt

• Min.-Funktion
• max. Funktion
• durchschnittliche Funktion
• Quantilfunktion
• Min-of-Funktion