Datasets - Update Datasources

Aktualizuje źródła danych określonego zestawu danych z Mój obszar roboczy.

Uprawnienia

Użytkownik musi być właścicielem zestawu danych.

Ograniczenia

• Zestawy danych utworzone lub zmodyfikowane przy użyciu publicznego punktu końcowego XMLA nie są obsługiwane. Aby wprowadzić zmiany w tych źródłach danych, administrator musi użyć biblioteki klienta usług Azure Analysis Services dla modelu obiektów tabelarycznych.
• Obsługiwane są tylko te źródła danych: SQL Server, Azure SQL Server, Azure Analysis Services, Azure Synapse, OData, SharePoint, Teradata i SAP HANA. W przypadku innych źródeł danych użyj wywołania interfejsu API Update Parameters.
• Zmiana typu źródła danych nie jest obsługiwana.
• Źródła danych zawierające parametry w parametrach połączenia nie są obsługiwane.
• Aktualizowanie źródeł danych, które są częścią scalonych lub sprzężonych tabel, jest obsługiwane tylko wtedy, gdy używasz rozszerzonych metadanych zestawu danych.
• W przypadku zapytania zaawansowanego, które odwołuje się do wielu źródeł danych, zostanie zaktualizowane tylko pierwsze źródło danych. Aby przezwyciężyć to ograniczenie, zdefiniuj źródło danych jako parametr i użyj wywołania interfejsu API Update Parameters.
• Zestawy danych z zasadami odświeżania przyrostowego nie są w pełni obsługiwane, wywołanie tego interfejsu API może nie działać zgodnie z oczekiwaniami i wynikać z częściowej aktualizacji źródeł danych, aby rozwiązać ten problem, możesz spróbować uruchomić odświeżanie zestawu danych przed wywołaniem tego interfejsu API.

Wymagany zakres

Dataset.ReadWrite.All

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

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Przykłady

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

Definicje

Datasource

Źródło danych usługi Power BI

DatasourceConnectionDetails

Szczegóły połączenia ze źródłem danych usługi Power BI. Zobacz przykłady Pobieranie źródeł danych lub Pobieranie źródeł danych w grupie.

UpdateDatasourceConnectionRequest

Żądanie aktualizacji połączenia źródła danych zestawu danych usługi Power BI

UpdateDatasourcesRequest

Żądanie aktualizacji źródeł danych zestawu danych usługi Power BI