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

  • Artigo

Localiza uma linha no grupo que minimiza ExprToMinimize.

Observação

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

Aliases preteridos: argmin ()

Syntax

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

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

Tratamento nulo

Quando ExprToMinimize é nulo para todas as linhas em um grupo, uma linha no grupo é escolhida. Caso contrário, as linhas em que ExprToMinimize é nulo são ignoradas.

Retornos

Retorna uma linha no grupo que minimiza ExprToMinimize e o valor de ExprToReturn. Use ou * para retornar a linha inteira.

Exemplos

Localize a latitude mínima de um evento de tempestade em cada estado.

Executar a consulta

StormEvents 
| summarize arg_min(BeginLat, BeginLocation) by State

A tabela de resultados mostrada inclui apenas as primeiras 10 linhas.

Estado BeginLat BeginLocation
SAMOA AMERICANA -14.3 PAGO PAGO
CALIFÓRNIA 32.5709 NESTOR
MINNESOTA 43.5 BIGELOW
WASHINGTON 45.58 WASHOUGAL
GEÓRGIA 30.67 FARGO
ILLINOIS 37 CAIRO
FLÓRIDA 24.6611 CHAVE SUGARLOAF
KENTUCKY 36,5 HAZEL
TEXAS 25,92 BROWNSVILLE
OHIO 38.42 PT SUL
... ... ...

Localize a primeira 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_min(StartTime, *) by State

A tabela de resultados mostrada inclui apenas as primeiras 10 linhas e as três primeiras colunas.

Estado StartTime EndTime ...
INDIANA 2007-01-01T00:00:00Z 2007-01-22T18:49:00Z ...
FLÓRIDA 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 ...
CALIFÓRNIA 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 ...
... ... ... ...

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_min(Version, *) by Fruit

Saída

Fruta Versão Cor
Apple 1 Vermelho
Banana Amarelo
Pêra 1 Brown