DataSources 和 DataSets 引用(报表生成器)

适用范围: Microsoft 报表生成器 (SSRS) Power BI Report Builder SQL Server Data Tools 中的报表设计器

“DataSources”集合表示在分页报表中使用的所有数据源。 同样, DataSets 集合表示报表中所有数据源的所有数据集。 使用 “报表数据” 窗格显示报表数据集的层次结构视图,报表数据集按照它们所引用的数据源组织。 如果这些集合中包含引用,则在预览报表时将不会看到值。 这些集合只有在将报表发布到报表服务器之后才可用。

注意

在 SQL Server Data Tools 中,你可以在 Microsoft 报表生成器、Power BI 报表生成器和报表设计器中创建和修改分页报表定义 (.rdl) 文件。

DataSources

DataSources 集合表示在已发布的报表定义中引用的数据源。 可选择将此信息包括在报表中,以记录报表数据源。 此集合在“预览”模式下不可用。 下表对 DataSources 集合中的变量进行了说明。

变量 类型 说明
DataSourceReference 字符串 报表服务器上数据源定义的完整路径。 例如,可以包括用作部分报表历史记录的报表中的所有数据源列表。 以下示例显示名为 AdventureWorks2022 的数据源的完整路径:

/DataSources/AdventureWorks2022
类型 字符串 数据源数据访问接口的类型。 例如,SQL

DataSets

DataSets 集合表示在报表定义中引用的数据集。 可在文本框中选择包括报表查询,以便希望知道报表中确切数据的用户可以看到原始命令文本。 此集合在“预览”模式下不可用。 下表对 DataSets 集合的成员进行了说明。

成员 类型 说明
CommandText 字符串 对于数据库数据源,此查询为用于从数据源中检索数据的查询。 如果查询是一个表达式,则此表达式为计算的表达式。
RewrittenCommandText 字符串 数据访问接口的扩展 CommandText 值。 该值通常用于报表,其中查询参数映射到报表参数。 将命令文本参数引用扩展到为映射的报表参数选中的常量值时,此数据访问接口将设置此属性。

使用查询表达式

可使用表达式定义包含在数据集中的查询。 您可以使用此功能来设计报表,报表中的查询可以根据用户的输入、其他数据集中的数据或其他变量进行更改。 有关查询的详细信息,请参阅“报表的嵌入数据集和共享数据集(报表生成器)”。

表达式(报表生成器)
表达式示例(报表生成器)