Database Journal
MS SQL Oracle DB2 Access MySQL PostgreSQL Sybase PHP SQL Etc SQL Scripts & Samples Tips Database Forum Rss Feed

» Database Journal Home
» Database Articles
» Database Tutorials
MS Access
SQL Scripts & Samples
» Database Forum
» Slideshows
Free Newsletters:

News Via RSS Feed

Rss Feed

Database Journal |DBA Support |SQLCourse |SQLCourse2

Featured Database Articles


Posted Mar 3, 2008

Set Functions: The AddCalculatedMembers() Function

By William Pearson

About the Series ...

This article is a member of the series, MDX Essentials. The series is designed to provide hands-on application of the fundamentals of the Multidimensional Expressions (MDX) language, with each tutorial progressively adding features designed to meet specific real-world needs.

For more information about the series in general, as well as the software and systems requirements for getting the most out of the lessons included, please see my first article, MDX at First Glance: Introduction to MDX Essentials.

Note: Current updates are assumed for MSSQL Server, MSSQL Server Analysis Services, and the related Books Online and Samples.


In this lesson, we will introduce AddCalculatedMembers(), a basic, but highly useful, set function in the MDX toolset. The general purpose of AddCalculatedMembers() is to retrieve the base members of a specified set, together with all sibling calculated members.

AddCalculatedMembers() can be leveraged in a wide range of activities, from the generation of simple lists to the support of sophisticated conditional and other calculations and presentations. We will introduce the function, commenting upon its operation and touching upon creative effects that we can employ it to deliver. As a part of our discussion, we will:

  • Examine the syntax surrounding the function;
  • Undertake illustrative examples of the uses of the function in practice exercises;
  • Briefly discuss the results datasets we obtain in the practice examples.

The AddCalculatedMembers() Function


According to the Analysis Services Books Online, the AddCalculatedMembers() function “returns a set generated by adding calculated members to a specified set.” AddCalculatedMembers() has numerous applications. For example, the function can be leveraged within queries to create datasets, in reporting applications such as MSSQL Server Reporting Services, for the support of picklists within the reports, for the support of axes within various end presentations, and so forth. The AddCalculatedMembers() function provides an intuitive option anytime we need to present, in a returned dataset, all members – including calculated members – that belong to a specified set. (When we employ a metadata-based MDX function to specify a set for retrieval, the default behavior we would expect would be that only base members, and specifically not calculated members, of the set are returned.

As we have noted to have been the case with many individual MDX functions we have examined within this series, combining AddCalculatedMembers() with other functions allows us to further extend its power. We will get a taste of this synergy in the practice exercises that follow.

We will examine the syntax for the AddCalculatedMembers() function after a brief discussion in the next section. We will then explore, from the straightforward context of MDX queries, and within practice examples constructed to support hypothetical business needs, some of the uses it offers the knowledgeable user. This will allow us to activate what we explore in the Discussion and Syntax sections, where we will get some hands-on exposure in creating expressions that employ the AddCalculatedMembers() function.


To restate our initial explanation of its operation, the AddCalculatedMembers() function examines a set expression that we specify and returns its base members, along with sibling calculated members, contained within the scope of that set expression. AddCalculatedMembers() can be used for a great deal more than simple list retrieval, as we have intimated. When coupled with other functions or used within MDX scripts, among other applications, we can leverage AddCalculatedMembers() to support a wide range of analysis and reporting utility.

Let’s discuss syntax to further clarify the operation of AddCalculatedMembers().


Syntactically, in using the AddCalculatedMembers() function to return a set of members (including sibling calculated members), the set expression upon which we seek to apply the function is specified within the parentheses to the right of the AddCalculatedMembers keyword. The function takes the set expression (a valid MDX expression that returns a set) enclosed within the parentheses, and returns a set representing both the base members and the calculated members contained within the scope of the set expression.

The general syntax for the application of AddCalculatedMembers() appears in the following string:

 AddCalculatedMembers( <<Set_Expression>> )

Putting AddCalculatedMembers() to work is straightforward. When using the function to return the base, and sibling calculated, members contained within the set expression we have provided, we simply supply the required set expression within the parentheses to the right of the AddCalculatedMembers keyword. As an example, say we specify, within a query executed against the sample Adventure Works cube, a column axis containing the Clothing Product Category, with a row axis such as the following:

 ADDCALCULATEDMEMBERS({[Measures].[Internet Sales Amount]}) 
  ON AXIS (1) 

Moreover, say that we add a WHERE clause to filter the retrieved data set to Calendar Year 2004. Depending upon the calculated members we have defined within our cube (we might have added calculated members beyond those that appear in the pristine sample cube), we would expect to retrieve results similar to those depicted in Illustration 1.

Illustration 1: Example Returned Data: AddCalculatedMember() Function Employed in Query

We can see, within the dataset returned above, that, in addition to the single base measure, [Measures].[Internet Sales], contained within the set we have specified above, we also see the calculated members appear that lie within the scope of the set. We can verify that the appropriate calculated members are included by opening the Adventure Works cube within the Cube Designer, going to the Calculations tab, and examining the calculated members that appear, as partially shown in Illustration 2.

Illustration 2: Calculated Members within the Scope of Our Specified Set Expression

(Partial View)

Because all calculated members that appear within the retrieved data set share the same parent, [Measures], they are siblings of the base member, and are thus selected through our use of AddCalculatedMembers().

Because of the relative ease with which we can employ AddCalculatedMembers(), and because of the flexibility with which we can exploit it to meet various business needs (particularly those meeting metadata requirements), the function becomes a popular member of our analysis and reporting toolsets. We will practice some uses of the AddCalculatedMembers() function in the section that follows.

MS SQL Archives

Latest Forum Threads
MS SQL Forum
Topic By Replies Updated
SQL 2005: SSIS: Error using SQL Server credentials poverty 3 August 17th, 07:43 AM
Need help changing table contents nkawtg 1 August 17th, 03:02 AM
SQL Server Memory confifuration bhosalenarayan 2 August 14th, 05:33 AM
SQL Server Primary Key and a Unique Key katty.jonh 2 July 25th, 10:36 AM