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

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

Calcula uma estimativa do número de valores distintos que são tomados por uma expressão escalar no grupo de resumo.

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

Sintaxe

dcount ( expr[,precisão])

Saiba mais sobre convenções de sintaxe.

Parâmetros

Devoluções

Devolve uma estimativa do número de valores distintos de expr no grupo.

Exemplos

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

StormEvents
| summarize DifferentEvents=dcount(EventType) by State
| order by DifferentEvents

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
• dcountif() (função de agregação)
• conta(m)
• count_distinct() (função de agregação)