arg_max() (função de agregação)

  • Artigo

Localiza uma linha no grupo que maximiza ExprToMaximize.

Observação

Essa função é usada em conjunto com o operador summarize.

Aliases preteridos: argmax()

Syntax

arg_max(ExprToMaximize,* | ExprToReturn [, ...])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
ExprToMaximize string ✔️ A expressão usada para cálculo de agregação.
ExprToReturn string ✔️ A expressão usada para retornar o valor quando ExprToMaximize é máximo. Use um curinga * para retornar todas as colunas da tabela de entrada.

Retornos

Retorna uma linha no grupo que maximiza ExprToMaximize e os valores das colunas especificadas em ExprToReturn.

Exemplos

Localize a latitude máxima de um evento de tempestade em cada estado.

Executar a consulta

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
SAMOA AMERICANA -14.2 OFU
HAVAÍ 22.2113 PRINCEVILLE
MINNESOTA 49.35 ARNESEN
RHODE ISLAND 42 WOONSOCKET
INDIANA 41.73 FREMONT
VIRGÍNIA OCIDENTAL 40.62 CHESTER
CAROLINA DO SUL 35.18 LANDRUM
TEXAS 36.4607 DARROUZETT
... ... ...

Localize a última vez que um evento com uma morte direta ocorreu em cada estado mostrando todas as colunas.

Executar a consulta

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

A tabela de resultados exibe apenas as primeiras 10 linhas e as três 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 ...
SAMOA AMERICANA 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 ...
NOVO MÉXICO 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 ...
LAGO MICHIGAN 2007-06-07T13:00:00Z 2007-06-07T13:00:00Z ...
... ... ... ...

O exemplo a seguir demonstra o tratamento nulo.

Executar a consulta

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 Cor
Apple 1 Vermelho
Banana Amarelo
Pêra 2 Verde