Datasets - Update Datasources In Group

Aktualisiert die Datenquellen des angegebenen Datasets aus dem angegebenen Arbeitsbereich.

Erlaubnisse

• Der Benutzer muss der Datasetbesitzer sein.
• Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter: Dienstprinzipalprofile in Power BI Embedded.

Erforderlicher Bereich

Dataset.ReadWrite.All

Einschränkungen

• Datasets, die mithilfe des öffentlichen XMLA-Endpunkts erstellt oder geändert wurden, werden nicht unterstützt. Um Änderungen an diesen Datenquellen vorzunehmen, muss der Administrator die Azure Analysis Services-Clientbibliothek für das tabellarische Objektmodell verwenden.
• Nur diese Datenquellen werden unterstützt: SQL Server, Azure SQL Server, Azure Analysis Services, Azure Synapse, OData, SharePoint, Teradata und SAP HANA. Verwenden Sie für andere Datenquellen den Updateparameter in der Gruppe API-Aufruf.
• Das Ändern des Datenquellentyps wird nicht unterstützt.
• Datenquellen, die Parameter in der Verbindungszeichenfolge enthalten, werden nicht unterstützt.
• Das Aktualisieren von Datenquellen, die Teil zusammengeführter oder verknüpfter Tabellen sind, wird nur unterstützt, wenn Sie erweiterten Datasetmetadatenverwenden.
• Bei einer erweiterten Abfrage, die auf mehrere Datenquellen verweist, wird nur die erste Datenquelle aktualisiert. Um diese Einschränkung zu umgehen, definieren Sie die Datenquelle als Parameter, und verwenden Sie den Update Parameters In Group API-Aufruf.
• Datasets mit inkrementeller Aktualisierungsrichtlinie werden nicht vollständig unterstützt. Das Aufrufen dieser API funktioniert möglicherweise nicht wie erwartet, und das Ergebnis einer teilweisen Aktualisierung von Datenquellen, um dies zu umgehen, können Sie versuchen, eine Datasetaktualisierung auszuführen, bevor Sie diese API aufrufen.
  
  

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

URI-Parameter

Anforderungstext

Antworten

Beispiele

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"
      }
    }
  ]
}

Definitionen

Datasource

Eine Power BI-Datenquelle

DatasourceConnectionDetails

Die Power BI-Datenquellenverbindungsdetails. Beispiele finden Sie in Get Datasources oder Get Datasources In Group.

UpdateDatasourceConnectionRequest

Aktualisierungsanforderung für Power BI-Dataset-Datenquellenverbindung

UpdateDatasourcesRequest

Aktualisierungsanforderung für Power BI-Datasetdatenquellen