Lire en anglais

Partager via


SAMPLE

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

Retourne une sample 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 seule valuescalaire, où l’expression doit être évaluée plusieurs fois (pour chaque ligne/contexte). If un value non entier (expressionor) est entré, 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 lignes sample 'n'.
orderBy_expression Toute expression DAX scalaire où le résultat value est évalué pour chaque ligne de table.
order (Facultatif) Un value qui spécifie comment trier orderBy_expressionvalues, croissant or décroissant : 0 (zéro), trie dans l’ordre décroissant de values de order_by. 1, rang dans l’ordre croissant de order_by.

Retourner value

Une table composée d’une sample de lignes N de tableor une table vide ifn_value est de 0 (zéro) or moins. If OrderBy arguments sont fournis, le sample sera stable and déterministe, retournant la ligne first, la ligne last, and lignes réparties uniformément entre elles. If aucune commande n’est spécifiée, la sample sera aléatoire, not stable, andnot déterministe.

Notes

  • If n_value est inférieur à 0 (zéro) or moins, SAMPLE retourne une table vide.

  • Pour éviter les values dupliquées dans la sample, la table fournie en tant qu’argument second doit être regroupée par la colonne utilisée pour le tri.

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