Datasets - Update Datasources

Aktualisiert die Datenquellen des angegebenen Datasets aus My workspace.

Erlaubnisse

Der Benutzer muss der Datasetbesitzer sein.

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 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 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.

Erforderlicher Bereich

Dataset.ReadWrite.All

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

URI-Parameter

Anforderungstext

Antworten

Beispiele

Example

POST https://api.powerbi.com/v1.0/myorg/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