Dela via

dcountif() (sammansättningsfunktion)

Gäller för: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Beräknar antalet distinkta värden för för rader där predikat utvärderas till true.

Null-värden ignoreras och tar inte hänsyn till beräkningen.

Not

Den här funktionen används tillsammans med operatorn summarize.

Syntax

dcountif ( uttr, predikat, [,noggrannhet])

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Krävs Beskrivning
uttr string ✔️ Uttrycket som används för aggregeringsberäkningen.
predikat string ✔️ Uttrycket som används för att filtrera rader.
noggrannhet int Kontrollen mellan hastighet och noggrannhet. Om det är ospecificerat är standardvärdet 1. Mer information om värden som stöds finns i Noggrannhet för uppskattning.

Returnerar

Returnerar en uppskattning av antalet distinkta värden för uttr för rader där predikat utvärderas till true.

Dricks

dcountif() kan returnera ett fel i fall där alla eller ingen av raderna skickar Predicate-uttrycket.

Exempel

I följande exempel visas hur många typer av allvarliga stormhändelser som inträffat i varje tillstånd.

Kör frågan

StormEvents
| summarize DifferentFatalEvents=dcountif(EventType,(DeathsDirect + DeathsIndirect)>0) by State
| where DifferentFatalEvents > 0
| order by DifferentFatalEvents

Resultattabellen som visas innehåller endast de första 10 raderna.

Stat DifferentFatalEvents
KALIFORNIEN 12
TEXAS 12
OKLAHOMA 10
ILLINOIS 9
KANSAS 9
NEW YORK 9
NEW JERSEY 7
WASHINGTON 7
MICHIGAN 7
MISSOURI 7
... ...

Uppskattningsnoggrannhet

Den här funktionen använder en variant av algoritmen HyperLogLog (HLL), som gör en stokastisk uppskattning av uppsättningens kardinalitet. Algoritmen ger en "knopp" som kan användas för att balansera noggrannhet och körningstid per minnesstorlek:

Noggrannhet Fel (%) Antal poster
0 1.6 212
1 0,8 214
2 0,4 216
3 0.28 217
4 0.2 218

Not

Kolumnen "antal poster" är antalet 1 byte-räknare i HLL-implementeringen.

Algoritmen innehåller vissa bestämmelser för att göra ett perfekt antal (noll fel), om den inställda kardinaliteten är tillräckligt liten:

  • När noggrannhetsnivån är 1returneras 1 000 värden
  • När noggrannhetsnivån är 2returneras 8 000 värden

Felgränsen är probabilistisk, inte en teoretisk bindning. Värdet är standardavvikelsen för felfördelningen (sigma) och 99,7% av uppskattningarna har ett relativt fel på under 3 x sigma.

Följande bild visar sannolikhetsfördelningsfunktionen för det relativa uppskattningsfelet, i procent, för alla noggrannhetsinställningar som stöds:

Graph som visar hll-felfördelningen.

Relaterat innehåll