Udostępnij za pośrednictwem


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

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