Sdílet prostřednictvím


Datasets - Update Datasources In Group

Aktualizace zdroje dat zadané datové sady ze zadaného 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í

Požadovaný obor

Dataset.ReadWrite.All

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ů ve skupině .
  • 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ů ve skupině .
  • 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.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
datasetId
path True

string

groupId
path True

string

uuid

ID pracovního prostoru

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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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

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