count_distinctif() (Aggregationsfunktion) – (Vorschau)

  • Artikel

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.

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 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.

Abfrage ausführen

StormEvents
| summarize UniqueFatalEvents=count_distinctif(EventType,(DeathsDirect + DeathsIndirect)>0) by State
| where UniqueFatalEvents > 0
| top 5 by UniqueFatalEvents

Ausgabe

Staat UniqueFatalEvents
TEXAS 12
CALIFORNIA 12
OKLAHOMA 10
NEW YORK 9
KANSAS 9