Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
s’applique à :
colonne calculée
table calculée
mesure
calcul visuel
Retourne un estimation nombre de valeurs uniques dans une colonne.
Important
La prise en charge des APPROXIMATEDISTINCTCOUNT modes Import et Direct Lake Storage est actuellement en préversion.
Syntaxe
APPROXIMATEDISTINCTCOUNT(<columnName>)
Paramètres
| Terme | Description |
|---|---|
column |
Colonne d’entrée. |
L’argument column ne peut pas être une expression.
Valeur de retour
Nombre approximatif de valeurs distinctes dans column.
Remarques
Le seul argument de cette fonction est une colonne. Utilisez des colonnes contenant n’importe quel type de données. Lorsque la fonction ne trouve aucune ligne à compter, elle retourne un
BLANK; sinon, elle retourne le nombre de valeurs distinctes.En mode Importation, Direct Lake sur OneLake et Direct Lake sur SQL sans secours, la fonction utilise un algorithme HyperLogLog côté moteur.
En mode DirectQuery, la fonction appelle une opération d’agrégation correspondante dans la source de données. Ce comportement est pris en charge pour Azure SQL, Azure Synapse pool SQL dédié, BigQuery, Databricks et Snowflake. Direct Lake sur SQL utilise ce comportement DirectQuery lorsqu’il revient en mode DirectQuery.
Utilisez cette fonction pour les colonnes à cardinalité élevée lorsqu’un résultat approximatif est acceptable. Utilisez DISTINCTCOUNT quand vous avez besoin d’un résultat exact.
Pour les colonnes à faible cardinalité,
APPROXIMATEDISTINCTCOUNTpeut s’exécuter plus lentement queDISTINCTCOUNT. Il peut également utiliser plus de mémoire queDISTINCTCOUNT, en particulier avec des modèles volumineux, une concurrence élevée ou de nombreux groupes de groupes.Le nombre estimé retourné par
APPROXIMATEDISTINCTCOUNTun taux d’erreur d’environ 1,6% pour les modèles Import et Direct Lake.