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 データセット データ ソースの更新要求