Datasets - Get Refresh Execution Details

Odwołanie

Usługa:: Power BI REST APIs

Wersja interfejsu API:: v1.0

Zwraca szczegóły wykonywania rozszerzonej operacji odświeżania dla określonego zestawu danych z Mój obszar roboczy.

Wymagany zakres

Dataset.ReadWrite.All lub Dataset.Read.All

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
datasetId	path	True	string (uuid)	Identyfikator zestawu danych
refreshId	path	True	string (uuid)	Identyfikator odświeżania

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DatasetRefreshDetail	OK (ta odpowiedź jest zwracana, gdy operacja odświeżania została ukończona lub nie powiodła się)
202 Accepted	DatasetRefreshDetail	Zaakceptowano (ta odpowiedź jest zwracana, gdy operacja odświeżania jest nadal w toku)

Przykłady

Completed refresh example

Failed refresh example

In progress refresh example

Completed refresh example

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 202

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

Definicje

Nazwa	Opis
DatasetRefreshDetail	Wpis szczegółów odświeżania usługi Power BI
DatasetRefreshDetailCommitMode	Określa, czy obiekty zostaną zatwierdzone w partiach lub tylko po zakończeniu
DatasetRefreshDetailExtendedStatus	Stan szczegółowa operacji zestawu danych
DatasetRefreshDetailStatus	Stan ogólny operacji zestawu danych
DatasetRefreshDetailType	Typ przetwarzania do wykonania
DatasetRefreshObjects	Element docelowy odświeżania zestawu danych usługi Power BI
EngineMessage	Komunikat o błędzie lub ostrzeżeniu z aparatu na potrzeby rozszerzonego odświeżania
RefreshAttempt	Usługa Power BI automatycznie podejmuje wiele prób odświeżenia zestawu danych, jeśli wystąpi błąd odświeżania. Ten obiekt zawiera informacje o każdej próbie odświeżenia.
RefreshAttemptType	Typ próby odświeżenia.
RefreshEngineErrorType	Typ błędu

DatasetRefreshDetail

Objekt

Wpis szczegółów odświeżania usługi Power BI

Nazwa	Typ	Opis
commitMode	DatasetRefreshDetailCommitMode	Określa, czy obiekty zostaną zatwierdzone w partiach lub tylko po zakończeniu
currentRefreshType	DatasetRefreshDetailType	Typ przetwarzania bieżącej iteracji. Jest to przydatne, gdy `commitMode` jest ustawiona na `PartialBatch`
endTime	string (date-time)	Data i godzina zakończenia odświeżania (może być pusta, jeśli trwa odświeżanie)
extendedStatus	DatasetRefreshDetailExtendedStatus	Stan szczegółowa operacji zestawu danych
messages	EngineMessage[]	Tablica komunikatów o błędzie aparatu lub ostrzeżeniach dotyczących żądania odświeżania
numberOfAttempts	integer	Liczba prób żądania odświeżenia
objects	DatasetRefreshObjects[]	Tablica obiektów uwzględnionych w żądaniu odświeżania
refreshAttempts	RefreshAttempt[]	Lista prób odświeżenia.
startTime	string (date-time)	Data i godzina rozpoczęcia odświeżania
status	DatasetRefreshDetailStatus	Stan ogólny operacji zestawu danych
type	DatasetRefreshDetailType	Typ przetwarzania do wykonania

DatasetRefreshDetailCommitMode

Wyliczanie

Określa, czy obiekty zostaną zatwierdzone w partiach lub tylko po zakończeniu

Wartość	Opis
PartialBatch	Zatwierdzanie operacji odświeżania w partiach
Transactional	Zatwierdzanie całej operacji odświeżania jako transakcji

DatasetRefreshDetailExtendedStatus

Wyliczanie

Stan szczegółowa operacji zestawu danych

Wartość	Opis
Cancelled	Operacja odświeżania została anulowana przez klienta
Completed	Operacja odświeżania została pomyślnie ukończona
Disabled	Operacja odświeżania jest wyłączona przez selektywne odświeżanie
Failed	Operacja odświeżania nie powiodła się
InProgress	Operacja odświeżania jest w toku
NotStarted	Operacja odświeżania nie została uruchomiona
TimedOut	Upłynął limit czasu operacji odświeżania
Unknown	Stan ukończenia jest nieznany

DatasetRefreshDetailStatus

Wyliczanie

Stan ogólny operacji zestawu danych

Wartość	Opis
Completed	Operacja odświeżania została pomyślnie ukończona
Disabled	Operacja odświeżania jest wyłączona przez selektywne odświeżanie
Failed	Operacja odświeżania nie powiodła się
Unknown	Stan ukończenia jest nieznany lub trwa odświeżanie

DatasetRefreshDetailType

Wyliczanie

Typ przetwarzania do wykonania

Wartość	Opis
Automatic	Jeśli obiekt musi zostać odświeżony i ponownie obliczony, odśwież i oblicz ponownie obiekt oraz wszystkie jego zależności. Dotyczy, jeśli partycja jest w stanie innym niż Gotowe.
Calculate	Oblicz ponownie ten obiekt i wszystkie jego zależności, ale tylko w razie potrzeby. Ta wartość nie wymusza ponownego obliczania, z wyjątkiem formuł nietrwałych.
ClearValues	Wyczyść wartości w tym obiekcie i wszystkie jego zależności
DataOnly	Odśwież dane w tym obiekcie i wyczyść wszystkie zależności
Defragment	Defragmentuj dane w określonej tabeli. W miarę dodawania lub usuwania danych z tabeli słowniki każdej kolumny mogą stać się zanieczyszczone wartościami, które już nie istnieją w rzeczywistych wartościach kolumn. Opcja defragmentacji wyczyści wartości w słownikach, które nie są już używane.
Full	Dla wszystkich partycji w określonej partycji, tabeli lub bazie danych odśwież dane i oblicz ponownie wszystkie zależności. W przypadku partycji obliczeniowej oblicz ponownie partycję i wszystkie jej zależności.

DatasetRefreshObjects

Objekt

Element docelowy odświeżania zestawu danych usługi Power BI

Nazwa	Typ	Opis
partition	string	Partycja do odświeżenia
table	string	Tabela do odświeżenia

EngineMessage

Objekt

Komunikat o błędzie lub ostrzeżeniu z aparatu na potrzeby rozszerzonego odświeżania

Nazwa	Typ	Opis
code	string	Kod błędu w formacie szesnastkowym
message	string	Tekst komunikatu o błędzie lub ostrzeżeniu
type	RefreshEngineErrorType	Typ błędu

RefreshAttempt

Objekt

Usługa Power BI automatycznie podejmuje wiele prób odświeżenia zestawu danych, jeśli wystąpi błąd odświeżania. Ten obiekt zawiera informacje o każdej próbie odświeżenia.

Nazwa	Typ	Opis
attemptId	integer	Indeks próby odświeżenia.
endTime	string (date-time)	Data i godzina zakończenia próby odświeżenia. Wartość jest pusta, jeśli próba odświeżenia jest w toku.
serviceExceptionJson	string	Kod błędu w formacie JSON. Unieważnij, jeśli nie ma błędu.
startTime	string (date-time)	Data i godzina rozpoczęcia próby odświeżenia.
type	RefreshAttemptType	Typ próby odświeżenia.

RefreshAttemptType

Wyliczanie

Typ próby odświeżenia.

Wartość	Opis
Data	Odświeżanie próbuje załadować dane do zestawu danych.
Query	Próba odświeżenia pamięci podręcznych zapytań w warstwie Premium i kafelków pulpitu nawigacyjnego.u

RefreshEngineErrorType

Wyliczanie

Typ błędu

Wartość	Opis
Error	Komunikat o błędzie
Warning	Komunikat ostrzegawczy

Udostępnij za pośrednictwem

Datasets - Get Refresh Execution Details

Wymagany zakres

Parametry identyfikatora URI

Odpowiedzi

Przykłady

Completed refresh example

Przykładowe żądanie

Przykładowa odpowiedź

Failed refresh example

Przykładowe żądanie

Przykładowa odpowiedź

In progress refresh example

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

DatasetRefreshDetail

DatasetRefreshDetailCommitMode

DatasetRefreshDetailExtendedStatus

DatasetRefreshDetailStatus

DatasetRefreshDetailType

DatasetRefreshObjects

EngineMessage

RefreshAttempt

RefreshAttemptType

RefreshEngineErrorType

Dodatkowe zasoby