Datasets - Update Datasources
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 |
---|---|---|---|---|
dataset
|
path | True |
string |
Identyfikator zestawu danych |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
updateDetails | True |
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
{
"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
Definicje
Nazwa | Opis |
---|---|
Datasource |
Źródło danych usługi Power BI |
Datasource |
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. |
Update |
Żądanie aktualizacji połączenia źródła danych zestawu danych usługi Power BI |
Update |
Żądanie aktualizacji źródeł danych zestawu danych usługi Power BI |
Datasource
Źródło danych usługi Power BI
Nazwa | Typ | Opis |
---|---|---|
connectionDetails |
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 |
Szczegóły połączenia docelowego zaktualizowanego źródła danych |
|
datasourceSelector |
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 |
Tablica żądań aktualizacji połączenia ze źródłem danych |