Compartilhar via


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

Aplica-se a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

Calcula os resultados intermediários de dcount em registros para os quais o predicado é avaliado como true.

Leia sobre o algoritmo subjacente (HyperLogLog) e a precisão da estimativa.

Observação

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

Sintaxe

hll_if ( expr, predicado [,precisão])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
expr string ✔️ A expressão usada para o cálculo de agregação.
predicate string ✔️ O Expr usado para filtrar registros para adicionar ao resultado intermediário de dcount.
exatidão int O valor que controla o equilíbrio entre velocidade e precisão. Se não for especificado, o valor padrão será 1. Para obter valores compatíveis, consulte Precisão da estimativa.

Devoluções

Retorna os resultados intermediários da contagem distinta de Expr para a qual Predicate é avaliado como true.

Observação

  • Os resultados de hll(), hll_if() e hll_merge() podem ser armazenados e recuperados posteriormente. Por exemplo, talvez você queira criar um resumo diário exclusivo do usuário, que pode ser usado para calcular contagens semanais. No entanto, a representação binária precisa desses resultados pode mudar ao longo do tempo. Não há garantia de que essas funções produzam resultados idênticos para entradas idênticas e, portanto, não aconselhamos confiar nelas.
  • Use a função hll_merge para mesclar mais de um hll resultado intermediário. Só funciona com hll saída.
  • Use dcount_hll, para calcular a contagem distinta de funções de agregação hll,hll_mergeou hll_if.

Exemplos

A consulta a seguir resulta no número de fontes de eventos de inundação exclusivas em Iowa e Kansas. Ele usa a função hll_if() para mostrar apenas eventos de inundação.

StormEvents
| where State in ("IOWA", "KANSAS")
| summarize hll_flood = hll_if(Source, EventType == "Flood") by State
| project State, SourcesOfFloodEvents = dcount_hll(hll_flood)

de saída

Estado SourcesOfFloodEvents
KANSAS 11
IOWA 7

Precisão da estimativa

Precisão Velocidade Erro (%)
0 Fastest 1.6
1 Balanced 0,8
2 Lento 0,4
3 Lento 0,28
4 Menor 0,2