Condividi tramite

arg_min() (funzione di aggregazione)

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

Nell'esempio seguente viene trovata la latitudine massima di un evento storm in ogni stato.

Eseguire la query

StormEvents 
| summarize arg_min(BeginLat, BeginLocation) by State

Risultato

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.

Eseguire la query

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

Risultato

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

Provincia Ora di Inizio Ora di Fine ...
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.

Eseguire la query

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

Risultato

Frutta Versione Colore
Mela 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

L'esempio seguente usa arg_min() per trovare l'ultima volta che si è verificato un evento con un decesso diretto in ogni stato, mostrando tutte le colonne.

Eseguire la query

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.

Ora di Inizio Ora di Fine EpisodeId EventId Provincia TipoDiEvento ...
2007-01-01T00:00:00Z 2007-01-22T18:49:00Z 2408 11929 INDIANA Inondazione ...

Nell'esempio seguente viene usata la funzione min() per trovare l'ultima volta che si è verificato un evento con un evento di morte diretta in ogni stato, ma restituisce solo il valore minimo di StartTime.

Eseguire la query

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