SAMPLE

s’applique à :colonne calculéetable calculéemesurecalcul visuel

Retourne un exemple de lignes N 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 d’une expression DAX qui retourne une valeur scalaire unique, où l’expression doit être évaluée plusieurs fois (pour chaque ligne/contexte). Si une valeur non entière (ou expression) est entrée, le résultat est casté en tant qu’entier.
table	Toute expression DAX qui retourne une table de données à partir de laquelle extraire les exemples de lignes « n ».
orderBy_expression	Toute expression DAX scalaire où la valeur de résultat est évaluée pour chaque ligne de table.
order	(Facultatif) Valeur qui spécifie comment trier orderBy_expression valeurs, croissant ou décroissant : 0 (zéro), trie dans l’ordre décroissant des valeurs de order_by. 1, rang dans l’ordre croissant de order_by.

Valeur de retour

Table composée d’un échantillon de lignes N de table ou d’une table vide si n_value est de 0 (zéro) ou moins. Si les arguments OrderBy sont fournis, l’exemple est stable et déterministe, retournant la première ligne, la dernière ligne et les lignes réparties uniformément entre elles. Si aucun ordre n’est spécifié, l’échantillon sera aléatoire, non stable et non déterministe.

Notes

• Si n_value est égal à 0 (zéro) ou moins, SAMPLE retourne une table vide.

• Pour éviter les valeurs dupliquées dans l’exemple, la table fournie en tant que deuxième argument doit être regroupée par la colonne utilisée pour le tri.

• Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery lorsqu’elle est utilisée dans les colonnes calculées ou les règles de sécurité au niveau des lignes (RLS).