COUNT (Azure Stream Analytics)
Retourne le nombre d'éléments figurant dans un groupe. COUNT renvoie 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>])
Arguments
ALL
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 de tout type ou nom de colonne. Les fonctions d'agrégation et 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. La requête COUNT(*) ne nécessite pas de paramètre d'expression car, par définition, elle n'utilise pas d'informations sur une colonne particulière. COUNT(*) retourne le nombre d’événements sans supprimer les doublons. Il compte chaque événement séparément. Cela inclut les événements qui contiennent des valeurs null, renvoyant un 0 pour les valeurs Null.
OVER ([<CLAUSE LIMIT DURATION> de la 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 les lignes à inclure 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 retournent 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 non null.
COUNT(input_stream) équivaut à COUNT() et COUNT(*), mais COUNT(DISTINCT input_stream) compte uniquement les événements uniques.
COUNT(DISTINCT expression) n’est pas pris en charge en tant que fonction analytique. Autrement dit, vous ne pouvez pas utiliser COUNT(expression 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)