如何通过Power BI API更新Import模式数据源的凭据？

我之前也碰到过一模一样的坑，Import模式的数据集在API上传后的凭据配置逻辑确实和DirectQuery不一样，给你几个经过验证的解决方案：

一、用Update Datasource Credentials API（推荐方案） #

这个API是专门针对数据集数据源凭据更新的，对Import模式完全生效，步骤很清晰：

1. 上传PBIX到工作区后，先通过GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets接口拿到目标数据集的datasetId。
2. 调用更新凭据的核心API：

   PATCH https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/Default.UpdateDatasourceCredentials
   

   举个SQL Server数据源的请求体示例（Basic身份验证）：

   {
     "credentialDetails": {
       "credentials": "{\"credentialData\":[{\"name\":\"username\",\"value\":\"你的SQL账号\"},{\"name\":\"password\",\"value\":\"你的SQL密码\"}]}",
       "credentialType": "Basic",
       "encryptedConnection": "Encrypted",
       "encryptionAlgorithm": "None",
       "privacyLevel": "Organizational"
     },
     "datasourceSelector": {
       "datasourceType": "Sql",
       "connectionDetails": "{\"server\":\"你的SQL服务器地址\",\"database\":\"目标数据库名\"}"
     }
   }
   

   重点提醒：connectionDetails里的服务器、数据库名称必须和PBIX文件里配置的完全一致，包括大小写和特殊字符，否则会匹配不到对应的数据源。

二、修正Set All Connections API的用法 #

如果你之前用这个API没成功，大概率是请求体格式不对。Import模式下这个API可以批量更新所有数据源凭据，正确的请求示例如下：

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/Default.SetAllConnections

请求体示例（同样以SQL Server为例）：

{
  "updateDetails": [
    {
      "connectionDetails": "{\"server\":\"你的SQL服务器地址\",\"database\":\"目标数据库名\"}",
      "datasourceType": "Sql",
      "credentialDetails": {
        "credentialType": "Basic",
        "credentials": "{\"credentialData\":[{\"name\":\"username\",\"value\":\"你的SQL账号\"},{\"name\":\"password\",\"value\":\"你的SQL密码\"}]}",
        "encryptedConnection": "Encrypted",
        "privacyLevel": "Organizational"
      }
    }
  ]
}

如果数据集里有多个数据源，只需要在updateDetails数组里添加对应的配置项即可。

三、几个关键注意点 #

• 如果你用的是Azure AD OAuth这类身份验证，要把credentialType改成OAuth2，并且调整credentials里的内容（比如传入有效访问令牌，或者用服务主体的方式获取权限）。
• 调用API的账号必须拥有目标工作区数据集的编辑权限，不然会直接返回权限错误。
• 不确定请求体格式的话，可以先在Power BI服务里手动配置好一个数据集的凭据，然后调用GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/datasources接口拿到已配置的格式，照着改更稳妥。

内容的提问来源于stack exchange，提问作者Chéyo