arg_min() (fonction d’agrégation)

Recherche une ligne dans le groupe qui réduit ExprToMinimize.

Notes

Cette fonction est utilisée conjointement avec l’opérateur de synthèse.

Alias dépréciés : argmin()

Syntax

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

Découvrez les conventions de syntaxe.

Paramètres

Nom	Type	Obligatoire	Description
ExprToMinimize	string	✔️	Expression utilisée pour le calcul d’agrégation.
ExprToReturn	string	✔️	Expression utilisée pour renvoyer la valeur quand ExprToMinimize est minimale. Utilisez un caractère générique (*) pour renvoyer toutes les colonnes de la table d’entrée.

Gestion des valeurs Null

Quand ExprToMinimize a la valeur null pour toutes les lignes d’un groupe, une ligne du groupe est choisie. Sinon, les lignes où ExprToMinimize a la valeur null sont ignorées.

Retours

Retourne une ligne du groupe qui réduit ExprToMinimize et la valeur d’ExprToReturn. Utilisez ou * pour retourner la ligne entière.

Exemples

Recherchez la latitude minimale d’un événement de tempête dans chaque état.

Exécuter la requête

StormEvents 
| summarize arg_min(BeginLat, BeginLocation) by State

Le tableau de résultats affiché inclut uniquement les 10 premières lignes.

State	BeginLat	BeginLocation
SAMOA AMÉRICAINES	-14.3	PAGO PAGO
CALIFORNIE	32.5709	NESTOR
MINNESOTA	43.5	BIGELOW
WASHINGTON	45.58	WASHOUGAL
GEORGIE	30.67	FARGO
ILLINOIS	37	CAIRE
FLORIDE	24.6611	SUGARLOAF KEY
KENTUCKY	36,5	NOISETTE
TEXAS	25.92	BROWNSVILLE
OHIO	38.42	SUD PT
...	...	...

Recherchez la première fois qu’un événement avec un décès direct s’est produit dans chaque état affichant toutes les colonnes.

Exécuter la requête

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

Le tableau de résultats indiqué inclut uniquement les 10 premières lignes et les 3 premières colonnes.

State	StartTime	EndTime	...
INDIANA	2007-01-01T00 :00 :00Z	2007-01-22T18 :49 :00Z	...
FLORIDE	2007-01-03T10 :55 :00Z	2007-01-03T10 :55 :00Z	...
NEVADA	2007-01-04T09 :00 :00Z	2007-01-05T14 :00 :00Z	...
LOUISIANE	2007-01-04T15 :45 :00Z	2007-01-04T15 :52 :00Z	...
WASHINGTON	2007-01-09T17 :00 :00Z	2007-01-09T18 :00 :00Z	...
CALIFORNIE	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	...
...	...	...	...

L’exemple suivant illustre la gestion des valeurs Null.

Exécuter la requête

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

Sortie

Fruit	Version	Couleur
Apple	1	Rouge
Banane		Jaune
Poire	1	Brown