Datasets - Get Refresh Execution Details In Group

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Vrátí podrobnosti o spuštění operace rozšířené aktualizace pro zadanou datovou sadu ze zadaného pracovního prostoru.

Oprávnění

Toto volání rozhraní API lze volat pomocí profilu instančního objektu. Další informace najdete v tématu Profily instančního objektu v Power BI Embedded.

Požadovaný obor

Dataset.ReadWrite.All nebo Dataset.Read.All

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshes/{refreshId}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasetId	path	True	string uuid	ID datové sady
groupId	path	True	string uuid	ID pracovního prostoru
refreshId	path	True	string uuid	ID aktualizace

Odpovědi

Name	Typ	Description
200 OK	DatasetRefreshDetail	OK (tato odpověď se vrátí, když se operace aktualizace dokončila nebo selhala)
202 Accepted	DatasetRefreshDetail	Přijato (tato odpověď se vrátí, když stále probíhá operace aktualizace)

Příklady

Completed refresh example

Failed refresh example

In progress refresh example

Completed refresh example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/fdb91b8f-0a9b-44c1-b6c0-0cb185c6ebfb/datasets/f7fc6510-e151-42a3-850b-d0805a391db0/refreshes/87f31ef7-1e3a-4006-9b0b-191693e79e9e

Sample Response

Status code:: 200

{
  "startTime": "2021-12-10T08:40:31.57",
  "endTime": "2021-12-10T08:40:43.87",
  "type": "Full",
  "commitMode": "Transactional",
  "status": "Completed",
  "extendedStatus": "Completed",
  "currentRefreshType": "Full",
  "numberOfAttempts": 0,
  "objects": [
    {
      "table": "DateTableTemplate_78e78207-b3fb-41b5-8b95-e5efca989067",
      "partition": "DateTableTemplate_78e78207-b3fb-41b5-8b95-e5efca989067-ae306fb4-3b7e-4a41-824d-cb3b452fedfc",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_e9d8a66b-4018-4d16-be8c-402b2037c051",
      "partition": "LocalDateTable_e9d8a66b-4018-4d16-be8c-402b2037c051-59bc07f8-85c9-456a-ad36-18e1de4d77ed",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_55935f6b-04d1-4cfe-8856-ed9f9e73ab2e",
      "partition": "LocalDateTable_55935f6b-04d1-4cfe-8856-ed9f9e73ab2e-d95ae7f7-19c9-48a8-9c16-fcab26558bc2",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_ff25f80e-eb04-4229-986d-b40223c04f1c",
      "partition": "LocalDateTable_ff25f80e-eb04-4229-986d-b40223c04f1c-6606fc4c-4cda-49e1-8acd-e55a6ec36cb3",
      "status": "Completed"
    },
    {
      "table": "DimCurrency",
      "partition": "DimCurrency-e5524cc4-a898-433b-91aa-c001b9a6d676",
      "status": "Completed"
    },
    {
      "table": "DimCustomer",
      "partition": "DimCustomer-a31bbd93-e20a-4dee-a33c-7afa27785953",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_fa65a206-f320-4d5d-abcc-1dc0f051ca7d",
      "partition": "LocalDateTable_fa65a206-f320-4d5d-abcc-1dc0f051ca7d-06a48a0a-a32b-48a3-b113-924aafd6363c",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_78a4e1b7-a2e5-4bbf-ab68-7c87961b68a2",
      "partition": "LocalDateTable_78a4e1b7-a2e5-4bbf-ab68-7c87961b68a2-5b3ba715-7c84-4e52-b310-485b93cfbe6d",
      "status": "Completed"
    },
    {
      "table": "DimDate",
      "partition": "DimDate-62e2f91b-53e5-4ed3-8618-fec74dba5e0d",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_e72c294f-0a06-4051-b943-e6bf8389e2c3",
      "partition": "LocalDateTable_e72c294f-0a06-4051-b943-e6bf8389e2c3-891a0e68-d414-4ba3-9c4b-e6f1ec73d4f3",
      "status": "Completed"
    },
    {
      "table": "DimProduct",
      "partition": "DimProduct-3d07cc89-2bd7-4a98-bb37-3368c1562f98",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_e37e4431-8c1a-449c-8796-b704df200a92",
      "partition": "LocalDateTable_e37e4431-8c1a-449c-8796-b704df200a92-8596ebb8-418f-4e50-a921-dac88c6f1339",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_73faffeb-a0c7-4ea1-83dc-530823b0fea0",
      "partition": "LocalDateTable_73faffeb-a0c7-4ea1-83dc-530823b0fea0-13795c4e-708f-4ddc-8ea3-5a2f39ae2253",
      "status": "Completed"
    },
    {
      "table": "DimPromotion",
      "partition": "DimPromotion-21e6c333-430e-4350-8c94-cdceb362c4c7",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_9c19746b-db7d-4b7e-b95d-c66e4b8fefc8",
      "partition": "LocalDateTable_9c19746b-db7d-4b7e-b95d-c66e4b8fefc8-395de144-ad53-41c0-9ec0-68bab6158d99",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_d96435dd-6110-4246-996c-616c96125e71",
      "partition": "LocalDateTable_d96435dd-6110-4246-996c-616c96125e71-891737ee-c46c-4b9f-bfa8-e4555004e20f",
      "status": "Completed"
    },
    {
      "table": "DimSalesTerritory",
      "partition": "DimSalesTerritory-6d88f938-13d5-49f8-899c-d11b3d346ad5",
      "status": "Completed"
    },
    {
      "table": "FactInternetSales",
      "status": "Completed"
    }
  ],
  "refreshAttempts": [
    {
      "attemptId": 1,
      "startTime": "2021-12-10T08:40:31.57",
      "endTime": "2021-12-10T08:40:43.87",
      "type": "Data"
    }
  ]
}

Failed refresh example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/fdb91b8f-0a9b-44c1-b6c0-0cb185c6ebfb/datasets/f7fc6510-e151-42a3-850b-d0805a391db0/refreshes/351f7113-59bb-4e5e-8c1e-e15ae7414121

Sample Response

Status code:: 200

{
  "startTime": "2021-12-10T08:39:28.517",
  "endTime": "2021-12-10T08:39:30.04",
  "type": "Full",
  "commitMode": "PartialBatch",
  "status": "Failed",
  "extendedStatus": "Failed",
  "currentRefreshType": "Full",
  "numberOfAttempts": 0,
  "messages": [
    {
      "message": "RefreshApiRequest for table refresh using refresh policy must have the property 'CommitMode' = 'Transactional' instead of 'PartialBatch'.",
      "type": "Error"
    }
  ],
  "refreshAttempts": [
    {
      "attemptId": 1,
      "startTime": "2021-12-10T08:39:28.517",
      "endTime": "2021-12-10T08:39:30.04",
      "serviceExceptionJson": "{\"errorCode\":\"ModelRefresh_ShortMessage_ProcessingError\",\"errorDescription\":\"0xC112001C: Expression.Error: Forced Error. . The exception was raised by the IDbCommand interface.\\n0xC112001C: The command has been canceled.. The exception was raised by the IDbCommand interface.\\n0xC11C0006: The current operation was cancelled because another operation in the transaction failed.\\n0xC112001C: The command has been canceled.. The exception was raised by the IDbCommand interface.\\n0xC112001C: The command has been canceled.. The exception was raised by the IDbCommand interface.\\n0xC112001C: The command has been canceled.. The exception was raised by the IDbCommand interface.\"}",
      "type": "Data"
    }
  ]
}

In progress refresh example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/fdb91b8f-0a9b-44c1-b6c0-0cb185c6ebfb/datasets/f7fc6510-e151-42a3-850b-d0805a391db0/refreshes/630110f5-8f93-49c2-afee-bfc87072460c

Sample Response

Status code:: 202

{
  "startTime": "2021-12-14T03:46:04.833",
  "type": "Full",
  "commitMode": "Transactional",
  "status": "Unknown",
  "extendedStatus": "NotStarted",
  "currentRefreshType": "Full",
  "numberOfAttempts": 0
}

Definice

Name	Description
DatasetRefreshDetail	Položka podrobností o aktualizaci Power BI
DatasetRefreshDetailCommitMode	Určuje, jestli budou objekty potvrzeny v dávkách nebo pouze po dokončení.
DatasetRefreshDetailExtendedStatus	Podrobný stav operace datové sady
DatasetRefreshDetailStatus	Obecný stav operace datové sady
DatasetRefreshDetailType	Typ zpracování, který se má provést
DatasetRefreshObjects	Cíl aktualizace datové sady Power BI
EngineMessage	Chybová nebo varovná zpráva z modulu pro rozšířenou aktualizaci
RefreshAttempt	Power BI automaticky provede několik pokusů o aktualizaci datové sady, pokud dojde k selhání aktualizace. Tento objekt obsahuje informace o každém pokusu o aktualizaci.
RefreshAttemptType	Typ pokusu o aktualizaci.
RefreshEngineErrorType	Typ chyby

DatasetRefreshDetail

Položka podrobností o aktualizaci Power BI

Name	Typ	Description
commitMode	DatasetRefreshDetailCommitMode	Určuje, jestli budou objekty potvrzeny v dávkách nebo pouze po dokončení.
currentRefreshType	DatasetRefreshDetailType	Typ zpracování aktuální iterace. To je užitečné, pokud `commitMode` je nastavená na `PartialBatch`
endTime	string	Koncové datum a čas aktualizace (pokud probíhá aktualizace, může být prázdné)
extendedStatus	DatasetRefreshDetailExtendedStatus	Podrobný stav operace datové sady
messages	EngineMessage[]	Pole chyb modulu nebo varovných zpráv pro žádost o aktualizaci
numberOfAttempts	integer	Počet pokusů o žádost o aktualizaci
objects	DatasetRefreshObjects[]	Pole objektů zahrnutých v žádosti o aktualizaci
refreshAttempts	RefreshAttempt[]	Seznam pokusů o aktualizaci.
startTime	string	Počáteční datum a čas aktualizace
status	DatasetRefreshDetailStatus	Obecný stav operace datové sady
type	DatasetRefreshDetailType	Typ zpracování, který se má provést

DatasetRefreshDetailCommitMode

Určuje, jestli budou objekty potvrzeny v dávkách nebo pouze po dokončení.

Name	Typ	Description
PartialBatch	string	Potvrzení operace aktualizace v dávkách
Transactional	string	Potvrzení celé operace aktualizace jako transakce

DatasetRefreshDetailExtendedStatus

Podrobný stav operace datové sady

Name	Typ	Description
Cancelled	string	Zákazník zrušil operaci aktualizace.
Completed	string	Operace aktualizace se úspěšně dokončila.
Disabled	string	Operace aktualizace je zakázaná selektivní aktualizací.
Failed	string	Operace aktualizace je neúspěšná.
InProgress	string	Probíhá operace aktualizace.
NotStarted	string	Operace aktualizace se nespustila.
TimedOut	string	Vypršel časový limit operace aktualizace.
Unknown	string	Stav dokončení je neznámý.

DatasetRefreshDetailStatus

Obecný stav operace datové sady

Name	Typ	Description
Completed	string	Operace aktualizace se úspěšně dokončila.
Disabled	string	Operace aktualizace je zakázaná selektivní aktualizací.
Failed	string	Operace aktualizace je neúspěšná.
Unknown	string	Stav dokončení je neznámý nebo probíhá aktualizace.

DatasetRefreshDetailType

Typ zpracování, který se má provést

Name	Typ	Description
Automatic	string	Pokud je potřeba objekt aktualizovat a přepočítat, aktualizujte a přepočítáte objekt a všechny jeho závislé objekty. Použije se v případě, že je oddíl v jiném stavu než Připraveno.
Calculate	string	Přepočítáte tento objekt a všechny jeho závislé objekty, ale pouze v případě potřeby. Tato hodnota nevynucuje přepočet, s výjimkou nestálých vzorců.
ClearValues	string	Vymazat hodnoty v tomto objektu a všech jeho závislých
DataOnly	string	Aktualizujte data v tomto objektu a vymažte všechny závislé objekty.
Defragment	string	Defragmentujte data v zadané tabulce. Při přidání nebo odebrání dat do tabulky se slovníky jednotlivých sloupců můžou znečišťovat hodnotami, které už ve skutečných hodnotách sloupců neexistují. Možnost defragmentace vyčistí hodnoty ve slovníkech, které se už nepoužívají.
Full	string	Pro všechny oddíly v zadaném oddílu, tabulce nebo databázi aktualizujte data a přepočítáte všechny závislé. V případě oddílu výpočtu přepočítáte oddíl a všechny jeho závislé oddíly.

DatasetRefreshObjects

Cíl aktualizace datové sady Power BI

Name	Typ	Description
partition	string	Oddíl, který se má aktualizovat
table	string	Tabulka, která se má aktualizovat

EngineMessage

Chybová nebo varovná zpráva z modulu pro rozšířenou aktualizaci

Name	Typ	Description
code	string	Kód chyby v šestnáctkovém formátu
message	string	Text chybové zprávy nebo upozornění
type	RefreshEngineErrorType	Typ chyby

RefreshAttempt

Power BI automaticky provede několik pokusů o aktualizaci datové sady, pokud dojde k selhání aktualizace. Tento objekt obsahuje informace o každém pokusu o aktualizaci.

Name	Typ	Description
attemptId	integer	Index pokusu o aktualizaci.
endTime	string	Koncové datum a čas pokusu o aktualizaci. Pokud probíhá pokus o aktualizaci, hodnota je neplatná.
serviceExceptionJson	string	Kód chyby selhání ve formátu JSON V případě, že nedojde k žádné chybě, je neplatná.
startTime	string	Počáteční datum a čas pokusu o aktualizaci.
type	RefreshAttemptType	Typ pokusu o aktualizaci.

RefreshAttemptType

Typ pokusu o aktualizaci.

Name	Typ	Description
Data	string	Aktualizace se pokusí načíst data do datové sady.
Query	string	Pokus o aktualizaci mezipaměti dotazů Premium a dlaždic řídicího panelu.u

RefreshEngineErrorType

Typ chyby

Name	Typ	Description
Error	string	Chybová zpráva
Warning	string	Zpráva s upozorněním

Sdílet prostřednictvím

Datasets - Get Refresh Execution Details In Group

Oprávnění

Požadovaný obor

Parametry identifikátoru URI

Odpovědi

Příklady

Completed refresh example

Sample Request

Sample Response

Failed refresh example

Sample Request

Sample Response

In progress refresh example

Sample Request

Sample Response

Definice

DatasetRefreshDetail

DatasetRefreshDetailCommitMode

DatasetRefreshDetailExtendedStatus

DatasetRefreshDetailStatus

DatasetRefreshDetailType

DatasetRefreshObjects

EngineMessage

RefreshAttempt

RefreshAttemptType

RefreshEngineErrorType

Další materiály