Datasets - Update Datasources

Odwołanie

Service:: Power BI REST APIs

API Version:: v1.0

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

Uwaga

Zalecamy używanie rozszerzonych metadanych zestawu danych z tym wywołaniem interfejsu API.

Ważne

Oryginalne źródło danych i nowe źródło danych muszą mieć dokładnie ten sam schemat.
Jeśli używasz rozszerzonych metadanych zestawu danych, odśwież zestaw danych, aby pobrać dane z nowych źródeł danych.
Jeśli nie używasz rozszerzonych metadanych zestawu danych, poczekaj 30 minut na ukończenie operacji aktualizowania źródeł danych, a następnie odśwież zestaw danych.

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 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 parametry połączenia nie są obsługiwane.
Aktualizowanie źródeł danych, które są częścią scalonych lub połączonych 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.

Zakres wymagany

Dataset.ReadWrite.All

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
datasetId	path	True	string	Identyfikator zestawu danych

Treść żądania

Nazwa	Wymagane	Typ	Opis
updateDetails	True	UpdateDatasourceConnectionRequest[]	Tablica żądań aktualizacji połączenia ze źródłem danych

Odpowiedzi

Nazwa	Typ	Opis
200 OK		OK

Przykłady

Example

Sample Request

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

Definicje

Nazwa	Opis
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 w temacie 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

Datasource

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

Nazwa	Typ	Opis
connectionDetails	DatasourceConnectionDetails	Szczegóły połączenia ze źródłem danych
connectionString	string	(Przestarzałe) Źródło danych parametry połączenia. Dostępne tylko dla trybu DirectQuery.
datasourceId	string	Powiązany identyfikator źródła danych, który jest pusty, gdy nie jest powiązany z bramą
datasourceType	string	Typ źródła danych
gatewayId	string	Powiązany identyfikator bramy, który jest pusty, gdy nie jest powiązany z bramą. W przypadku korzystania z klastra bramy identyfikator bramy odwołuje się do podstawowej (pierwszej) bramy w klastrze i jest podobny do identyfikatora klastra bramy.
name	string	(Przestarzałe) Nazwa źródła danych. Dostępne tylko dla trybu DirectQuery.

DatasourceConnectionDetails

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

Nazwa	Typ	Opis
account	string	Konto połączenia
classInfo	string	Informacje o klasie połączenia
database	string	Baza danych połączeń
domain	string	Domena połączenia
emailAddress	string	Adres e-mail połączenia
kind	string	Rodzaj połączenia
loginServer	string	Serwer logowania połączenia
path	string	Ścieżka połączenia
server	string	Serwer połączeń
url	string	Adres URL połączenia

UpdateDatasourceConnectionRequest

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

Nazwa	Typ	Opis
connectionDetails	DatasourceConnectionDetails	Szczegóły połączenia docelowego zaktualizowanego źródła danych
datasourceSelector	Datasource	Szczegóły połączenia źródła danych, które wymaga aktualizacji. Jest to obowiązkowe, gdy zestaw danych ma więcej niż jedno źródło danych.

UpdateDatasourcesRequest

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

Nazwa	Typ	Opis
updateDetails	UpdateDatasourceConnectionRequest[]	Tablica żądań aktualizacji połączenia ze źródłem danych

Udostępnij za pośrednictwem