EXEMPLESAMPLE

Retourne un échantillon de N lignes de la table spécifiée.Returns a sample of N rows from the specified table.

SyntaxeSyntax

SAMPLE(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])  

les paramètresParameters

n_valuen_value
Nombre de lignes à retourner.The number of rows to return. Il s’agit de toute expression DAX qui retourne une valeur scalaire unique, où l’expression doit être évaluée plusieurs fois (pour chaque ligne/contexte).It is any DAX expression that returns a single scalar value, where the expression is to be evaluated multiple times (for each row/context). Si une valeur (ou expression) non entière est entrée, le résultat est converti en entier.If a non-integer value (or expression) is entered, the result is cast as an integer.

tableautable
Toute expression DAX qui retourne une table de données à partir de laquelle extraire les exemples de lignes « n ».Any DAX expression that returns a table of data from where to extract the ‘n’ sample rows.

orderBy_expressionorderBy_expression
Facultatif Toute expression DAX scalaire dans laquelle la valeur de résultat est évaluée pour chaque ligne de la table.(Optional) Any scalar DAX expression where the result value is evaluated for each row of table.

Ordreorder
Facultatif Valeur qui spécifie comment trier les valeurs orderBy_expression , croissant ou décroissant :(Optional) A value that specifies how to sort orderBy_expression values, ascending or descending:

ajoutéevalue autre valeuralternate value DescriptionDescription
0 (zéro)0 (zero) FAUXFALSE Trie dans l’ordre décroissant des valeurs de order_by.Sorts in descending order of values of order_by.

Il s’agit de la valeur par défaut lorsque le paramètre Order est omis.This is the default value when order parameter is omitted.
11 VRAITRUE Classement dans l’ordre croissant de order_by.Ranks in ascending order of order_by.

Valeur de retourReturn value

Tableau composé d’un échantillon de N lignes de table ou d’une table vide si n_value a une valeur égale à 0 (zéro) ou inférieure.A table consisting of a sample of N rows of table or an empty table if n_value is 0 (zero) or less. Si des arguments OrderBy sont fournis, l’exemple sera stable et déterministe, retournant la première ligne, la dernière ligne et uniformément réparti les lignes entre elles.If OrderBy arguments are provided, the sample will be stable and deterministic, returning the first row, the last row, and evenly distributed rows between them. Si aucun classement n’est spécifié, l’échantillon est aléatoire, non stable et non déterministe.If no ordering is specified, the sample will be random, not stable, and not deterministic.

ConcernantRemarks

  • Si n_value a la valeur 0 (zéro) ou moins, SAMPLE retourne une table vide.If n_value is 0 (zero) or less then SAMPLE returns an empty table.

  • Afin d’éviter les valeurs dupliquées dans l’exemple, la table fournie en tant que deuxième argument doit être regroupée en fonction de la colonne utilisée pour le tri.In order to avoid duplicate values in the sample, the table provided as the second argument should be grouped by the column used for sorting.