TopPercent (MDX)

セットを降順で並べ替え、累積合計が指定された割合以上になるように、値の大きい方から組のセットを作成して返します。

構文

TopPercent(Set_Expression, Percentage, Numeric_Expression) 

引数

• Set_Expression
  セットを返す有効な多次元式 (MDX) 式です。

• Percentage
  返す組の割合を指定する有効な数値式です。

  重要
  Percentage は、正の値である必要があります。負の値の場合はエラーになります。

• Numeric_Expression
  有効な数値式です。通常は、数値を返すセル座標の多次元式 (MDX 式) です。

説明

TopPercent 関数は、指定されたセットに対して評価した、指定された数値式の合計を計算し、そのセットを降順に並べ替えます。 次に、合計値の累積割合が指定されている割合以上になるように、最も値の大きい方から要素を返します。 この関数は、累積合計が指定された割合以上になるセットの最小サブセットを返します。 要素は大きい方から順に返されます。

注意
Numeric_Expression が負の値を返す場合、TopPercent は 1 行だけを返します。 この動作の詳細な説明については、2 番目の例を参照してください。

重要
TopPercent 関数は、BottomPercent 関数と同様に、常に階層を解除します。

使用例

次の例は、Bike カテゴリで、再販業者の売上の上位 10% に最も貢献している都市を返します。 結果は、降順で並べ替えられ、売上が最高値である都市が先頭になります。

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])

上の式の結果は、次のようになります。

元のデータのセットは、次のクエリで取得でき、588 行が返されます。

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])

使用例

次のチュートリアルでは、Numeric_Expression における負の値の影響を理解できます。 まず、この動作を実行できる、いくつかのコンテキストを構築します。

次のクエリは、Reseller の 'Sales Amount'、'Total Product Cost'、および 'Gross Profit' のテーブルを、利益で降順に並べ替えて返します。 利益には負の値しかないので、損失の少ないものが上位に表示されます。

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]

上記のクエリは、次の結果を返します。見やすくするために、中間部の行は削除してあります。

このとき、利益で上位 100% の自転車を提示するように求められた場合、クエリは次のように記述されます。

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]

クエリで 100% が要求されていることに注意してください。つまり、すべての行が返される必要があります。 しかし、Numeric_Expression に負の値があるため、1 つの行だけが返されます。

関連項目

参照

MDX 関数リファレンス (MDX)