Freigeben über


count_distinct() (Aggregationsfunktion) – (Vorschau)

Gilt für: ✅Microsoft Fabric

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 Clustern ausgeführt wird.
  • 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.

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

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