Condividi tramite

arg_min() (funzione di aggregazione)

  • Articolo

Si applica a: ✅Microsoft Fabric✅

Trova una riga nella tabella che riduce al minimo l'espressione specificata. Restituisce tutte le colonne della tabella di input o delle colonne specificate.

Nota

Questa funzione viene usata insieme all'operatore summarize.

Alias deprecati: argmin()

Sintassi

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

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
ExprToMinimize string ✔️ Espressione per cui viene determinato il valore minimo.
ExprToReturn string ✔️ L'espressione determina i valori delle colonne restituite, dalla riga con il valore minimo per ExprToMinimize. Utilizzare un * con caratteri jolly per restituire tutte le colonne.

Gestione dei valori Null

Quando ExprToMinimize è Null per tutte le righe di una tabella, viene selezionata una riga della tabella. In caso contrario, le righe in cui ExprToMinimize è null vengono ignorate.

Valori restituiti

Restituisce una riga nella tabella che riduce al minimo ExprToMinimizee i valori delle colonne specificate in ExprToReturn. Utilizzare o * per restituire l'intera riga.

Mancia

Per visualizzare solo il valore minimo, usare la funzione min().

Esempi

Trovare la latitudine minima di un evento storm in ogni stato.

StormEvents 
| summarize arg_min(BeginLat, BeginLocation) by State

Output

La tabella dei risultati mostrata include solo le prime 10 righe.

Provincia BeginLat BeginLocation
SAMOA AMERICANE -14.3 PAGO PAGO
CALIFORNIA 32.5709 NESTORE
MINNESOTA 43,5 BIGELOW
WASHINGTON 45.58 WASHOUGAL
GEORGIA 30.67 FARGO
ILLINOIS 37 CAIRO
FLORIDA 24.6611 CHIAVE SUGARLOAF
KENTUCKY 36.5 NOCCIOLA
TEXAS 25,92 BROWNSVILLE
OHIO 38.42 SOUTH PT
... ... ...

Trovare la prima volta che si è verificato un evento con un decesso diretto in ogni stato, mostrando tutte le colonne.

La query filtra prima gli eventi in modo da includere solo quelli in cui si è verificato almeno un decesso diretto. La query restituisce quindi l'intera riga con il valore più basso per StartTime.

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

Output

La tabella dei risultati mostrata include solo le prime 10 righe e le prime 3 colonne.

Provincia StartTime EndTime ...
INDIANA 2007-01-01T00:00:00Z 2007-01-22T18:49:00Z ...
FLORIDA 2007-01-03T10:55:00Z 2007-01-03T10:55:00Z ...
NEVADA 2007-01-04T09:00:00Z 2007-01-05T14:00:00Z ...
LOUISIANA 2007-01-04T15:45:00Z 2007-01-04T15:52:00Z ...
WASHINGTON 2007-01-09T17:00:00Z 2007-01-09T18:00:00Z ...
CALIFORNIA 2007-01-11T22:00:00Z 2007-01-24T10:00:00Z ...
OKLAHOMA 2007-01-12T00:00:00Z 2007-01-18T23:59:00Z ...
MISSOURI 2007-01-13T03:00:00Z 2007-01-13T08:30:00Z ...
TEXAS 2007-01-13T10:30:00Z 2007-01-13T14:30:00Z ...
ARKANSAS 2007-01-14T03:00:00Z 2007-01-14T03:00:00Z ...
... ... ... ...

Nell'esempio seguente viene illustrata la gestione dei valori Null.

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

Output

Frutta Versione Color
Apple 1 Rosso
Banana Giallo
Pera 1 Marrone

Confronto con min()

La funzione arg_min() è diversa dalla funzione min(). La funzione arg_min() consente di restituire colonne aggiuntive insieme al valore minimo e min() restituisce solo il valore minimo.

Esempi

arg_min()

Trovare la prima volta che si è verificato un evento con un decesso diretto, visualizzando tutte le colonne della tabella.

La query filtra prima gli eventi in modo da includere solo quelli in cui si è verificato almeno un decesso diretto. La query restituisce quindi l'intera riga con il valore più basso per StartTime.

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

La tabella dei risultati restituisce tutte le colonne per la riga contenente il valore più basso nell'espressione specificata.

StartTime EndTime EpisodeId EventId Provincia EventType ...
2007-01-01T00:00:00Z 2007-01-22T18:49:00Z 2408 11929 INDIANA Inondazione ...

min()

Trovare la prima volta che si è verificato un evento con una morte diretta.

La query filtra gli eventi in modo da includere solo quelli in cui è presente almeno un decesso diretto e quindi restituisce il valore minimo per StartTime.

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

La tabella dei risultati restituisce solo il valore più basso nella colonna specifica.

min_StartTime
2007-01-01T00:00:00Z

Contenuto correlato