count_distinctif() (Aggregationsfunktion) – (Vorschau)
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Zählt bedingte eindeutige Werte, die vom skalaren Ausdruck pro Zusammenfassungsgruppe angegeben werden, oder die Gesamtanzahl eindeutiger Werte, wenn die Zusammenfassungsgruppe weggelassen wird. Es werden nur Datensätze gezählt, für die das Prädikat ausgewertet true
wird.
Wenn Sie nur eine Schätzung der Anzahl eindeutiger Werte benötigen, empfehlen wir die Verwendung der weniger ressourcenaufwendigen Dcountif-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 Clustern ausgeführt wird.
- Die Funktionsleistung kann beeinträchtigt werden, wenn sie auf mehreren Datenquellen aus verschiedenen Eventhouses ausgeführt wird.
Syntax
count_distinctif
(
Ausdrucks-Prädikat,
)
Erfahren Sie mehr über Syntaxkonventionen.
Parameter
Name | Type | Erforderlich | Beschreibung |
---|---|---|---|
expr | Skalarwert | ✔️ | Der Ausdruck, dessen eindeutige Werte gezählt werden sollen. |
Prädikat | string |
✔️ | Der Ausdruck, der zum Filtern von Datensätzen verwendet wird, die aggregiert werden sollen. |
Gibt zurück
Ganzzahliger Wert, der die Anzahl eindeutiger Werte des Ausdrucks pro Sammelgruppe angibt, für alle Datensätze, für die das Prädikat ausgewertet wird true
.
Beispiel
In diesem Beispiel wird gezeigt, wie viele Arten von Todesursachen zu Sturmereignissen in jedem Zustand aufgetreten sind. Nur Sturmereignisse mit einer Nichtzeroanzahl der Todesfälle werden gezählt.
Hinweis
Die Funktionsleistung kann beeinträchtigt werden, wenn sie auf mehreren Datenquellen aus verschiedenen Clustern ausgeführt wird.
StormEvents
| summarize UniqueFatalEvents=count_distinctif(EventType,(DeathsDirect + DeathsIndirect)>0) by State
| where UniqueFatalEvents > 0
| top 5 by UniqueFatalEvents
Ausgabe
State | UniqueFatalEvents |
---|---|
TEXAS | 12 |
CALIFORNIA | 12 |
OKLAHOMA | 10 |
NEW YORK | 9 |
KANSAS | 9 |