Partilhar via

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

  • Artigo

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 é 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.

Importante

Os resultados de hll(), hll_if() e hll_merge() podem ser armazenados e recuperados posteriormente. Por exemplo, você pode criar um resumo diário de usuários únicos, que pode ser usado para calcular contagens semanais. No entanto, a representação binária precisa desses resultados pode mudar com o tempo. Não há garantia de que essas funções produzirão resultados idênticos para entradas idênticas e, portanto, não recomendamos confiar nelas.

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.

Dica

  • Você pode usar a função hll_merge de agregação para mesclar mais de um hll resultado intermediário. Funciona apenas com hll saída.
  • Você pode usar dcount_hll, para calcular a contagem distinta de ,hll_merge ou hll_if funções de hllagregação.

Exemplos

StormEvents
| where State in ("IOWA", "KANSAS")
| summarize hll_flood = hll_if(Source, EventType == "Flood") by State
| project State, SourcesOfFloodEvents = dcount_hll(hll_flood)
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