Embedded and Shared Datasets (Report Builder and SSRS)
Applies To: SQL Server 2016
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.
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:
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).
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.
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
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.
Embedded and Shared Data Connections or Data Sources (Report Builder and SSRS)
Create a Shared Dataset or Embedded Dataset (Report Builder and SSRS)
Report Datasets (SSRS)
Dataset Fields Collection (Report Builder and SSRS)
Data Connections, Data Sources, and Connection Strings in Report Builder
Data Connections, Data Sources, and Connection Strings (Report Builder and SSRS)