TOPNTOPN

Retourne les N premières lignes de la table spécifiée.Returns the top N rows of the specified table.

SyntaxeSyntax

TOPN(<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).

Consultez la section Notes pour comprendre quand le nombre de lignes retournées peut être supérieur à n_value.See the remarks section to understand when the number of rows returned could possible be larger than n_value.

Consultez la section Notes pour comprendre quand une table vide est retournée.See the remarks section to understand when an empty table is returned.

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

orderBy_expressionorderBy_expression
Toute expression DAX où la valeur de résultat est utilisée pour trier la table et est évaluée pour chaque ligne de la table.Any DAX expression where the result value is used to sort the table and it 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

Une table avec les N premières lignes de table ou une table vide si n_value a une valeur égale ou inférieure à 0 (zéro).A table with the top N rows of table or an empty table if n_value is 0 (zero) or less. Les lignes ne sont pas nécessairement triées dans un ordre particulier.Rows are not necessarily sorted in any particular order.

ConcernantRemarks

  • S’il existe un lien entre les valeurs order_by et la N-ième ligne de la table, toutes les lignes liées sont retournées.If there is a tie, in order_by values, at the N-th row of the table, then all tied rows are returned. Ensuite, lorsqu’il y a des liens au niveau de la N-ième ligne, la fonction peut retourner plus de N lignes.Then, when there are ties at the N-th row the function might return more than n rows.

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

  • TOPN ne garantit pas l’ordre de tri des résultats.TOPN does not guarantee any sort order for the results.

ExampleExample

L’exemple suivant crée une mesure avec les ventes des 10 produits les plus vendus.The following sample creates a measure with the sales of the top 10 sold products.

=SUMX(TOPN(10, SUMMARIZE(Product, [ProductKey], “TotalSales”, SUMX(RELATED(InternetSales_USD[SalesAmount_USD]), InternetSales_USD[SalesAmount_USD]) + SUMX(RELATED(ResellerSales_USD[SalesAmount_USD]), ResellerSales_USD[SalesAmount_USD]))