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

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

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

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 dcountif que consome menos recursos.

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 Eventhouses.

Sintaxe

count_distinctif(expr, predicado)

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.
predicate	string	✔️	A expressão usada para filtrar registros a serem agregados.

Devoluções

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 como true.

Exemplo

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

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

Saída

Estado	Eventos Únicos Fatales
TEXAS	12
CALIFÓRNIA	12
OKLAHOMA	10
NEW YORK	9
KANSAS	9