SSRS Lookup Function

This article will show you how to use the SSRS Lookup function and its advantages. Or, How to combine multiple datasets in the SSRS report. Or, How to work with multiple data sets in report creation using SSRS Lookup with an example.

We will use the below-shown DataSet to explain the SSRS lookup function. Please refer to the Embedded Data Source and Dataset articles to understand the steps involved in creating the Embedded Data Source and Dataset we used for this SSRS report.

Report DataSet

The report preview shows the data written by the custom SQL query we used in the above Dataset.

SSRS Lookup Example

To demonstrate the SSRS Lookup, we will use the previously designed report.

Please refer to the Table Report, Format Table Report article to understand the steps involved in creating Table Report & format, and add headers and Footer to the Report for adding Page headers and footers.

Table Report

First, let me show you the Report Preview.

Table Report Preview

The above report is the Client’s primary criteria, and suddenly, the client asked you to add the Department Name to the above report. As you know that the Employees table doesn’t have Department Name. Let me add another dataset.

To add the second data set, right-click on the Datasets folder and select the Add Dataset.. option from the context menu.

Add Second DataSet

The following screenshot will show you the Embedded Dataset that we are using for the SSRS lookup function.

DataSet Properties

You might tempt to add the Department name easily. Let me show you what will happen if I drag and drop the Department Name into the existing table.

Multiple DataSets Errors

The above screenshot shows that it is throwing an error because the report designer will only allow you to use only one dataset.

Now let me show you the ideal approach to do so. First, insert a column to the right side of a Sales column by right-clicking on the Sales column -> Insert Column -> Right

SSRS Lookup Function 7

before we go further, let me explain the SSRS Lookup function

Lookup Function in SSRS Example

The SSRS lookup function returns the matching records from the specified dataset. And the syntax is:

Lookup(Source_IDColumn, 
          Target_IDColumn, 
            Target_Column, 
                       Target_Dataset)
  • Source_IDColumn: It is similar to a Primary key. It is the Id column of the first data set.
  • Target_IDColumn: It is similar to a Foreign key column. It’s the Id column of the Second data set. SSRS Lookup function will check whether Source_IDColumn is equal to Target_IDColumn and if they match, then the corresponding Target_Column value will return
  • Target_Column: Column that you want to add to the existing table.
  • Target_Dataset: Second Dataset name.

Next, select the newly created column, and right-click on it to open the context menu. Please select the Expression option from it.

SSRS Lookup Function Expression

Once you select the Expression option, a new window called Expression will open. Use this expression window to write the SSRS lookup function.

=Lookup(Fields!DeptID.Value, 
          Fields!DeptID.Value, 
            Fields!DepartmentName.Value, 
                       "SQLTESTDepartmentDS")
SSRS Lookup Function Code

Once you have completed with lookup function, Click OK to close the window

SSRS Lookup Function 10

As you can see that our report preview displays the Department Name. It means the SSRS Lookup report is displaying data from multiple datasets.

SSRS Lookup Function 11

Comments are closed.