count_distinctif() (função de agregação) – (versão prévia)

  • Artigo

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. Somente os registros para os quais o predicado é avaliado são contados true .

Observação

Essa função é usada em conjunto com o operador summarize.

Se você precisar apenas de uma estimativa de contagem de valores exclusivos, recomendamos usar a função de agregação dcountif menos consumida por recursos.

Observação

  • Essa função é limitada a valores exclusivos de 100M. Uma tentativa de aplicar a função em uma expressão que retorna muitos valores produzirá um erro de runtime (HRESULT: 0x80DA0012).
  • O desempenho da função pode ser degradado ao operar em várias fontes de dados de clusters diferentes.

Syntax

count_distinctif(Expr,Predicado)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
expr escalar ✔️ A expressão cujos valores exclusivos devem ser contados.
predicate string ✔️ A expressão usada para filtrar registros a serem agregados.

Retornos

Valor inteiro que indica o número de valores exclusivos de expr por grupo de resumo, para todos os registros para os quais o predicado é avaliado truecomo .

Exemplo

Este exemplo mostra quantos tipos de eventos de tempestade causadores de morte ocorreram em cada estado. Somente eventos de tempestade com uma contagem diferente de zero de mortes serão contados.

Executar a consulta

StormEvents
| summarize UniqueFatalEvents=count_distinctif(EventType,(DeathsDirect + DeathsIndirect)>0) by State
| where UniqueFatalEvents > 0
| top 5 by UniqueFatalEvents

Saída

Estado UniqueFatalEvents
TEXAS 12
CALIFÓRNIA 12
OKLAHOMA 10
NOVA YORK 9
KANSAS 9