Partilhar via

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

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

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

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

Observação

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

Sintaxe

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

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação Tipo Necessário Descrição
expr string ✔️ A expressão usada para o cálculo de agregação.
predicado string ✔️ O Expr usado para filtrar registros para adicionar ao resultado intermediário de dcount.
precisã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 os valores suportados, consulte Precisão da estimativa.

Devoluções

Devolve os resultados intermédios da contagem distinta de Expr para os quais Predicado avalia como true.

Observação

  • Os resultados de hll(), hll_if() e hll_merge() podem ser armazenados e posteriormente recuperados. 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 hll,hll_mergeou hll_if funções de agregação.

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.

Executar a consulta

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

Output

Estado FontesdeFloodEvents
KANSAS 11
IOWA 7

Precisão da estimativa

Exatidão Velocidade Erro (%)
0 Mais rápido 1.6
1 Equilibrado 0.8
2 Devagar 0.4
3 Devagar 0.28
4 Mais lento 0.2

Conteúdo relacionado

  • Last updated on