Partager via

Fonction SAMPLE (DAX)

  • Article

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

  • n_value
    Nombre de lignes à retourner. Toute 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 une expression) est entrée, le résultat est converti en entier.

  • table
    Toute expression DAX qui retourne une table de données à partir de laquelle l'échantillon de « n » lignes doit être extrait.

  • orderBy_expression
    (Facultatif) Toute expression DAX scalaire où la valeur de résultat est évaluée pour chaque ligne de table.

  • order
    (Facultatif) Valeur qui spécifie le mode de tri des valeurs de orderBy_expression, croissant ou décroissant :

    valeur

    autre valeur

    Description

    0 (zéro)

    FALSE

    Tri dans l'ordre décroissant des valeurs de order_by.

    Il s'agit de la valeur par défaut lorsque le paramètre order est omis.

    1

    TRUE

    Classement dans l'ordre croissant des valeurs de order_by.

Valeur de retour

Table comprenant un échantillon de N lignes de table ou table vide si n_value est inférieur ou égal à 0 (zéro). Si des arguments OrderBy sont spécifiés, l'échantillon est stable et déterministe, retournant la première ligne, la dernière ligne et des lignes réparties équitablement entre elles. Si aucun tri 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.

  • Pour éviter les valeurs dupliquées dans l'échantillon, la table spécifiée comme deuxième argument doit être regroupée par la colonne utilisée pour le tri.