Fonction VALUES

Retourne une table d'une colonne qui contient les valeurs distinctes de la table ou colonne spécifiée. En d'autres termes, les valeurs dupliquées sont supprimées et seules des valeurs uniques sont retournées.

[!REMARQUE]

Cette fonction ne peut pas être utilisée pour retourner des valeurs dans une cellule ou colonne sur une feuille de calcul, mais vous pouvez l'utiliser comme une fonction intermédiaire, imbriquée dans une formule, pour obtenir une liste de valeurs distinctes qui peuvent être comptées, ou utilisée pour filtrer ou additionner d'autres valeurs.

Syntaxe

VALUES(<TableNameOrColumnName>)

Paramètres

Valeur de retour

Colonne de valeurs uniques.

Notes

Lorsque vous utilisez la fonction VALUES dans un contexte qui a été filtré, tel que dans un tableau croisé dynamique, les valeurs uniques retournées par VALUES sont affectées par le filtre. Par exemple, si vous filtrez par Region et retournez une liste des valeurs pour City, la liste inclura uniquement les villes dans les régions autorisées par le filtre. Pour retourner toutes les villes, indépendamment des filtres existants, vous devez utiliser la fonction ALL pour supprimer les filtres de la table. Le deuxième exemple illustre l'utilisation de la fonction ALL avec VALUES.

Fonctions connexes

Dans la plupart des scénarios, les résultats de la fonction VALUES sont identiques à ceux de la fonction DISTINCT. Les deux fonctions suppriment des doublons et retournent une liste des valeurs possibles dans la colonne spécifiée. Toutefois, la fonction VALUES peut également retourner un membre inconnu. Cette valeur inconnue est utile dans les cas où vous recherchez des valeurs distinctes dans une table associée, mais qu'une valeur utilisée dans la relation est absente dans une table. Dans la terminologie de base de données, il s'agit d'une violation de l'intégrité référentielle. De telles incompatibilités dans les données peuvent se produire facilement lorsqu'une table est mise à jour et que la table associée ne l'est pas.

Le tableau suivant résume l'incompatibilité entre les données qui peut se produire dans deux tables associées lorsque l'intégrité référentielle n'est pas préservée.

Si vous avez utilisé la fonction DISTINCT pour retourner une liste de dates du tableau croisé dynamique qui contient ces tables, seules deux dates sont retournées. Toutefois, si vous utilisez la fonction VALUES, la fonction retourne les deux dates plus un membre vide supplémentaire. Par ailleurs, toute ligne de la table MySales qui n'a pas de date correspondante dans la table MyOrders sera mise en correspondance avec ce membre inconnu.

Exemple

La formule suivante compte le nombre de factures uniques (commandes client) et produit les résultats suivants lorsqu'elle est utilisée dans un rapport qui inclut les noms de catégories des produits :

=COUNTROWS(VALUES('InternetSales_USD'[SalesOrderNumber]))

Voir aussi

Référence

Fonction FILTER

Fonction COUNTROWS (DAX)

Autres ressources

Fonctions de filtrage (DAX)