Datasets - Update Datasources In Group

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Updates die Datenquellen des angegebenen Datasets aus dem angegebenen Arbeitsbereich.

Hinweis

Es wird empfohlen, erweiterte Datasetmetadaten mit diesem API-Aufruf zu verwenden.

Wichtig

Die ursprüngliche Datenquelle und die neue Datenquelle müssen genau das gleiche Schema aufweisen.
Wenn Sie erweiterte Datasetmetadaten verwenden, aktualisieren Sie das Dataset, um Daten aus den neuen Datenquellen abzurufen.
Wenn Sie keine erweiterten Datasetmetadaten verwenden, warten Sie 30 Minuten, bis der Vorgang zum Aktualisieren von Datenquellen abgeschlossen ist, und aktualisieren Sie dann das Dataset.

Berechtigungen

Der Benutzer muss der Besitzer des Datasets 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 mit dem öffentlichen XMLA-Endpunkt 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 tabellarisches 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 API-Aufruf Parameter in Gruppen aktualisieren .
Das Ändern des Datenquellentyps wird nicht unterstützt.
Datenquellen, die Parameter im Verbindungszeichenfolge enthalten, werden nicht unterstützt.
Das Aktualisieren von Datenquellen, die Teil von zusammengeführten oder verknüpften Tabellen sind, wird nur unterstützt, wenn Sie erweiterte Datasetmetadaten verwenden.
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 API-Aufruf Parameter in Gruppen aktualisieren .
Datasets mit einer Richtlinie für inkrementelle Aktualisierungen werden nicht vollständig unterstützt. Der Aufruf 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

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string
groupId	path	True	string uuid	Arbeitsbereich-ID

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
updateDetails	True	UpdateDatasourceConnectionRequest[]	Ein Array von Datenquellenverbindungsupdateanforderungen

Antworten

Name	Typ	Beschreibung
200 OK		OK

Beispiele

Example

Sample Request

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

Request Body

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

Sample Response

Status code:: 200

Definitionen

Name	Beschreibung
Datasource	Eine Power BI-Datenquelle
DatasourceConnectionDetails	Die Verbindungsdetails der Power BI-Datenquelle. Beispiele finden Sie unter Abrufen von Datenquellen oder Abrufen von Datenquellen in Gruppe.
UpdateDatasourceConnectionRequest	Anforderung zum Aktualisieren der Datenquellenverbindung für Power BI-Datasets
UpdateDatasourcesRequest	Updateanforderung für Power BI-Datasetdatenquellen

Datasource

Eine Power BI-Datenquelle

Name	Typ	Beschreibung
connectionDetails	DatasourceConnectionDetails	Details zur Datenquellenverbindung
connectionString	string	(Veraltet) Die Datenquelle Verbindungszeichenfolge. Nur für DirectQuery verfügbar.
datasourceId	string	Die gebundene Datenquellen-ID, die leer ist, wenn sie nicht an ein Gateway gebunden ist
datasourceType	string	Der Datenquellentyp
gatewayId	string	Die gebundene Gateway-ID, die leer ist, wenn sie nicht an ein Gateway gebunden ist. Bei Verwendung eines Gatewayclusters bezieht sich die Gateway-ID auf das primäre (erste) Gateway im Cluster und ähnelt der Gatewaycluster-ID.
name	string	(Veraltet) Der Name der Datenquelle. Nur für DirectQuery verfügbar.

DatasourceConnectionDetails

Die Verbindungsdetails der Power BI-Datenquelle. Beispiele finden Sie unter Abrufen von Datenquellen oder Abrufen von Datenquellen in Gruppe.

Name	Typ	Beschreibung
account	string	Das Verbindungskonto
classInfo	string	Informationen zur Verbindungsklasse
database	string	Die Verbindungsdatenbank
domain	string	Die Verbindungsdomäne
emailAddress	string	Die Verbindungs-E-Mail-Adresse
kind	string	Die Verbindungsart
loginServer	string	Verbindungsanmeldungsserver
path	string	Der Verbindungspfad
server	string	Der Verbindungsserver
url	string	Die Verbindungs-URL

UpdateDatasourceConnectionRequest

Anforderung zum Aktualisieren der Datenquellenverbindung für Power BI-Datasets

Name	Typ	Beschreibung
connectionDetails	DatasourceConnectionDetails	Die Zielverbindungsdetails der aktualisierten Datenquelle
datasourceSelector	Datasource	Die Verbindungsdetails der Datenquelle, die aktualisiert werden muss. Dies ist obligatorisch, wenn ein Dataset über mehrere Datenquellen verfügt.

UpdateDatasourcesRequest

Updateanforderung für Power BI-Datasetdatenquellen

Name	Typ	Beschreibung
updateDetails	UpdateDatasourceConnectionRequest[]	Ein Array von Datenquellenverbindungsupdateanforderungen