Datasets - Get Refresh Execution Details

Služba:: Power BI REST APIs

Verze rozhraní API:: v1.0

Vrátí podrobnosti o spuštění rozšířené operace aktualizace pro zadanou datovou sadu z Můj pracovní prostor.

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í, když se operace aktualizace dokončila nebo selhala)
202 Accepted	DatasetRefreshDetail	Akceptovaná (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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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í aktualizace 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 zpráva upozornění z modulu pro vylepš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

Objekt

Položka podrobností aktualizace 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í pro aktuální iteraci. To je užitečné, když je `commitMode` nastavená na `PartialBatch`
endTime	string (date-time)	Koncové datum a čas aktualizace (může být prázdné, pokud probíhá aktualizace)
extendedStatus	DatasetRefreshDetailExtendedStatus	Podrobný stav operace datové sady
messages	EngineMessage[]	Pole chyb nebo upozornění modulu pro žádost o aktualizaci
numberOfAttempts	integer	Počet pokusů o aktualizaci
objects	DatasetRefreshObjects[]	Pole objektů zahrnutých v žádosti o aktualizaci
refreshAttempts	RefreshAttempt[]	Seznam pokusů o aktualizaci.
startTime	string (date-time)	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

Výčet

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

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

DatasetRefreshDetailExtendedStatus

Výčet

Podrobný stav operace datové sady

Hodnota	Description
Unknown	Stav dokončení je neznámý.
NotStarted	Operace aktualizace není spuštěna.
InProgress	Probíhá operace aktualizace.
Completed	Operace aktualizace se úspěšně dokončila.
TimedOut	Vypršel časový limit operace aktualizace.
Failed	Operace aktualizace není úspěšná.
Disabled	Operace aktualizace je zakázána selektivní aktualizací.
Cancelled	Operace aktualizace byla zrušena zákazníkem.

DatasetRefreshDetailStatus

Výčet

Obecný stav operace datové sady

Hodnota	Description
Unknown	Stav dokončení je neznámý nebo probíhá aktualizace.
Completed	Operace aktualizace se úspěšně dokončila.
Failed	Operace aktualizace není úspěšná.
Disabled	Operace aktualizace je zakázána selektivní aktualizací.

DatasetRefreshDetailType

Výčet

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

Hodnota	Description
Full	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é. U oddílu výpočtu přepočítáte oddíl a všechny jeho závislé objekty.
ClearValues	Vymazat hodnoty v tomto objektu a všechny jeho závislé
Calculate	Přepočítejte 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ů.
DataOnly	Aktualizace dat v tomto objektu a vymazání všech závislých objektů
Automatic	Pokud je potřeba objekt aktualizovat a přepočítat, aktualizujte a přepočítejte objekt a všechny jeho závislé objekty. Platí, pokud je oddíl v jiném stavu než Připraveno.
Defragment	Defragmentace dat v zadané tabulce Při přidání nebo odebrání dat z tabulky se slovníky jednotlivých sloupců můžou znečistit 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í.

DatasetRefreshObjects

Objekt

Cíl aktualizace datové sady Power BI

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

EngineMessage

Objekt

Chybová zpráva nebo zpráva upozornění z modulu pro vylepš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

Objekt

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 (date-time)	Koncové datum a čas pokusu o aktualizaci. Hodnota je void, pokud probíhá pokus o aktualizaci.
serviceExceptionJson	string	Kód chyby selhání ve formátu JSON Pokud nedojde k žádné chybě, Void.
startTime	string (date-time)	Počáteční datum a čas pokusu o aktualizaci.
type	RefreshAttemptType	Typ pokusu o aktualizaci.

RefreshAttemptType

Výčet

Typ pokusu o aktualizaci.

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

RefreshEngineErrorType

Výčet

Typ chyby

Hodnota	Description
Error	Zpráva o chybě
Warning	Zpráva s upozorněním

Sdílet prostřednictvím

Datasets - Get Refresh Execution Details

Požadovaný obor

Parametry identifikátoru URI

Odpovědi

Příklady

Completed refresh example

Ukázkový požadavek

Ukázková odpověď

Failed refresh example

Ukázkový požadavek

Ukázková odpověď

In progress refresh example

Ukázkový požadavek

Ukázková odpověď

Definice

DatasetRefreshDetail

DatasetRefreshDetailCommitMode

DatasetRefreshDetailExtendedStatus

DatasetRefreshDetailStatus

DatasetRefreshDetailType

DatasetRefreshObjects

EngineMessage

RefreshAttempt

RefreshAttemptType

RefreshEngineErrorType