Datasets - Update Datasources

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Aktualizace zdroje dat zadané datové sady z pracovního prostoru.

Poznámka

S tímto voláním rozhraní API doporučujeme používat rozšířená metadata datové sady .

Důležité

Původní zdroj dat a nový zdroj dat musí mít úplně stejné schéma.
Pokud používáte rozšířená metadata datové sady, aktualizujte datovou sadu, abyste získali data z nových zdrojů dat.
Pokud nepoužíváte rozšířená metadata datové sady, počkejte 30 minut, než se dokončí operace aktualizace zdrojů dat, a pak datovou sadu aktualizujte.

Oprávnění

Uživatel musí být vlastníkem datové sady.

Omezení

Datové sady vytvořené nebo upravené pomocí veřejného koncového bodu XMLA se nepodporují. Aby správce tyto zdroje dat změnil, musí pro tabulkový objektový model použít klientskou knihovnu Azure Analysis Services.
Podporují se jenom tyto zdroje dat: SQL Server, Azure SQL Server, Azure Analysis Services, Azure Synapse, OData, SharePoint, Teradata a SAP HANA. Pro jiné zdroje dat použijte volání rozhraní API pro aktualizaci parametrů .
Změna typu zdroje dat se nepodporuje.
Zdroje dat, které obsahují parametry v připojovací řetězec, se nepodporují.
Aktualizace zdrojů dat, které jsou součástí sloučených nebo spojených tabulek, se podporuje jenom v případě, že používáte rozšířená metadata datové sady.
U rozšířeného dotazu, který odkazuje na více zdrojů dat, se aktualizuje jenom první zdroj dat. Pokud chcete toto omezení překonat, definujte zdroj dat jako parametr a použijte volání rozhraní API pro aktualizaci parametrů .
Datové sady se zásadami přírůstkové aktualizace nejsou plně podporované. Volání tohoto rozhraní API nemusí fungovat podle očekávání a výsledkem částečné aktualizace zdrojů dat. Pokud to chcete vyřešit, můžete před voláním tohoto rozhraní API zkusit spustit aktualizaci datové sady.

Požadovaný obor

Dataset.ReadWrite.All

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasetId	path	True	string	ID datové sady

Text požadavku

Name	Vyžadováno	Typ	Description
updateDetails	True	UpdateDatasourceConnectionRequest[]	Pole žádostí o aktualizaci připojení ke zdroji dat

Odpovědi

Name	Typ	Description
200 OK		OK

Příklady

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

Definice

Name	Description
Datasource	Zdroj dat Power BI
DatasourceConnectionDetails	Podrobnosti o připojení ke zdroji dat Power BI Příklady najdete v tématech Získání zdrojů dat nebo Získání zdrojů dat do skupiny.
UpdateDatasourceConnectionRequest	Žádost o aktualizaci připojení ke zdroji dat datové sady Power BI
UpdateDatasourcesRequest	Žádost o aktualizaci zdrojů dat datové sady Power BI

Datasource

Zdroj dat Power BI

Name	Typ	Description
connectionDetails	DatasourceConnectionDetails	Podrobnosti o připojení ke zdroji dat
connectionString	string	(Zastaralé) Zdroj dat připojovací řetězec. K dispozici pouze pro DirectQuery.
datasourceId	string	ID vázaného zdroje dat, které je prázdné, pokud není vázané na bránu
datasourceType	string	Typ zdroje dat
gatewayId	string	ID vázané brány, které je prázdné, pokud není vázané na bránu. Při použití clusteru brány odkazuje ID brány na primární (první) bránu v clusteru a podobá se ID clusteru brány.
name	string	(Zastaralé) Název zdroje dat. K dispozici pouze pro DirectQuery.

DatasourceConnectionDetails

Podrobnosti o připojení ke zdroji dat Power BI Příklady najdete v tématech Získání zdrojů dat nebo Získání zdrojů dat do skupiny.

Name	Typ	Description
account	string	Účet připojení
classInfo	string	Informace o třídě připojení
database	string	Databáze připojení
domain	string	Doména připojení
emailAddress	string	E-mailová adresa připojení
kind	string	Druh připojení
loginServer	string	Přihlašovací server připojení
path	string	Cesta k připojení
server	string	Server připojení
url	string	Adresa URL připojení

UpdateDatasourceConnectionRequest

Žádost o aktualizaci připojení ke zdroji dat datové sady Power BI

Name	Typ	Description
connectionDetails	DatasourceConnectionDetails	Podrobnosti o cílovém připojení aktualizovaného zdroje dat
datasourceSelector	Datasource	Podrobnosti o připojení zdroje dat, který je potřeba aktualizovat. To je povinné, pokud datová sada obsahuje více než jeden zdroj dat.

UpdateDatasourcesRequest

Žádost o aktualizaci zdrojů dat datové sady Power BI

Name	Typ	Description
updateDetails	UpdateDatasourceConnectionRequest[]	Pole žádostí o aktualizaci připojení ke zdroji dat

Sdílet prostřednictvím