Datasets - Update Datasources In Group

从指定的工作区更新指定数据集的数据源。

权限

• 用户必须是数据集所有者。
• 此 API 调用可由服务主体配置文件调用。 有关详细信息，请参阅：Power BI Embedded中的服务主体配置文件。

所需范围

Dataset.ReadWrite.All

局限性

• 不支持使用公共 XMLA 终结点创建或修改的数据集。 若要对这些数据源进行更改，管理员必须使用表格对象模型的 Azure Analysis Services 客户端库。
• 仅支持这些数据源：SQL Server、Azure SQL Server、Azure Analysis Services、Azure Synapse、OData、SharePoint、Teradata 和 SAP HANA。 对于其他数据源，请使用组 API 调用中的 更新参数。
• 不支持更改数据源类型。
• 不支持包含连接字符串中的参数的数据源。
• 仅当使用 增强数据集元数据时，才支持更新合并表或联接表的数据源。
• 对于引用多个数据源的高级查询，只会更新第一个数据源。 若要克服此限制，请将数据源定义为参数，并使用组 API 调用中的 更新参数。
• 不支持具有增量刷新策略的数据集，调用此 API 可能无法按预期工作，并且部分数据源更新的结果，以克服这种情况，可以在调用此 API 之前尝试运行数据集刷新。
  
  

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

URI 参数

请求正文

响应

示例

Example

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateDatasources

{
  "updateDetails": [
    {
      "datasourceSelector": {
        "datasourceType": "Sql",
        "connectionDetails": {
          "server": "My-Sql-Server",
          "database": "My-Sql-Database"
        }
      },
      "connectionDetails": {
        "server": "New-Sql-Server",
        "database": "New-Sql-Database"
      }
    },
    {
      "datasourceSelector": {
        "datasourceType": "OData",
        "connectionDetails": {
          "url": "http://services.odata.org/V4/Northwind/Northwind.svc"
        }
      },
      "connectionDetails": {
        "url": "http://services.odata.org/V4/Odata/Northwind.svc"
      }
    }
  ]
}

定义

Datasource

Power BI 数据源

DatasourceConnectionDetails

Power BI 数据源连接详细信息。 请参阅 获取数据源 或 组获取数据源的示例。

UpdateDatasourceConnectionRequest

Power BI 数据集数据源连接更新请求

UpdateDatasourcesRequest

Power BI 数据集数据源更新请求