调用Power BI API更新File类型数据源遇InvalidRequest错误求助

问题分析 #

调用Power BI API更新File类型数据源路径时收到InvalidRequest错误，提示Parameter UpdateDetails is missing or invalid，但更新Sql类型数据源正常，核心原因大概率是File类型数据源的配置逻辑与Sql不同，或数据源类型本身不支持该API操作。

核心原因与解决办法 #

1. 确认数据源类型是否支持API更新 #

Power BI的File数据源分两种：

• 导入式本地文件：直接上传到Power BI服务的文件，无法通过Update Datasources API更新路径，必须重新上传文件并替换数据集的数据源。
• 网关连接的本地文件：通过数据网关连接的本地/网络共享文件，可使用API更新路径，需按以下要求调整请求JSON：

2. 调整请求JSON结构 #

方式一：使用datasourceId定位数据源

若已知数据源ID，简化datasourceSelector，仅保留datasourceId即可：

{
    "updateDetails": [
        {
            "datasourceSelector": {
                "datasourceId": "1dc506f7-1599-4ca8-9a41-e06d4f94febd"
            },
            "connectionDetails": {
                "path": "C:\\data\\file2.xlsx"
            }
        }
    ]
}

方式二：通过网关+原路径定位数据源

若未使用datasourceId，需在datasourceSelector中补充gatewayId（必须与API请求URL中的网关ID一致）：

{
    "updateDetails": [
        {
            "datasourceSelector": {
                "datasourceType": "File",
                "connectionDetails": {
                    "path": "c:\\data\\file1.xlsx"
                },
                "gatewayId": "你的网关ID"
            },
            "connectionDetails": {
                "path": "C:\\data\\file2.xlsx"
            }
        }
    ]
}

3. 额外检查项 #

• 确保API请求URL包含正确的gatewayId，格式为：

  POST https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/updateDatasources
  

• 确认新文件路径在网关所在机器上有足够访问权限，路径格式正确（本地路径用C:\\...，网络共享用\\\\server\\share\\file.xlsx）。

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