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.

Aliases preteridos: argmin()

Sintaxe

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

Saiba mais sobre convenções de sintaxe.

Parâmetros

Tratamento nulo

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

Devoluções

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

Exemplos

O exemplo a seguir localiza a latitude máxima de um evento de tempestade em cada estado.

StormEvents 
| summarize arg_min(BeginLat, BeginLocation) by State

Realização

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

Encontre 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 menor valor para StartTime.

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

Realização

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

O exemplo a seguir demonstra manipulação nula.

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

Realização

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 junto com o valor mínimo, e min() retorna apenas o valor mínimo em si.

Exemplos

O exemplo a seguir usa arg_min() para localizar a última vez que um evento com uma morte direta aconteceu em cada estado, mostrando todas as colunas.

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

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

O exemplo a seguir usa a função min() para localizar a última vez que um evento com uma morte direta aconteceu em cada estado, mas retorna apenas o valor mínimo de 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

• min função
• função máxima
• função avg
• função percentil
• min-de função