Partilhar via


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

Aplica-se a: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft 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