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

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 têm em conta o cálculo.

Nota

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

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

Para contar apenas registos para os quais um predicado devolve true, utilize a função de agregação count_distinctif .

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

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.

Devoluções

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 storm ocorreram 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
Porto	25
GEÓRGIA	24
CAROLINA DO NORTE	23