count_distinct() (função de agregação) - (versão prévia)
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Conta os 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 são considerados no cálculo.
Observação
Essa função é usada em conjunto com o operador summarize.
Se você precisar apenas de uma estimativa da contagem de valores exclusivos, recomendamos usar a função de agregação que consome dcount
menos recursos.
Para contar apenas os registros para os quais um predicado retorna true
, use a função de agregação count_distinctif .
Observação
- Essa função é limitada a 100 milhões de valores exclusivos. 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 clusters.
- 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 as convenções de sintaxe.
Parâmetros
Nome | Digitar | Obrigatória | Descrição |
---|---|---|---|
expr | scalar | ✔️ | A expressão cujos valores exclusivos devem ser contados. |
Devoluções
Valor inteiro longo que indica o número de valores exclusivos de expr por grupo de resumo.
Exemplo
Este exemplo mostra quantos tipos de eventos de tempestade aconteceram em cada estado.
O desempenho da função pode ser prejudicado ao operar em várias fontes de dados de diferentes clusters.
executar o de consulta
StormEvents
| summarize UniqueEvents=count_distinct(EventType) by State
| top 5 by UniqueEvents
Saída
Estado | Eventos Únicos |
---|---|
TEXAS | 27 |
CALIFÓRNIA | 26 |
Pensilvânia | 25 |
GEÓRGIA | 24 |
NORTH CAROLINA | 23 |