count_distinctif() (função de agregação) - (visualização)
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Conta condicionalmente 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. Apenas os registos para os quais predicado avalia para true
são contados.
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 de dcountif menos consumidora de recursos.
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 produz 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 clusters diferentes.
- O desempenho da função pode ser prejudicado ao operar em várias fontes de dados de diferentes Eventhouses.
Sintaxe
count_distinctif
(
expr,
predicado)
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. |
predicado | string |
✔️ | A expressão usada para filtrar registros a serem agregados. |
Devoluções
Valor inteiro que indica o número de valores exclusivos de de expiração por grupo de resumo, para todos os registros para os quais o predicado avalia como true
.
Exemplo
O exemplo a seguir mostra quantos tipos de eventos de tempestade causadores de morte aconteceram em cada estado. Apenas eventos de tempestade com uma contagem diferente de zero de mortes são contados.
Observação
O desempenho da função pode ser prejudicado ao operar em várias fontes de dados de clusters diferentes.
StormEvents
| summarize UniqueFatalEvents=count_distinctif(EventType,(DeathsDirect + DeathsIndirect)>0) by State
| where UniqueFatalEvents > 0
| top 5 by UniqueFatalEvents
Output
Estado | UniqueFatalEvents |
---|---|
TEXAS | 12 |
CALIFÓRNIA | 12 |
OKLAHOMA | 10 |
NOVA IORQUE | 9 |
KANSAS | 9 |