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

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

Estima o número de valores distintos de expr para linhas nas quais predicado avalia como true.

Os valores nulos são ignorados e não entram no cálculo.

Sintaxe

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

Saiba mais sobre convenções de sintaxe.

Parâmetros

Devoluções

Devolve uma estimativa do número de valores distintos de de expiração para linhas nas quais predicado avalia como true.

Exemplos

O exemplo a seguir mostra quantos tipos de eventos fatais de tempestade aconteceram em cada estado.

StormEvents
| summarize DifferentFatalEvents=dcountif(EventType,(DeathsDirect + DeathsIndirect)>0) by State
| where DifferentFatalEvents > 0
| order by DifferentFatalEvents 

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

Precisão da estimativa

Esta função usa uma variante do algoritmo HyperLogLog (HLL), que faz uma estimativa estocástica da cardinalidade do conjunto. O algoritmo fornece um "botão" que pode ser usado para equilibrar a precisão e o tempo de execução por tamanho de memória:

O algoritmo inclui algumas provisões para fazer uma contagem perfeita (erro zero), se a cardinalidade definida for pequena o suficiente:

• Quando o nível de precisão é 1, 1000 valores são retornados
• Quando o nível de precisão é 2, 8000 valores são retornados

O limite de erro é probabilístico, não um limite teórico. O valor é o desvio padrão da distribuição de erro (sigma), e 99,7% das estimativas terão um erro relativo inferior a 3 x sigma.

A imagem a seguir mostra a função de distribuição de probabilidade do erro relativo de estimativa, em porcentagens, para todas as configurações de precisão suportadas:

Conteúdo relacionado

• Tipos de função de agregação num relance
• dcount() (função de agregação)
• countif() (função de agregação)
• count_distinctif() (função de agregação)