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

  • Artigo

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

Os valores nulos são ignorados e não são levados em conta no cálculo.

Observação

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

Se você precisar apenas de uma estimativa de contagem de valores exclusivos, é recomendável usar a função de agregação que consome dcount menos recursos.

Para contar apenas os registros para os quais um predicado retorna true, use a função de agregação count_distinctif .

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_distinct(Expr)

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.

Retornos

Valor inteiro longo que indica o número de valores exclusivos de expr por grupo de resumo.

Exemplo

Este exemplo mostra quantos tipos de eventos de tempestade aconteceram em cada estado.

Executar a consulta

StormEvents
| summarize UniqueEvents=count_distinct(EventType) by State
| top 5 by UniqueEvents

Saída

Estado UniqueEvents
TEXAS 27
CALIFÓRNIA 26
Pensilvânia 25
GEÓRGIA 24
CAROLINA DO NORTE 23