Datasets - Get Refresh Execution Details

Reference

Service:: Power BI REST APIs

API Version:: v1.0

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

Požadovaný obor

Dataset.ReadWrite.All nebo Dataset.Read.All

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

Parametry identifikátoru URI

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

Odpovědi

Name	Typ	Description
200 OK	DatasetRefreshDetail	OK (tato odpověď se vrátí po dokončení nebo selhání operace aktualizace)
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/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/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/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, zda 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á zpráva nebo upozornění 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, zda 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é, když `commitMode` je nastavená na `PartialBatch`
endTime	string	Koncové datum a čas aktualizace (může být prázdné, pokud aktualizace probíhá)
extendedStatus	DatasetRefreshDetailExtendedStatus	Podrobný stav operace datové sady
messages	EngineMessage[]	Pole chyb modulu nebo upozornění 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, zda 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ázána selektivní aktualizací.
Failed	string	Operace aktualizace nebyla úspěšná.
InProgress	string	Probíhá operace aktualizace.
NotStarted	string	Operace aktualizace není spuštěná.
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ázána selektivní aktualizací.
Failed	string	Operace aktualizace nebyla ú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. Platí, pokud je oddíl v jiném stavu než Připraveno.
Calculate	string	Přepočítat 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	Aktualizovat data v tomto objektu a vymazat všechny závislé objekty
Defragment	string	Defragmentujte data v zadané tabulce. Při přidání dat do tabulky nebo jejich odebrání 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ících, 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á zpráva nebo upozornění 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 varovné zprávy
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 void.
serviceExceptionJson	string	Kód chyby selhání ve formátu JSON Pokud 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ů úrovně Premium a dlaždic řídicího panelu

RefreshEngineErrorType

Typ chyby

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

Sdílet prostřednictvím

Datasets - Get Refresh Execution Details

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