使用Azure Synapse Web Activity刷新Power BI数据集遇ItemNotFound错误求助

问题描述 #

通过Azure Synapse的Web Activity发送POST请求刷新Power BI数据集，严格遵循步骤后仍触发"ItemNotFound"错误，错误详情如下：

{
  "errorCode": "2108",
  "message": "{\"error\":{\"code\":\"ItemNotFound\",\"message\":\"Dataset xxxxxxx is not found! Please verify datasetId is correct and user have sufficient permissions.\"}}",
  "failureType": "UserError",
  "target": "Web1"
}

已完成的前置配置：

• 在Azure Synapse中配置了托管标识（Managed Identity）
• 配置了Power BI租户设置
• 将Web Activity设置为POST方法并配置数据集刷新URL
• 验证了数据集ID和权限

额外排查步骤 #

1. 确认API URL的完整性与正确性 #

刷新Power BI数据集的API URL需根据工作区类型选择对应格式：

• 普通工作区：必须使用https://api.powerbi.com/v1.0/myorg/groups/{workspaceId}/datasets/{datasetId}/refreshes，注意{workspaceId}是工作区的GUID（不是名称），可从Power BI工作区的浏览器地址栏获取（格式为https://app.powerbi.com/groups/{workspaceId}/list）。
• 经典工作区：需使用https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes，无需添加groups/{workspaceId}路径。

2. 验证托管标识的权限分配 #

• 确保托管标识（即Synapse工作区名称）被直接分配到Power BI数据集的「参与者」或「管理员」权限，避免通过组继承（组权限可能存在生效延迟）。
• 进入Power BI数据集的权限设置页面，搜索托管标识名称，确认权限状态为已启用。

3. 检查Power BI租户设置细节 #

• 确认租户设置中「允许服务主体使用Power BI API」已开启，且在「允许特定安全组使用Power BI API」中添加了托管标识（或其所属安全组）。
• 开启「增强数据集元数据权限」设置，部分场景下该选项会影响API对数据集的访问权限。

4. 核对Web Activity的身份验证配置 #

• Web Activity的身份验证必须选择「Managed Identity」，且资源URL必须填写https://analysis.windows.net/powerbi/api，资源URL错误会导致身份验证失效，间接触发数据集找不到的错误。

5. 测试API访问有效性 #

使用托管标识调用Power BI的Get Datasets API（对应工作区的https://api.powerbi.com/v1.0/myorg/groups/{workspaceId}/datasets），检查是否能返回目标数据集：

• 若无法返回，说明权限配置或ID存在问题；
• 若能返回，再测试刷新请求，排查是否为请求格式错误。

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