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

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Localiza uma linha na tabela que minimiza a expressão especificada. Ele retorna todas as colunas da tabela de entrada ou colunas especificadas.

Apelidos obsoletos: argmin()

Sintaxe

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Tratamento de nulos

Quando ExprToMinimize é nulo para todas as linhas em uma tabela, uma linha na tabela é escolhida. Caso contrário, as linhas em que ExprToMinimize é nulo serão ignoradas.

Devoluções

Retorna uma linha na tabela que minimiza ExprToMinimizee os valores das colunas especificadas em ExprToReturn. Use ou * para retornar a linha inteira.

Exemplos

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

StormEvents 
| summarize arg_min(BeginLat, BeginLocation) by State

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

Localize a primeira 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 a linha inteira com o valor mais baixo para StartTime.

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

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

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

Saída

Comparação com min()

A função arg_min() difere da função min(). A função arg_min() permite que você retorne colunas adicionais juntamente com o valor mínimo e min() retorna apenas o valor mínimo em si.

Exemplos

arg_min()

Localize a primeira vez que um evento com uma morte direta aconteceu, mostrando todas as colunas da tabela.

A consulta primeiro filtra os eventos para incluir apenas aqueles em que houve pelo menos uma morte direta. Em seguida, a consulta retorna a linha inteira com o valor mais baixo para StartTime.

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

A tabela de resultados retorna todas as colunas da linha que contém o valor mais baixo na expressão especificada.

min()

Encontre a primeira 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ínimo para StartTime.

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

A tabela de resultados retorna o valor mais baixo somente na coluna específica.

Conteúdo relacionado

• função mínima
• função máxima
• função avg
• função percentil
• de função mínima