Compartilhar via


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

Aplica-se a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft 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 produz um erro de runtime (HRESULT: 0x80DA0012).
  • O desempenho da função pode ser prejudicado ao operar em várias fontes de dados de diferentes clusters.
  • 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 escalar ✔️ A expressão cujos valores exclusivos 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 expr

Exemplos

O exemplo a seguir mostra quantos tipos de eventos de tempestade causados por morte ocorreram em cada estado. Somente 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 diferentes clusters.

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
NOVA IORQUE 9
KANSAS 9