CONTAR

✅ Azure Stream Analytics ✅ Fabric Eventstream

Devolve o número de itens num grupo. COUNT sempre retorna um valor de tipo de dados bigint.

Sintaxe

-- Aggregate Function Syntax
COUNT ( { [ [ALL | DISTINCT] expression ] | * } ) 

-- Analytic Function Syntax
COUNT ( { [expression] | * }) OVER ([<PARTITION BY clause>] <LIMIT DURATION clause> [<WHEN clause>])
  

Argumentos

TODOS

Aplica a função de agregação a todos os valores. ALL é o padrão.

DISTINTO

Especifica que COUNT retorna o número de valores exclusivos não nulos.

expressão

É uma expressão de qualquer tipo ou um nome de coluna. Não são permitidas funções agregadas e subconsultas.

* (expressão curinga)

Especifica que todos os eventos devem ser contados para retornar o número total de eventos em um grupo. COUNT(*) não usa parâmetros. COUNT(*) não requer um parâmetro de expressão porque, por definição, não usa informações sobre nenhuma coluna em particular. COUNT(*) retorna o número de eventos sem se livrar de duplicatas. Conta cada evento separadamente. Isso inclui eventos que contêm valores nulos, retornando um 0 para valores nulos.

OVER ([<PARTIÇÃO POR cláusula<>LIMIT DURATION clause> [<WHEN clause>]]

Determina o grupo de linhas sobre o qual COUNT é aplicado. A cláusula PARTITION BY especifica que as linhas com a mesma chave de partição serão agrupadas. A cláusula LIMIT DURATION especifica quanto histórico está incluído no grupo. A cláusula WHEN especifica uma condição booleana para as linhas a serem incluídas no grupo. Consulte a cláusula OVER para obter mais detalhes sobre o uso.

Observações

• COUNT(*) retorna o número de eventos, incluindo valores NULL e duplicatas.

• COUNT(ALL expression) e COUNT(expression) avalia a expressão para cada evento em um grupo e retorna o número de valores não nulos.

• COUNT(DISTINCT expression) avalia a expressão para cada evento em um grupo e retorna o número de valores exclusivos e não nulos.

• COUNT(input_stream) é equivalente a COUNT() e COUNT(*), mas COUNT(DISTINCT input_stream) conta apenas eventos únicos.

• COUNT(DISTINCT expression) não é suportado como uma função analítica. Ou seja, você não pode usar COUNT(expressão DISTINTA) com a cláusula OVER.

Tipos de devolução

bigint

Exemplos

SELECT System.Timestamp() AS OutTime, TollId, COUNT(*)   
FROM Input TIMESTAMP BY EntryTime  
GROUP BY TollId, TumblingWindow(minute,3)  

Ver também

Cláusula GROUP BY
Cláusula OVER