Partilhar via


Operador de top-hitters

Aplica-se a: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

Retorna uma aproximação para os valores distintos mais populares, ou os valores com a maior soma, na entrada.

Observação

top-hitters usa um algoritmo de aproximação otimizado para desempenho quando os dados de entrada são grandes. A aproximação é baseada no algoritmo Count-Min-Sketch.

Sintaxe

T|top-hittersNumberOfValuesofValueExpression [ bySummingExpression ]

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação Tipo Necessário Descrição
T string ✔️ A expressão tabular de entrada.
NumberOfValues int, longo ou real ✔️ O número de valores distintos de ValueExpression.
ValueExpression string ✔️ Uma expressão sobre a tabela de entrada T cujos valores distintos são retornados.
SummingExpression string Se especificado, uma expressão numérica sobre a tabela de entrada T cuja soma por valor distinto de ValueExpression estabelece quais valores emitir. Se não for especificado, a contagem de cada valor distinto de ValueExpression será usada.

Observação

  • Quando você inclui SummingExpression na sintaxe, a consulta é equivalente a:

    T | summarize S = sum(SummingExpression) by ValueExpression | top NumberOfValues by S desc

  • Quando você não inclui SummingExpression na sintaxe, a consulta é equivalente a:

    T | summarize C = count() by ValueExpression | top NumberOfValues by C desc

Exemplos

Os exemplos nesta seção mostram como usar a sintaxe para ajudá-lo a começar.

Os exemplos neste artigo usam tabelas disponíveis publicamente no de cluster de ajuda, como a tabela StormEvents no banco de dados Samples.

Os exemplos neste artigo usam tabelas disponíveis publicamente, como a tabela StormEvents na análise do tempo dados de exemplo.

Obter itens mais frequentes

Este exemplo mostra como encontrar os 5 principais tipos de tempestades.

StormEvents
| top-hitters 5 of EventType 

Output

Tipo de Evento approximate_count_EventType
Vento Trovoada 13015
Salve 12711
Inundação repentina 3688
Seca 3616
Tempo de inverno 3349

Obter os melhores acertadores com base no valor da coluna

Este exemplo mostra como encontrar os Estados com mais eventos de de Vento de Trovoada.

StormEvents
| where EventType == "Thunderstorm Wind"
| top-hitters 10 of State 

Output

Estado approximate_sum_State
TEXAS 830
GEÓRGIA 609
MICHIGAN 602
IOWA 585
PENSILVÂNIA 549
ILLINOIS 533
NOVA IORQUE 502
VIRGÍNIA 482
KANSAS 476
OHIO 455