dcountif() (fonction d’agrégation)

Estime le nombre de valeurs distinctes d’expr pour les lignes dans lesquelles le trueprédicat est évalué .

Les valeurs Null sont ignorées et ne sont pas prises en compte dans le calcul.

Remarque

Cette fonction est utilisée conjointement avec l’opérateur de synthèse.

Syntaxe

dcountif(expr, prédicat, [, précision])

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Type	Requise	Description
expr	string	✔️	Expression utilisée pour le calcul d’agrégation.
prédicat	string	✔️	Expression utilisée pour filtrer les lignes.
exactitude	int		Contrôle entre vitesse et précision. Si la valeur n’est pas spécifiée, la valeur par défaut est 1. Consultez la précision de l’estimation pour connaître les valeurs prises en charge.

Retours

Retourne une estimation du nombre de valeurs distinctes d’expr pour les lignes dans lesquelles le trueprédicat prend la valeur .

Conseil

dcountif() peut retourner une erreur dans les cas où toutes ou aucune des lignes ne passent l’expression Predicate .

Exemple

Cet exemple montre le nombre de types d’événements de tempête irrécupérables qui se sont produits dans chaque état.

Exécuter la requête

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

Le tableau des résultats indiqué inclut uniquement les 10 premières lignes.

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

Exactitude d’estimation

Cette fonction utilise une variante de l’algorithme HyperLogLog (HLL), qui effectue une estimation stochastique de la cardinalité définie. L’algorithme fournit un « bouton » qui peut être utilisé pour équilibrer la précision et la durée d’exécution par taille de mémoire :

Précision	Erreur (%)	Nombre d’entrées
0	1.6	212
1	0,8	214
2	0.4	216
3	0,28	217
4	0.2	218

Remarque

La colonne « Nombre d’entrées » indique le nombre de compteurs sur 1 octet dans l’implémentation de HLL.

L’algorithme inclut certaines dispositions pour effectuer un décompte parfait (zéro erreur) si la cardinalité définie est suffisamment petite :

• Lorsque le niveau d’exactitude est 1, 1 000 valeurs sont retournées
• Lorsque le niveau d’exactitude est 2, 8 000 valeurs sont retournées

La limite d’erreur est probabiliste, non théorique. La valeur est l’écart type de distribution des erreurs (sigma), et 99,7 % des estimations auront une erreur relative inférieure à 3 x sigma.

L’illustration suivante montre la fonction de distribution des probabilités de l’erreur d’estimation relative, en pourcentage, pour tous les paramètres d’exactitude pris en charge :