count_distinctif() (função de agregação) – (pré-visualização)

Conta condicionalmente valores exclusivos especificados pela expressão escalar por grupo de resumo ou pelo número total de valores exclusivos se o grupo de resumo for omitido. Apenas são contados os registos para os quais o predicado é true avaliado.

Nota

Esta função é utilizada em conjunto com o operador summarize.

Se apenas precisar de uma estimativa da contagem de valores exclusivos, recomendamos que utilize a função de agregação dcountif que consome menos recursos.

Nota

• Esta função está limitada a valores exclusivos de 100 M. Uma tentativa de aplicar a função numa expressão que devolve demasiados valores produzirá um erro de runtime (HRESULT: 0x80DA0012).
• O desempenho da função pode ser degradado ao operar em várias origens de dados de clusters diferentes.

Syntax

count_distinctif(expr,predicado)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Necessário	Descrição
expr	escalar	✔️	A expressão cujos valores exclusivos devem ser contados.
predicado	string	✔️	A expressão utilizada para filtrar registos a agregar.

Devoluções

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

Exemplo

Este exemplo mostra quantos tipos de eventos de tempestade causados por morte ocorreram em cada estado. Só serão contados eventos de tempestade com uma contagem não-zero de mortes.

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
NEW YORK	9
KANSAS	9