Freigeben über


Datasets - Update Datasources In Group

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

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

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