Datasets - Get Refresh Execution Details In Group

Odwołanie

Service:: Power BI REST APIs

API Version:: v1.0

Zwraca szczegóły wykonywania rozszerzonej operacji odświeżania dla określonego zestawu danych z określonego obszaru roboczego.

Uprawnienia

To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: Profile jednostki usługi w Power BI Embedded.

Wymagany zakres

Dataset.ReadWrite.All lub Dataset.Read.All

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
datasetId	path	True	string uuid	Identyfikator zestawu danych
groupId	path	True	string uuid	Identyfikator obszaru roboczego
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 zakoń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

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
}

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ółowy 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

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 dla bieżącej iteracji. Jest to przydatne, gdy `commitMode` jest ustawiona wartość `PartialBatch`
endTime	string	Data i godzina zakończenia odświeżania (może być pusta, jeśli odświeżanie jest w toku)
extendedStatus	DatasetRefreshDetailExtendedStatus	Stan szczegółowy 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żania
objects	DatasetRefreshObjects[]	Tablica obiektów uwzględnionych w żądaniu odświeżania
refreshAttempts	RefreshAttempt[]	Lista prób odświeżenia.
startTime	string	Data i godzina rozpoczęcia odświeżania
status	DatasetRefreshDetailStatus	Stan ogólny operacji zestawu danych
type	DatasetRefreshDetailType	Typ przetwarzania do wykonania

DatasetRefreshDetailCommitMode

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

Nazwa	Typ	Opis
PartialBatch	string	Zatwierdzanie operacji odświeżania w partiach
Transactional	string	Zatwierdzanie całej operacji odświeżania jako transakcji

DatasetRefreshDetailExtendedStatus

Stan szczegółowy operacji zestawu danych

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

DatasetRefreshDetailStatus

Stan ogólny operacji zestawu danych

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

DatasetRefreshDetailType

Typ przetwarzania do wykonania

Nazwa	Typ	Opis
Automatic	string	Jeśli obiekt musi zostać odświeżony i ponownie obliczony, odśwież i ponownie oblicz obiekt i wszystkie jego zależności. Ma zastosowanie, jeśli partycja jest w stanie innym niż Gotowe.
Calculate	string	Ponownie oblicz 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	string	Wyczyść wartości w tym obiekcie i wszystkie jego zależności
DataOnly	string	Odśwież dane w tym obiekcie i wyczyść wszystkie zależności
Defragment	string	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 spowoduje wyczyszczenie wartości w słownikach, które nie są już używane.
Full	string	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 ponownie oblicz partycję i wszystkie jej zależności.

DatasetRefreshObjects

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

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

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	Data i godzina zakończenia próby odświeżenia. Wartość jest unieważniona, jeśli próba odświeżenia jest w toku.
serviceExceptionJson	string	Kod błędu błędu w formacie JSON. Unieważnij, jeśli nie ma błędu.
startTime	string	Data i godzina rozpoczęcia próby odświeżenia.
type	RefreshAttemptType	Typ próby odświeżenia.

RefreshAttemptType

Typ próby odświeżenia.

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

RefreshEngineErrorType

Typ błędu

Nazwa	Typ	Opis
Error	string	Komunikat o błędzie
Warning	string	Komunikat ostrzegawczy

Udostępnij za pośrednictwem

Datasets - Get Refresh Execution Details In Group

Uprawnienia

Wymagany zakres

Parametry identyfikatora URI

Odpowiedzi

Przykłady

Completed refresh example

Sample Request

Sample Response

Failed refresh example

Sample Request

Sample Response

In progress refresh example

Sample Request

Sample Response

Definicje

DatasetRefreshDetail

DatasetRefreshDetailCommitMode

DatasetRefreshDetailExtendedStatus

DatasetRefreshDetailStatus

DatasetRefreshDetailType

DatasetRefreshObjects

EngineMessage

RefreshAttempt

RefreshAttemptType

RefreshEngineErrorType

Dodatkowe zasoby