arg_min() (fonction d’agrégation)
S’applique à : ✅Microsoft Fabric✅✅
Recherche une ligne dans la table qui réduit l’expression spécifiée. Elle retourne toutes les colonnes de la table d’entrée ou des colonnes spécifiées.
Alias déconseillés : argmin()
Syntaxe
arg_min
(
ExprToMinimize,* | ExprToReturn [, ...])
En savoir plus sur les conventions de syntaxe.
Paramètres
| Nom | Type | Requise | Description |
|---|---|---|---|
| ExprToMinimize | string |
✔️ | Expression pour laquelle la valeur minimale est déterminée. |
| ExprToReturn | string |
✔️ | L’expression détermine les valeurs des colonnes retournées, à partir de la ligne qui a la valeur minimale pour ExprToMinimize. Utilisez un * générique pour retourner toutes les colonnes. |
Gestion des valeurs Null
Lorsque ExprToMinimize a la valeur Null pour toutes les lignes d’une table, une ligne de la table est choisie. Sinon, les lignes où ExprToMinimize a la valeur Null sont ignorées.
Retours
Retourne une ligne dans la table qui réduit ExprToMinimizeet les valeurs des colonnes spécifiées dans ExprToReturn. Utilisez ou * retournez la ligne entière.
Pourboire
Pour afficher la valeur minimale uniquement, utilisez la fonction min().
Exemples
Recherchez la latitude minimale d’un événement de tempête dans chaque état.
StormEvents
| summarize arg_min(BeginLat, BeginLocation) by State
Le tableau des résultats indiqué inclut uniquement les 10 premières lignes.
| État | 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 | LE CAIRE |
| FLORIDE | 24.6611 | CLÉ SUGARLOAF |
| KENTUCKY | 36,5 | NOISETTE |
| TEXAS | 25.92 | BROWNSVILLE |
| OHIO | 38.42 | SUD PT |
| ... | ... | ... |
Recherchez la première fois qu’un événement avec une mort directe s’est produit dans chaque état, affichant toutes les colonnes.
La requête filtre d’abord les événements pour inclure uniquement ceux où il y avait au moins une mort directe. Ensuite, la requête retourne la ligne entière avec la valeur la plus basse pour StartTime.
StormEvents
| where DeathsDirect > 0
| summarize arg_min(StartTime, *) by State
Le tableau des résultats indiqué inclut uniquement les 10 premières lignes et les 3 premières colonnes.
| État | 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 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
Sortie
| Fruit | Version | Couleur |
|---|---|---|
| Apple | 1 | Rouge |
| Banane | Jaune | |
| Poire | 1 | Brun |
Comparaison à min()
La fonction arg_min() diffère de la fonction min(). La fonction arg_min() vous permet de retourner des colonnes supplémentaires, ainsi que la valeur minimale, et min() retourne uniquement la valeur minimale elle-même.
Exemples
arg_min()
Recherchez la première fois qu’un événement avec une mort directe s’est produit, affichant toutes les colonnes de la table.
La requête filtre d’abord les événements pour inclure uniquement ceux où il y avait au moins une mort directe. Ensuite, la requête retourne la ligne entière avec la valeur la plus basse pour StartTime.
StormEvents
| where DeathsDirect > 0
| summarize arg_min(StartTime, *)
La table de résultats retourne toutes les colonnes de la ligne contenant la valeur la plus basse dans l’expression spécifiée.
| StartTime | EndTime | EpisodeId | EventId | État | EventType | ... |
|---|---|---|---|---|---|---|
| 2007-01-01T00:00:00Z | 2007-01-22T18:49:00Z | 2408 | 11929 | INDIANA | Inondation | ... |
min()
Recherchez la première fois qu’un événement avec une mort directe s’est produit.
La requête filtre les événements pour inclure uniquement ceux où il y a au moins une mort directe, puis retourne la valeur minimale pour StartTime.
StormEvents
| where DeathsDirect > 0
| summarize min(StartTime)
La table de résultats retourne la valeur la plus basse dans la colonne spécifique uniquement.
| min_StartTime |
|---|
| 2007-01-01T00:00:00Z |