Head (MDX)

Updated: 17 July 2006

Returns the first specified number of elements in a set, while retaining duplicates.

Head(Set_Expression [ ,Count ] )


A valid Multidimensional Expressions (MDX) expression that returns a set.


A valid numeric expression that specifies the number of tuples to be returned.

The Head function returns the specified number of tuples from the beginning of the specified set. The order of elements is preserved. The default value of Count is 1. If the specified number of tuples is less than 1, the Head function returns an empty set. If the specified number of tuples exceeds the number of tuples in the set, the function returns the original set.


The following example returns the Reseller Sales Measure for the top five selling subcategories of products, irrespective of hierarchy, based on Reseller Gross Profit. The Head function is used to return only the first 5 sets in the result after the result is ordered using the Order function.

      ([Product].[Product Categories].[SubCategory].members
         ,[Measures].[Reseller Gross Profit]
   ) ON 0
FROM [Adventure Works]

Release History

17 July 2006

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

Community Additions