count_distinct() (função de agregação) - (visualização)

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

Conta valores exclusivos especificados pela expressão escalar por grupo de resumo ou o número total de valores exclusivos se o grupo de resumo for omitido.

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

Observação

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

Se você precisar apenas de uma estimativa da contagem de valores exclusivos, recomendamos usar a função de agregação dcount que consome menos recursos.

Para contar apenas registros para os quais um predicado retorna true, use a função de agregação count_distinctif.

Observação

• Esta função está limitada a 100 milhões de valores únicos. Uma tentativa de aplicar a função em uma expressão que retorna muitos valores produzirá um erro de tempo de execução (HRESULT: 0x80DA0012).

• O desempenho da função pode ser prejudicado ao operar em várias fontes de dados de diferentes Eventhouses.

Sintaxe

count_distinct ( expr)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação	Tipo	Necessário	Descrição
expr	escalar	✔️	A expressão cujos valores únicos devem ser contados.

Devoluções

Valor inteiro longo que indica o número de valores exclusivos de de expiração por grupo de resumo.

Exemplo

Este exemplo mostra quantos tipos de eventos de tempestade aconteceram em cada estado.

StormEvents
| summarize UniqueEvents=count_distinct(EventType) by State
| top 5 by UniqueEvents

Output

Estado	UniqueEvents
TEXAS	27
CALIFÓRNIA	26
PENSILVÂNIA	25
GEÓRGIA	24
CAROLINA DO NORTE	23