count_distinct() (Aggregationsfunktion) – (Vorschau)

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Zählt eindeutige Werte, die vom skalaren Ausdruck pro Zusammenfassungsgruppe angegeben werden, oder die Gesamtanzahl eindeutiger Werte, wenn die Zusammenfassungsgruppe weggelassen wird.

Nullwerte werden ignoriert und nicht in die Berechnung berücksichtigt.

Hinweis

Diese Funktion wird zusammen mit dem Zusammenfassungsoperator verwendet.

Wenn Sie nur eine Schätzung der Anzahl eindeutiger Werte benötigen, empfehlen wir die Verwendung der weniger ressourcenaufwendigen dcount Aggregationsfunktion.

Um nur Datensätze zu zählen, für die ein Prädikat zurückgegeben wird true, verwenden Sie die count_distinctif Aggregationsfunktion.

Hinweis

• Diese Funktion ist auf 100M eindeutige Werte beschränkt. Ein Versuch, die Funktion auf einen Ausdruck anzuwenden, der zu viele Werte zurückgibt, erzeugt einen Laufzeitfehler (HRESULT: 0x80DA0012).

• Die Funktionsleistung kann beeinträchtigt werden, wenn sie auf mehreren Datenquellen aus verschiedenen Eventhouses ausgeführt wird.

Syntax

count_distinct(Ausdruck)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
expr	Skalarwert	✔️	Der Ausdruck, dessen eindeutige Werte gezählt werden sollen.

Gibt zurück

Long integer value indicating the number of unique values of expr pro summary group.

Beispiel

In diesem Beispiel wird gezeigt, wie viele Arten von Sturmereignissen in jedem Zustand aufgetreten sind.

Ausführen der Abfrage ::: moniker-end

StormEvents
| summarize UniqueEvents=count_distinct(EventType) by State
| top 5 by UniqueEvents

Output

State	UniqueEvents
TEXAS	27
CALIFORNIA	26
PENNSYLVANIA	25
GEORGIA	24
NORTH CAROLINA	23