Compartir a través de


arg_min() (función de agregación)

Se aplica a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

Busca una fila en la tabla que minimiza la expresión especificada. Devuelve todas las columnas de la tabla de entrada o columnas especificadas.

Nota:

Esta función se usa junto con el operador summarize.

Alias en desuso: argmin()

Sintaxis

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

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Type Obligatorio Descripción
ExprToMinimize string ✔️ Expresión para la que se determina el valor mínimo.
ExprToReturn string ✔️ La expresión determina los valores de las columnas que se devuelven, de la fila que tiene el valor mínimo para ExprToMinimize. Use un * comodín para devolver todas las columnas.

Control nulo

Cuando ExprToMinimize es null para todas las filas de una tabla, se selecciona una fila de la tabla. De lo contrario, se omiten las filas donde ExprToMinimize es NULL.

Devoluciones

Devuelve una fila de la tabla que minimiza ExprToMinimizey los valores de las columnas especificadas en ExprToReturn. Use o * para devolver toda la fila.

Propina

Para ver solo el valor mínimo, use la función min().

Ejemplos

Busque la latitud mínima de un evento de tormenta en cada estado.

StormEvents 
| summarize arg_min(BeginLat, BeginLocation) by State

La tabla de resultados que se muestra incluye solo las primeras 10 filas.

Valor BeginLat BeginLocation
AMERICAN SAMOA -14.3 PAGO PAGO
CALIFORNIA 32.5709 NESTOR
MINNESOTA 43.5 BIGELOW
WASHINGTON 45.58 WASHOUGAL
GEORGIA 30.67 FARGO
ILLINOIS 37 EL CAIRO
FLORIDA 24.6611 SUGARLOAF KEY
KENTUCKY 36,5 AVELLANA
TEXAS 25,92 BROWNSVILLE
OHIO 38.42 SOUTH PT
... ... ...

Busque la primera vez que se produjo un evento con una muerte directa en cada estado, mostrando todas las columnas.

La consulta filtra primero los eventos para incluir solo aquellos en los que hubo al menos una muerte directa. A continuación, la consulta devuelve toda la fila con el valor más bajo de StartTime.

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

La tabla de resultados que se muestra incluye solo las primeras 10 filas y las primeras 3 columnas.

Valor 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 ...
MISURI 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 ...
... ... ... ...

En el ejemplo siguiente se muestra el control nulo.

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

Salida

Frutas Versión Color
Apple 1 Rojo
Plátano Amarillo
Pera 1 Marrón

Comparación con min()

La función arg_min() difiere de la función min(). La función arg_min() permite devolver columnas adicionales junto con el valor mínimo y min() solo devuelve el propio valor mínimo.

Ejemplos

arg_min()

Busque la primera vez que se produjo un evento con una muerte directa, mostrando todas las columnas de la tabla.

La consulta filtra primero los eventos para incluir solo aquellos en los que hubo al menos una muerte directa. A continuación, la consulta devuelve toda la fila con el valor más bajo de StartTime.

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

La tabla de resultados devuelve todas las columnas de la fila que contiene el valor más bajo de la expresión especificada.

StartTime EndTime EpisodeId EventId Valor EventType ...
2007-01-01T00:00:00Z 2007-01-22T18:49:00Z 2408 11929 INDIANA Inundación ...

min()

Encuentra la primera vez que ocurrió un evento con una muerte directa.

La consulta filtra los eventos para incluir solo aquellos en los que haya al menos una muerte directa y, a continuación, devuelve el valor mínimo de StartTime.

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

La tabla de resultados devuelve el valor más bajo solo en la columna específica.

min_StartTime
2007-01-01T00:00:00Z
  • de función mínima
  • de función máxima
  • de función promedio
  • de función percentil
  • de función mínima