Power BI报表能否通过Rest API传参从SQL Server取数并嵌入React应用？

一、解决数据实时同步问题 #

直接把Power BI报表的数据源模式从导入模式切换为DirectQuery模式，这样报表会直接实时读取SQL Server的最新数据，不用每次手动刷新发布。不过要注意，DirectQuery对复杂DAX表达式的支持有限，提前做性能测试更稳妥。如果没法用DirectQuery，也可以设置自动刷新计划，但只能做到准实时，没法满足真正的实时需求。

二、通过API传递动态参数实现数据筛选 #

1. 先在报表里配置参数 #

在Power BI Desktop的「建模」选项卡新建参数，把参数关联到SQL Server数据源的查询条件里（比如作为WHERE子句的筛选值），这样参数变化时，DirectQuery模式下会直接触发实时SQL查询。

2. React嵌入时用Power BI JS SDK传参数 #

在React项目里用Power BI JavaScript SDK嵌入报表时，直接在嵌入配置里传递参数，或者动态修改筛选条件：

• 嵌入时直接传参数的示例代码：

import * as powerbi from 'powerbi-client';

// 嵌入配置
const embedConfig = {
  type: 'report',
  id: '<你的报表ID>',
  embedUrl: '<你的报表嵌入URL>',
  accessToken: '<生成的嵌入令牌>',
  settings: {
    panes: { filters: { visible: false } }
  },
  // 绑定报表参数
  datasetBinding: {
    parameters: [
      { name: '<你定义的参数名>', value: '<从POST请求拿到的参数值>' }
    ]
  }
};

// 渲染报表
const reportContainer = document.getElementById('report-container');
const report = powerbi.embed(reportContainer, embedConfig);

• 动态修改筛选条件的示例（适合没预定义参数的场景）：

// 给报表添加筛选器
report.updateFilters(models.FiltersOperations.Add, [
  {
    $schema: "http://powerbi.com/product/schema#basic",
    target: {
      table: '<SQL表名>',
      column: '<要筛选的列名>'
    },
    operator: "Equals",
    values: ["<POST传入的参数值>"]
  }
]);

3. 处理POST输入的参数 #

在React的后端服务（比如Node.js、Java）接收POST请求的参数，先做校验和转义（防止SQL注入），然后要么把参数关联到Power BI嵌入令牌的权限中，要么直接把参数传到前端，再通过SDK传递给报表。

三、关键注意点 #

• 嵌入报表需要先在Azure AD里注册应用，获取客户端ID、配置权限，生成合法的嵌入令牌（可以用Power BI REST API或者Azure AD令牌服务生成）。
• DirectQuery模式下，要给SQL Server的查询表加合适的索引，避免并发查询时性能拉胯。
• 如果用导入模式，也可以通过Power BI数据集REST API触发参数化刷新，但这种方式是准实时，不如DirectQuery直接。

内容的提问来源于stack exchange，提问作者Praveen Rao Chavan.G