count_distinct() (funkcja agregacji) — (wersja zapoznawcza)

Zlicza unikatowe wartości określone przez wyrażenie skalarne na grupę podsumowania lub łączną liczbę unikatowych wartości, jeśli grupa podsumowania zostanie pominięta.

Wartości null są ignorowane i nie są uwzględniane w obliczeniu.

Uwaga

Ta funkcja jest używana w połączeniu z operatorem podsumowania.

Jeśli potrzebujesz tylko oszacowania liczby unikatowych wartości, zalecamy użycie funkcji agregacji mniejszej ilości dcount zasobów.

Aby zliczyć tylko rekordy, dla których predykat zwraca wartość true, użyj funkcji agregacji count_distinctif .

Uwaga

  • Ta funkcja jest ograniczona do 100 mln unikatowych wartości. Próba zastosowania funkcji w wyrażeniu zwracającym zbyt wiele wartości spowoduje wystąpienie błędu środowiska uruchomieniowego (HRESULT: 0x80DA0012).
  • Wydajność funkcji może być obniżona w przypadku działania na wielu źródłach danych z różnych klastrów.

Składnia

count_distinct(Expr)

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa Typ Wymagane Opis
Expr Wartość skalarna ✔️ Wyrażenie, którego unikatowe wartości mają być zliczane.

Zwraca

Długa wartość całkowita wskazująca liczbę unikatowych wartości wyrażenia na grupę podsumowania.

Przykład

W tym przykładzie pokazano, ile typów zdarzeń burzy miało miejsce w każdym stanie.

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

Dane wyjściowe

Stan UniqueEvents
TEXAS 27
KALIFORNII 26
PENNSYLVANIA 25
GRUZJA 24
KAROLINA PÓŁNOCNA 23