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

  • Artigo

Localiza uma linha no grupo que minimiza ExprToMinimize.

Nota

Esta função é utilizada em conjunto com o operador de resumo.

Aliases preteridos: argmin()

Syntax

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
ExprToMinimize string ✔️ A expressão utilizada para cálculo de agregação.
ExprToReturn string ✔️ A expressão utilizada para devolver o valor quando ExprToMinimize é mínima. Utilize um caráter universal (*) para devolver todas as colunas da tabela de entrada.

Processamento nulo

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

Devoluções

Devolve uma linha no grupo que minimiza ExprToMinimize e o valor de ExprToReturn. Utilize ou * para devolver 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 apresentada 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
FLORIDA 24.6611 CHAVE DE PÃO AÇUCARADO
KENTUCKY 36,5 HAZEL
TEXAS 25.92 BROWNSVILLE
Lisboa 38.42 PT SUL
... ... ...

Localize a primeira vez que ocorreu um evento com uma morte direta em cada estado que mostra todas as colunas.

Executar a consulta

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

A tabela de resultados apresentada inclui apenas as primeiras 10 linhas e as primeiras 3 colunas.

Estado 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 01-01-09T18:00:00Z ...
CALIFÓRNIA 2007-01-11T22:00:00Z 2007-01-24T10:00:00Z ...
OKLAHOMA 01-2007-12T00:00:00Z 2007-01-18T23:59:00Z ...
MISSOURI 01-2007-13T03:00:00Z 2007-01-13T08:30:00Z ...
TEXAS 01-2007-13T10:30:00Z 01-2007-13T14:30:00Z ...
ARKANSAS 2007-01-14T03:00:00Z 01-2007-14T03:00:00Z ...
... ... ... ...

O exemplo seguinte demonstra o processamento 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 Red
Banana Amarelo
Pera 1 Castanho