如何持久化Power BI数据源凭据？API更新后刷新报错

针对你使用REST API更新数据源并刷新数据集时，需要手动重复输入凭据的问题，可以通过以下方法实现凭据持久化：

1. 使用Set All Datasource Credentials API端点 #

直接通过Power BI REST API批量设置并持久化所有数据源的凭据，无需手动操作。

端点说明 #

• 工作区数据集：POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/Default.SetAllDatasourceCredentials
• 个人数据集：POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.SetAllDatasourceCredentials

请求体示例（以Basic认证为例） #

{
  "credentialDetails": {
    "credentials": "{\"credentialData\":[{\"name\":\"username\",\"value\":\"your_username\"},{\"name\":\"password\",\"value\":\"your_password\"}]}",
    "credentialType": "Basic",
    "encryptedConnection": "Encrypted",
    "encryptionAlgorithm": "None",
    "privacyLevel": "Organizational"
  }
}

注意事项 #

• 根据数据源类型调整credentialType（如OAuth2、Windows、Key等），对应修改credentials中的字段
• 调用API的主体（用户或服务主体）需拥有Dataset.ReadWrite.All权限
• 确保encryptedConnection和privacyLevel与数据源实际要求匹配

2. 配置网关持久化凭据（针对本地数据源） #

如果使用本地数据网关连接数据源：

• 登录Power BI服务的网关管理页面
• 找到对应数据集的数据源，设置凭据后勾选保存凭据选项
• 确保网关服务账户有访问数据源的权限，且凭据不会过期

3. 采用服务主体认证 #

使用Azure AD服务主体替代用户交互式认证，实现无人工干预的凭据管理：

1. 在Azure AD中注册服务主体，并授予其Power BI服务的Dataset.ReadWrite.All、Workspace.ReadWrite.All权限
2. 调用API时使用服务主体的访问令牌进行身份验证
3. 若数据源支持服务主体认证，直接在SetAllDatasourceCredentials请求中传入服务主体凭据

4. 校验数据源配置一致性 #

确保UpdateDatasources API的请求体参数与手动设置的数据源配置完全一致：

• 核对connectionString、datasourceType等字段
• 避免因配置不匹配导致凭据无法绑定，出现连接测试失败的情况

常见排查点 #

• 确认API调用的令牌权限足够，可通过Power BI Admin门户检查权限分配
• 验证凭据格式是否正确（如JSON字符串转义是否合规）
• 用相同凭据手动测试数据源连接，排除数据源本身的连通性问题

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