TopCount (MDX)

Sorts a set in descending order and returns the specified number of elements with the highest values.

Syntax

TopCount(Set_Expression,Count [ ,Numeric_Expression ] )

Arguments

  • Set_Expression
    A valid Multidimensional Expressions (MDX) expression that returns a set.
  • Count
    A valid numeric expression that specifies the number of tuples to be returned.
  • Numeric_Expression
    A valid numeric expression that is typically a Multidimensional Expressions (MDX) expression of cell coordinates that return a number.

Remarks

If a numeric expression is specified, the TopCount function sorts, in descending order, the tuples in the set specified by the specified set according to the value specified by the numeric expression, as evaluated over the specified set. After sorting the set, the TopCount function then returns the specified number of tuples with the highest value.

Important

Like the BottomCount function, the TopCount function always breaks the hierarchy.

If a numeric expression is not specified, the function returns the set of members in natural order, without any sorting, behaving like the Head (MDX) function.

Example

The following example returns, for the Bike category, the first five members in the set of members of the City level in the Geography hierarchy in the Geography dimension for fiscal year 2003 ordered by the Reseller Sales Amount measure (beginning with the members of this set with the largest number of sales).

SELECT TopCount
   ({[Geography].[Geography].[City].Members 
      *[Date].[Fiscal].[Fiscal Year].[FY 2003]}
   , 5
   , [Measures].[Reseller Sales Amount]
   ) ON 0,
   [Product].[Product Categories].Bikes ON 1
FROM [Adventure Works]

See Also

Reference

MDX Function Reference (MDX)

Help and Information

Getting SQL Server 2005 Assistance

Change History

Release History

17 July 2006

Changed content:
  • Updated syntax and arguments to improve clarity.
  • Added updated examples.