SAMPLE
S’applique à :
Colonne calculéeTable calculéeMesureCalcul de visuel
Retourne un échantillon de n lignes de la table spécifiée.
Syntaxe
SAMPLE(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])
Paramètres
| Terme | Définition |
|---|---|
| n_value | Nombre de lignes à retourner. Il s’agit de toute expression DAX qui retourne une valeur scalaire unique quand l’expression doit être évaluée plusieurs fois (pour chaque ligne/contexte). Si une valeur (ou expression) non entière est entrée, le résultat est converti en entier. |
| table | Toute expression DAX qui retourne une table de données à partir de laquelle extraire les « n » lignes d’échantillon. |
| orderBy_expression | Toute expression DAX scalaire où la valeur obtenue est évaluée pour chaque ligne de la table. |
| order | (Facultatif) Valeur qui spécifie comment trier les valeurs orderBy_expression, par ordre croissant ou décroissant : 0 (zéro), trie par ordre décroissant les valeurs order_by. 1, classe dans l’ordre croissant de order_by. |
Valeur renvoyée
Une table contenant les n lignes d’échantillon de table, ou une table vide si la valeur n_value est inférieure ou égale à 0 (zéro). Si des arguments OrderBy sont fournis, l’exemple est stable et déterministe ; il retourne la première ligne, la dernière ligne et les lignes uniformément réparties entre elles. Si aucun classement n’est spécifié, l’échantillon est aléatoire, non stable et non déterministe.
Notes
Si n_value est inférieur ou égal à 0 (zéro), SAMPLE retourne une table vide.
Afin d’empêcher la duplication de valeurs dans l’échantillon, la table fournie en deuxième argument doit être groupée en fonction de la colonne utilisée pour le tri.
Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery quand elle est utilisée dans des colonnes calculées ou des règles de sécurité au niveau des lignes (RLS).