TopPercent (MDX)

Trie un jeu en ordre décroissant et retourne un jeu de tuples avec les valeurs les plus élevées dont le total cumulé est égal ou supérieur à un pourcentage spécifié.

Syntaxe

  
TopPercent(Set_Expression, Percentage, Numeric_Expression)   

Arguments

Set_Expression
Expression MDX (Multidimensional Expressions) valide qui retourne un jeu.

Percentage
Expression numérique valide qui précise le pourcentage de tuples à retourner.

Important

Le pourcentage doit être une valeur positive ; les valeurs négatives génèrent une erreur.

Numeric_Expression
Expression numérique valide qui correspond généralement à une expression MDX (Multidimensional Expressions) des coordonnées des cellules qui retournent un nombre.

Remarques

La fonction TopPercent calcule la somme de l’expression numérique spécifiée évaluée sur le jeu spécifié, en triant le jeu dans l’ordre décroissant. Elle retourne ensuite les éléments dotés des valeurs les plus élevées et dont le pourcentage cumulé du total de la valeur additionnée correspond au moins au pourcentage indiqué. Enfin, elle retourne le plus petit sous-ensemble d'un jeu dont le total cumulé est égal au moins au pourcentage précisé. Les éléments retournés sont triés du plus grand au plus petit.

Avertissement

Si Numeric_Expression renvoie une valeur négative, TopPercent ne retourne qu’une (1) ligne.

Consultez le deuxième exemple pour une présentation détaillée de ce comportement.

Important

Comme la fonction BottomPercent , la fonction TopPercent interrompt toujours la hiérarchie.

Exemples

R. Retourner TopPercent

L'exemple suivant retourne les villes les mieux classées représentant 10 % des ventes des revendeurs pour la catégorie Bike. Le résultat est trié par ordre décroissant, en commençant par la ville associé aux meilleures ventes.

SELECT [Measures].[Reseller Sales Amount] ON 0,  
TopPercent  
   ({[Geography].[Geography].[City].Members}  
   , 10  
   , [Measures].[Reseller Sales Amount]  
   ) ON 1  
FROM [Adventure Works]  
WHERE([Product].[Product Categories].[Bikes])  

L’expression ci-dessus produit les résultats suivants :

City Reseller Sales Amount
Toronto 3 508 904,84 $
London 1 521 530,09 $
Seattle 1 209 418,16 $
Paris 1 170 425,18 $

L'ensemble de données d'origine peut être obtenu avec la requête suivante et retourne 588 lignes :

SELECT [Measures].[Reseller Sales Amount] ON 0,  
Order  
   ({[Geography].[Geography].[City].Members}  
   , [Measures].[Reseller Sales Amount]  
   , BDESC  
   ) ON 1  
FROM [Adventure Works]  
WHERE([Product].[Product Categories].[Bikes])  
  

B. Comprendre l’effet des valeurs négatives

La procédure pas à pas suivante vous aidera à comprendre l’effet des valeurs négatives dans le Numeric_Expression. D'abord, établissons le contexte sous-jacent au comportement.

La requête suivante retourne une table contenant le montant des ventes (Sales Amount), le coût total du produit (Total Product Cost) et le profit brut (Gross Profit) des revendeurs, triés par ordre de profit décroissant. Notez qu'il y a uniquement des valeurs négatives pour les profits ; par conséquent, la plus petite perte apparaît en haut.

SELECT { [Measures].[Reseller Sales Amount], [Measures].[Reseller Total Product Cost], [Measures].[Reseller Gross Profit] } ON columns  
     ,  ORDER( [Product].[Product Categories].[Bikes].[Touring Bikes].children, [Measures].[Reseller Gross Profit], BDESC )   ON rows  
FROM [Adventure Works]  
  

La requête ci-dessus retourne les résultats suivants ; les lignes de la section centrale ont été supprimées pour faciliter la lisibilité.

Vélos de tourisme Reseller Sales Amount Reseller Total Product Cost Reseller Gross Profit
Touring-2000 Blue, 50 157 444,56 $ 163 112,57 $ (5 668,01 $)
Touring-2000 Blue, 46 321 027,03 $ 333 021,50 $ (11 994,47 $)
Touring-3000 Blue, 62 87 773,61 $ 100 133,52 $ (12 359,91 $)
... ... ... ...
Touring-1000 Yellow, 46 1 016 312,83 $ 1 234 454,27 $ (218 141,44 $)
Touring-1000 Yellow, 60 1 184 363,30 $ 1 443 407,51 $ (259 044,21 $)

Maintenant, si vous deviez présenter les vélos les mieux classés représentant 100 % du profit, vous écririez la requête suivante :

SELECT { [Measures].[Reseller Sales Amount], [Measures].[Reseller Total Product Cost], [Measures].[Reseller Gross Profit] } ON columns  
     ,  TOPPERCENT( [Product].[Product Categories].[Bikes].[Touring Bikes].children, 100,[Measures].[Reseller Gross Profit] )   ON rows  
FROM [Adventure Works]  
  

Notez que la requête demande cent pour cent (100 %) ; ce qui signifie que toutes les lignes doivent être retournées. Toutefois, étant donné qu’il existe des valeurs négatives dans le Numeric_Expression , une seule ligne est retournée.

Vélos de tourisme Reseller Sales Amount Reseller Total Product Cost Reseller Gross Profit
Touring-2000 Blue, 50 157 444,56 $ 163 112,57 $ (5 668,01 $)

Voir aussi

Guide de référence des fonctions MDX (MDX)