count_distinctif() (fonction d’agrégation) - (préversion)
S’applique à : ✅Microsoft Fabric✅✅
Compte de manière conditionnelle des valeurs uniques spécifiées par l’expression scalaire par groupe de synthèse, ou le nombre total de valeurs uniques si le groupe de résumés est omis. Seuls les enregistrements pour lesquels le prédicat est évalué sont comptabilisés true .
Si vous avez uniquement besoin d’une estimation du nombre de valeurs uniques, nous vous recommandons d’utiliser la fonction d’agrégation dcountif moins consommatrice de ressources.
Remarque
- Cette fonction est limitée à 100M de valeurs uniques. Une tentative d’application de la fonction sur une expression retournant trop de valeurs génère une erreur d’exécution (HRESULT : 0x80DA0012).
- Les performances des fonctions peuvent être détériorées lors de l’exploitation sur plusieurs sources de données provenant de différents clusters.
- Les performances des fonctions peuvent être détériorées lors de l’exploitation sur plusieurs sources de données provenant de différents Eventhouses.
Syntaxe
count_distinctif
(
prédicat expr,)
En savoir plus sur les conventions de syntaxe.
Paramètres
| Nom | Type | Requise | Description |
|---|---|---|---|
| expr | scalaire | ✔️ | Expression dont les valeurs uniques doivent être comptées. |
| prédicat | string |
✔️ | Expression utilisée pour filtrer les enregistrements à agréger. |
Retours
Valeur entière indiquant le nombre de valeurs uniques d’exprpar groupe de synthèse, pour tous les enregistrements pour lesquels le prédicat est trueévalué .
Exemple
L’exemple suivant montre le nombre de types d’événements de tempête à l’origine de décès qui se sont produits dans chaque état. Seuls les événements de tempête dont le nombre de décès est différent de zéro sont comptabilisés.
Remarque
Les performances des fonctions peuvent être détériorées lors de l’exploitation sur plusieurs sources de données provenant de différents clusters.
StormEvents
| summarize UniqueFatalEvents=count_distinctif(EventType,(DeathsDirect + DeathsIndirect)>0) by State
| where UniqueFatalEvents > 0
| top 5 by UniqueFatalEvents
Sortie
| State | UniqueFatalEvents |
|---|---|
| TEXAS | 12 |
| CALIFORNIE | 12 |
| OKLAHOMA | 10 |
| NEW YORK | 9 |
| KANSAS | 9 |
Contenu connexe
- types de fonctions d’agrégation en un clin d’œil
- count_distinct() (fonction d’agrégation)
- countif() (fonction d’agrégation)
- dcountif() (fonction d’agrégation)