Embedded and Shared Datasets (Report Builder and SSRS)

In a report, a dataset represents report data that is returned from running a query on an external data source. The dataset depends on the data connection that contains information about the external data source. The data itself is not included in the report definition. The dataset contains a query command, a field collection, parameters, filters, and data options that include case sensitivity and collation. There are two types of datasets:

  • Shared datasets. A shared dataset is published on a report server and can be used by multiple reports. A shared dataset must be based on a shared data source. A shared dataset can be cached and scheduled by creating a cache refresh plan.

  • Embedded datasets. Embedded datasets are defined in and used by a single report.

The difference between the two is in how they are created, stored, and managed.

Note

You can create and modify paginated report definition (.rdl) files in Microsoft Report Builder, Power BI Report Builder, and in Report Designer in SQL Server Data Tools.

Shared Datasets

Use a shared dataset to provide a query that can be used by more than one report. Shared datasets are stored on the report server and managed separately from reports or shared data sources. For example, a report server administrator might update the query to take advantage of improved indexing or other query performance optimization.

We recommend that you use shared datasets as much as possible. You can optimize a query or cache query results to benefit report performance. Shared datasets make data access easier to manage, and help to keep reports and the datasets they access more secure and more performant.

In Report Designer, you can create shared datasets as part of a report project, and control whether to deploy them to a report server. You cannot browse to a report server and select a shared dataset to add to your report.

In Report Builder, you can do the following:

  1. To create a shared dataset, use Shared Dataset Design View. You can save it to a report server or SharePoint site to share with other reports. You can also browse to the report server and edit and existing shared dataset. In this view, you can build a query and set all dataset options. For more information, see Shared Dataset Design View (Report Builder).

  2. To add a shared dataset to your report, open Report Builder in Report Design View. From a wizard or from the Report Data pane, browse to the report server and select the shared dataset to add to your report. In this view, you cannot change the query except to add fields. You can override other data options and add filters. You cannot remove filters.

  3. The following table compares the properties that can be configured for the definition of the shared dataset on the report server and the instance of the shared dataset in the report definition.

    Property Configuration Notes for the Definition Configuration Notes for the Instance
    Query text Configure the query, including defining it as expression. Cannot change the query.
    Query parameters Cannot reference report parameters

    Includes default values

    Includes a Read Only flag
    Configure parameters that are not marked Read Only in the definition
    Filters Define filters Cannot view or change dataset filters that are part of the definition

    Can create additional filters
    Data Source Must be a shared data source Cannot change the data source
    Fields Fields from the query command

    Calculated fields are not part of the dataset definition
    View fields, but cannot change them

    The field collection is static based on the query at the time you added the shared dataset to the report. To update, click Refresh Fields in the Dataset Properties dialog box. The actual field collection is whatever the current query in the definition returns.

    Add calculated fields
    Dataset Data options such as case sensitivity Override data options in the instance

Embedded Datasets

Use an embedded dataset when you want to get data from an external data source to be used only in one report. Embedded datasets are useful when you want to create a query that has no other dependencies and that you do not need to use for multiple reports.

To create or edit an embedded dataset, use the Report Data pane. After you create a dataset, you can configure the properties in the Dataset Properties dialog box.