COUNT (Azure Stream Analytics)

  • Artikel

Gibt die Anzahl von Elementen in einer Gruppe zurück. COUNT gibt immer einen Wert des Datentyps "bigint" zurück.

Syntax

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

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

Argumente

ALL

Wendet die Aggregatfunktion auf alle Werte an. ALL ist die Standardeinstellung.

DISTINCT

Gibt an, dass COUNT die Anzahl eindeutiger Werte ohne NULL zurückgibt.

expression

Ein Ausdruck eines beliebigen Typs oder ein Spaltenname. Aggregatfunktionen und Unterabfragen sind unzulässig.

* (Wildcard-Ausdruck)

Gibt an, dass alle Ereignisse gezählt werden sollen, um die Gesamtanzahl von Ereignissen in einer Gruppe zurückzugeben. COUNT(*) nimmt keine Parameter an. COUNT(*) erfordert keinen "expression"-Parameter, da definitionsgemäß keine Informationen über eine bestimmte Spalte verwendet werden. COUNT(*) gibt die Anzahl der Ereignisse zurück, ohne Duplikate zu entfernen. Jedes Ereignis wird separat zählt. Dies schließt Ereignisse ein, die NULL-Werte enthalten und eine 0 für NULL-Werte zurückgeben.

OVER ([<PARTITION BY-Klausel><LIMIT DURATION-Klausel> [<WHEN-Klausel>]]

Bestimmt die Gruppe von Zeilen, auf die COUNT angewendet wird. Die PARTITION BY-Klausel gibt an, dass die Zeilen mit demselben Partitionsschlüssel gruppiert werden. Die LIMIT DURATION-Klausel gibt an, wie viel Verlauf in der Gruppe enthalten ist. Die WHEN-Klausel gibt eine boolesche Bedingung für die Zeilen an, die in die Gruppe eingeschlossen werden sollen. Weitere Informationen zur Verwendung finden Sie unter OVER-Klausel .

Hinweise

  • COUNT(*) gibt die Anzahl der Ereignisse zurück, einschließlich NULL-Werten und Duplikaten.

  • COUNT(ALL expression) und COUNT(expression) wertet den Ausdruck für jedes Ereignis in einer Gruppe aus und gibt die Anzahl von Werten ungleich NULL zurück.

  • COUNT(DISTINCT expression) wertet den Ausdruck für jedes Ereignis in einer Gruppe aus und gibt die Anzahl eindeutiger Werte zurück, die nicht NULL sind.

  • COUNT(input_stream) entspricht COUNT() und COUNT(*), count(DISTINCT input_stream) zählt jedoch nur eindeutige Ereignisse.

  • COUNT(DISTINCT-Ausdruck) wird als Analysefunktion nicht unterstützt. Das heißt, Sie können COUNT(DISTINCT-Ausdruck) nicht mit der OVER-Klausel verwenden.

Rückgabetypen

BIGINT

Beispiele

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

Weitere Informationen

GROUP BY-Klausel
OVER-Klausel