Please note javascript is required for full website functionality.

# Power Pivot Principles: Using USERELATIONSHIP to Activate an Inactive Relationship

31 March 2020

Welcome back to the Power Pivot Principles blog.  This week, we are going to learn a method of creating a virtual relationship in Power Pivot.

In Power Pivot, a physical relationship connects two tables through an equivalence over a single column.  The purpose of a relationship in a Tabular model is to filter through specific attributes between two different tables.  The engine automatically propagates the filter context in a query in terms of the active filter direction.  An inactive relationship is ignored, but can be manipulated by certain DAX functions.  This week, we are going to talk about the DAX function USERELATIONSHIP.

This function specifies an existing relationship to be used in the evaluation of a DAX expression.  The relationship is defined by naming, as arguments, the two columns that serve as endpoints.  It has the following syntax to operate:

USERELATIONSHIP (ColumnName1, ColumnName2)

where:

• ColumnName1 represents the foreign (or primary) key of the relationship
• ColumnName2 represents the primary (or foreign) key of the relationship.

It should be noted that the function returns no value.  It only enables the indicated relationship for the duration of the calculation.

Let’s look at a simple example.  Suppose we have following two tables, Calendar and Sales (neither displayed in full):

They have the following relationship:

In this case, the active relationship is setup between the field ‘Order Date’ in the Sales table and the field Date in Calendar table. Another relationship, which is inactive, is setup between the field ‘Ship Date’ in Sales table and the field Date in Calendar table. Typically, only one active relationship works in data modelling, however, we can use USERELATIONSHIP to make the inactive function active in a logic way.

We write the DAX syntax as following:

=CALCULATE(SUM(Sales[SalesAmount]),USERELATIONSHIP(Sales[Ship Date],'Calendar'[Date]))

In the measure above, we use the CALCULATE function to filter on the relationship established between ‘Ship Date’ in Sales and Date in CalendarUSERELATIONSHIP does not return any value, it only enables the inactive relationship to be active between the Sales and Calendar tables.

Then, we export the result as a PivotTable and use Year as the row and OrderDateSales and ShipDateSales as fields, with the following result:

As indicated by the PivotTable, the OrderDateSales shows the result of sales amount in accordance with the direct relationship and the ShipDateSales shows the result of the inactive relationship. The total sales value remains the same for both fields.

That’s it for this week!

Stay tuned for our next post on Power Pivot in the Blog section. In the meantime, please remember we have training in Power Pivot which you can find out more about here. If you wish to catch up on past articles in the meantime, you can find all of our Past Power Pivot blogs here.