Partager via


COMPTER

✅ Azure Stream Analytics ✅ Fabric Eventstream

Retourne le nombre d'éléments figurant dans un groupe. COUNT retourne toujours une valeur de type de données bigint.

Syntaxe

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

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

Les arguments

TOUT

Applique la fonction d'agrégation à toutes les valeurs. ALL est l'argument par défaut.

DISTINCT

Spécifie que COUNT retourne le nombre de valeurs non Null uniques.

expression

Expression d’un type ou d’un nom de colonne. Les fonctions d’agrégation et les sous-requêtes ne sont pas autorisées.

* (expression générique)

Spécifie que tous les événements doivent être comptés pour retourner le nombre total d’événements dans un groupe. COUNT(*) ne prend aucun paramètre. COUNT(*) ne nécessite pas de paramètre d’expression, car, par définition, il n’utilise pas d’informations sur une colonne particulière. COUNT(*) retourne le nombre d’événements sans se débarrasser des doublons. Il compte chaque événement séparément. Cela inclut les événements qui contiennent des valeurs Null, retournant un 0 pour les valeurs Null.

OVER ([<CLAUSE LIMIT DURATION de clause>>< PARTITION BY [<clause> WHEN]]

Détermine le groupe de lignes sur lequel COUNT est appliqué. La clause PARTITION BY spécifie que les lignes avec la même clé de partition seront regroupées. La clause LIMIT DURATION spécifie la quantité d’historique incluse dans le groupe. La clause WHEN spécifie une condition booléenne pour que les lignes soient incluses dans le groupe. Pour plus d’informations sur l’utilisation, consultez la clause OVER .

Remarques

  • COUNT(*) retourne le nombre d’événements, y compris les valeurs NULL et les doublons.

  • COUNT(ALL expression) et COUNT(expression) évaluent l’expression pour chaque événement d’un groupe et retourne le nombre de valeurs non Null.

  • COUNT(DISTINCT expression) évalue l’expression pour chaque événement d’un groupe et retourne le nombre de valeurs uniques et non Null.

  • COUNT(input_stream) équivaut à COUNT() et COUNT(*), mais COUNT(DISTINCT input_stream) compte uniquement les événements uniques.

  • L’expression COUNT(DISTINCT) n’est pas prise en charge en tant que fonction analytique. Autrement dit, vous ne pouvez pas utiliser l’expression COUNT(DISTINCT) avec la clause OVER.

Types de retour

bigint

Exemples

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

Voir aussi

CLAUSE GROUP BY
CLAUSE OVER