如何通过PowerBI报表URL传递参数过滤M Query数据？

核心原因 #

你当前使用的URL filter 参数仅作用于报表可视化层的过滤，不会修改M Query中定义的参数值——数据源仍会用默认值取数，之后再在前端做过滤。要实现URL参数驱动M Query重新取数，必须把URL参数映射到数据集参数，让M Query直接使用这些参数执行SQL。

具体步骤 #

1. 将M Query参数转换为数据集参数 #

• 打开PowerBI Desktop，进入左侧「数据」界面，右键点击你的数据集 → 参数 → 新建参数
• 分别创建三个数据集参数：
  • StartDate：类型选整数，默认值设为1701388800000，勾选「允许在发布后更改」
  • EndDate：类型选整数，默认值设为1701475200000，勾选「允许在发布后更改」
  • LocationId：类型选整数，默认值设为3，勾选「允许在发布后更改」
• 进入M Query编辑器，修改原查询，替换原有参数为数据集参数：

  let
      StartDateParam = StartDate,
      EndDateParam = EndDate,
      LocationIdParam = LocationId,
      Source = Sql.Database("你的Azure数据库服务器地址", "数据库名", [Query="select * from testFunction(" & Text.From(StartDateParam) & "," & Text.From(EndDateParam) & "," & Text.From(LocationIdParam) & ")"])
  in
      Source
  

• 保存并刷新数据，验证参数生效。

2. 发布报表到PowerBI服务 #

发布时勾选「包含数据集」，在PowerBI服务中确认数据集的参数已开启「允许更改」权限。

3. 使用URL传递参数触发数据刷新 #

不再使用filter参数，改用datasetParameters传递值，示例URL格式：

https://app.powerbi.com/reportEmbed?reportId=${reportId}&autoAuth=true&ctid=258ba36a-1b5f-4dd4-9ec0-3578958ea03c&datasetParameters=StartDate%3D1702598400000%3BEndDate%3D1702684800000%3BLocationId%3D5

• 格式规则：datasetParameters内容为参数名=值，用分号;分隔，所有特殊字符需URL编码（如=编码为%3D，;编码为%3B）
• 访问该URL时，PowerBI服务会自动更新数据集参数，重新执行M Query中的SQL查询并返回对应数据。

4. 可选：添加报表级参数联动 #

若需要用户在报表界面手动修改参数，可在PowerBI Desktop中添加切片器或参数卡片，绑定到数据集参数，同时支持URL传参和手动调整。

注意事项 #

• 确保PowerBI服务中已正确配置Azure数据库的连接权限（OAuth或密钥认证），避免参数更新时出现权限错误
• 数据集参数更新会触发数据源查询，需注意数据库的性能和查询频率限制
• URL中的参数名必须与数据集参数名称完全一致（区分大小写）

内容的提问来源于stack exchange，提问作者Dheeraj Sonawane