arg_max() (função de agregação)
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Localiza uma linha na tabela que maximiza a expressão especificada. Ele retorna todas as colunas da tabela de entrada ou colunas especificadas.
Observação
Essa função é usada em conjunto com o operador summarize.
Apelidos obsoletos: argmax()
Sintaxe
arg_max
(
ExprToMaximize,* | ExprToReturn [, ...])
Saiba mais sobre as convenções de sintaxe.
Parâmetros
| Nome | Digitar | Obrigatória | Descrição |
|---|---|---|---|
| ExprToMaximize | string |
✔️ | A expressão para a qual o valor máximo é determinado. |
| ExprToReturn | string |
✔️ | A expressão determina quais valores de colunas são retornados, da linha que tem o valor máximo para ExprToMaximize. Use um * curinga para retornar todas as colunas. |
Devoluções
Retorna uma linha na tabela que maximiza a expressão especificada ExprToMaximizee os valores das colunas especificadas em ExprToReturn.
Ponta
Para ver apenas o valor máximo, use a função max().
Exemplos
Encontre a latitude máxima de um evento de tempestade em cada estado.
StormEvents
| summarize arg_max(BeginLat, BeginLocation) by State
A tabela de resultados exibe apenas as primeiras 10 linhas.
| Estado | BeginLat | BeginLocation |
|---|---|---|
| MISSISSIPI | 34.97 | BARTON |
| VERMONT | 45 | TRÓIA DO NORTE |
| AMERICAN SAMOA | -14.2 | OFU |
| HAWAII | 22.2113 | PRINCEVILLE |
| MINNESOTA | 49.35 | ARNESEN |
| RHODE ISLAND | 42 | WOONSOCKET |
| INDIANA | 41.73 | FREMONT |
| WEST VIRGINIA | 40.62 | CHESTER |
| SOUTH CAROLINA | 35.18 | LANDRUM |
| TEXAS | 36.4607 | DARROUZETT |
| ... | ... | ... |
Localize a última vez que um evento com uma morte direta aconteceu em cada estado, mostrando todas as colunas.
A consulta primeiro filtra os eventos para incluir apenas aqueles em que houve pelo menos uma morte direta. Em seguida, a consulta retorna toda a linha com o StartTime mais recente.
StormEvents
| where DeathsDirect > 0
| summarize arg_max(StartTime, *) by State
A tabela de resultados exibe apenas as primeiras 10 linhas e as 3 primeiras colunas.
| Estado | StartTime | EndTime | ... |
|---|---|---|---|
| GUAM | 2007-01-27T11:15:00Z | 2007-01-27T11:30:00Z | ... |
| MASSACHUSETTS | 2007-02-03T22:00:00Z | 2007-02-04T10:00:00Z | ... |
| AMERICAN SAMOA | 2007-02-17T13:00:00Z | 2007-02-18T11:00:00Z | ... |
| IDAHO | 2007-02-17T13:00:00Z | 2007-02-17T15:00:00Z | ... |
| DELAWARE | 2007-02-25T13:00:00Z | 2007-02-26T01:00:00Z | ... |
| WYOMING | 2007-03-10T17:00:00Z | 2007-03-10T17:00:00Z | ... |
| NEW MEXICO | 2007-03-23T18:42:00Z | 2007-03-23T19:06:00Z | ... |
| INDIANA | 2007-05-15T14:14:00Z | 2007-05-15T14:14:00Z | ... |
| MONTANA | 2007-05-18T14:20:00Z | 2007-05-18T14:20:00Z | ... |
| LAKE MICHIGAN | 2007-06-07T13:00:00Z | 2007-06-07T13:00:00Z | ... |
| ... | ... | ... | ... |
O exemplo a seguir demonstra o tratamento de nulos.
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_max(Version, *) by Fruit
Saída
| Fruta | Versão | Color |
|---|---|---|
| Apple | 1 | Vermelho |
| Banana | Amarelo | |
| Pera | 2 | Verde |
Comparação com max()
A função arg_max() difere da função max(). A função arg_max() permite que você retorne colunas adicionais juntamente com o valor máximo e max() retorna apenas o valor máximo em si.
Exemplos
arg_max()
Localize a última vez que um evento com uma morte direta aconteceu, mostrando todas as colunas na tabela.
A consulta primeiro filtra os eventos para incluir apenas aqueles em que houve pelo menos uma morte direta. Em seguida, a consulta retorna toda a linha com o StartTime (máximo) mais recente.
StormEvents
| where DeathsDirect > 0
| summarize arg_max(StartTime, *)
A tabela de resultados retorna todas as colunas da linha que contém o valor mais alto na expressão especificada.
| StartTime | EndTime | EpisodeId | EventId | Estado | EventType | ... |
|---|---|---|---|---|---|---|
| 2007-12-31T15:00:00Z | 2007-12-31T15:00:00 | 12688 | 69700 | UTAH | Avalanche | ... |
max()
Encontre a última vez que um evento com uma morte direta aconteceu.
A consulta filtra eventos para incluir somente aqueles em que há pelo menos uma morte direta e retorna o valor máximo para StartTime.
StormEvents
| where DeathsDirect > 0
| summarize max(StartTime)
A tabela de resultados retorna o valor máximo de StartTime, sem retornar outras colunas para esse registro.
| max_StartTime |
|---|
| 2007-12-31T15:00:00Z |