如何通过PowerBI API跨租户发布PBIX并忽略数据连接？

一、先剥离PBIX的数据集关联 #

带内置数据连接的PBIX导入跨租户时，API会验证数据集模型导致PowerBIModelNotFoundException，先处理PBIX文件：

• 用PowerBI Desktop打开PBIX，选择文件 > 另存为，保存时选择“仅报表”模式（若支持），生成仅含视觉对象、不绑定原数据集的PBIX。
• 若没有该选项，用PBIX解压工具（比如PBIX Tool）解压PBIX为文件夹，删除DataModelSchema.json等数据集相关文件，重新打包成PBIX。注意这种情况要确保报表不依赖原数据集的度量值，后续需重新关联。

二、调用Import API时指定报表优先模式 #

调用POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/imports时，通过请求体参数跳过数据集验证：

• 请求体设置importMode为CreateOrOverrideReport，该模式只处理报表的创建/覆盖，不强制关联现有数据集。
• 加上skipReportValidation=true参数，跳过报表与数据集的绑定校验。
  示例请求体：

{
  "datasetDisplayName": "目标报表名",
  "importMode": "CreateOrOverrideReport",
  "skipReportValidation": true
}

请求的Content-Type设为multipart/form-data，上传预处理后的PBIX文件。

三、跨租户认证配置 #

要操作两个租户，需确保身份权限到位：

• 在开发、生产租户分别注册Azure AD应用，授予Workspace.ReadWrite.All、Dataset.ReadWrite.All权限。
• 用服务主体获取目标租户的访问令牌（通过https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token端点），确保令牌能操作目标工作区。

四、导入后更新数据源连接 #

报表导入成功后，用Update Datasources API修改连接：
调用PATCH https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/Default.UpdateDatasources，请求体指定目标租户的数据源信息，示例：

{
  "updateDetails": [
    {
      "datasourceSelector": {
        "datasourceType": "Sql",
        "connectionDetails": {
          "server": "生产租户SQL地址",
          "database": "生产库名"
        }
      },
      "connectionDetails": {
        "server": "生产租户SQL地址",
        "database": "生产库名"
      }
    }
  ]
}

如果报表没有绑定数据集，先创建对应数据集，再通过API将报表与新数据集关联。

五、常见问题排查 #

若仍报错PowerBIModelNotFoundException，检查：

• 预处理后的PBIX是否真的移除了原数据集绑定，用PowerBI Desktop打开确认无关联原租户数据集。
• API调用的租户ID、工作区ID是否正确，令牌归属目标租户。
• 目标工作区是否已添加服务主体为成员，且权限足够创建报表/数据集。

内容的提问来源于stack exchange，提问作者Davide Bono