Datasets - Get Refresh Execution Details

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gibt Ausführungsdetails eines erweiterten Aktualisierungsvorgangs für das angegebene Dataset aus My workspacezurück.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string (uuid)	Die Dataset-ID
refreshId	path	True	string (uuid)	Die Aktualisierungs-ID

Antworten

Name	Typ	Beschreibung
200 OK	DatasetRefreshDetail	OK (diese Antwort wird zurückgegeben, wenn der Aktualisierungsvorgang abgeschlossen oder fehlgeschlagen ist)
202 Accepted	DatasetRefreshDetail	Akzeptiert (diese Antwort wird zurückgegeben, wenn der Aktualisierungsvorgang noch ausgeführt wird)

Beispiele

Completed refresh example

Failed refresh example

In progress refresh example

Completed refresh example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 202

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

Definitionen

Name	Beschreibung
DatasetRefreshDetail	Ein Power BI-Aktualisierungsdetailseintrag
DatasetRefreshDetailCommitMode	Bestimmt, ob Objekte in Batches oder nur nach Abschluss zugesichert werden.
DatasetRefreshDetailExtendedStatus	Detaillierter Status des Datasetvorgangs
DatasetRefreshDetailStatus	Allgemeiner Status des Datasetvorgangs
DatasetRefreshDetailType	Der Typ der auszuführenden Verarbeitung
DatasetRefreshObjects	Power BI-Datasetaktualisierungsziel
EngineMessage	Die Fehlermeldung oder Warnmeldung des Moduls für die erweiterte Aktualisierung
RefreshAttempt	Power BI führt automatisch mehrere Versuche aus, ein Dataset zu aktualisieren, wenn ein Aktualisierungsfehler auftritt. Dieses Objekt enthält Informationen zu jedem Aktualisierungsversuch.
RefreshAttemptType	Der Typ des Aktualisierungsversuchs.
RefreshEngineErrorType	Der Typ des Fehlers

DatasetRefreshDetail

Objekt

Ein Power BI-Aktualisierungsdetailseintrag

Name	Typ	Beschreibung
commitMode	DatasetRefreshDetailCommitMode	Bestimmt, ob Objekte in Batches oder nur nach Abschluss zugesichert werden.
currentRefreshType	DatasetRefreshDetailType	Der Typ der Verarbeitung für die aktuelle Iteration. Dies ist nützlich, wenn `commitMode` auf `PartialBatch`
endTime	string (date-time)	Das Enddatum und die Uhrzeit der Aktualisierung (kann leer sein, wenn eine Aktualisierung ausgeführt wird)
extendedStatus	DatasetRefreshDetailExtendedStatus	Detaillierter Status des Datasetvorgangs
messages	EngineMessage[]	Ein Array von Modulfehlern oder Warnmeldungen für die Aktualisierungsanforderung
numberOfAttempts	integer	Die Anzahl der Versuche für die Aktualisierungsanforderung
objects	DatasetRefreshObjects[]	Ein Array von Objekten, die in der Aktualisierungsanforderung enthalten sind
refreshAttempts	RefreshAttempt[]	Die Aktualisierungsversuchsliste.
startTime	string (date-time)	Das Startdatum und die Uhrzeit der Aktualisierung
status	DatasetRefreshDetailStatus	Allgemeiner Status des Datasetvorgangs
type	DatasetRefreshDetailType	Der Typ der auszuführenden Verarbeitung

DatasetRefreshDetailCommitMode

Enumeration

Bestimmt, ob Objekte in Batches oder nur nach Abschluss zugesichert werden.

Wert	Beschreibung
Transactional	Commit des gesamten Aktualisierungsvorgangs als Transaktion
PartialBatch	Commit des Aktualisierungsvorgangs in Batches

DatasetRefreshDetailExtendedStatus

Enumeration

Detaillierter Status des Datasetvorgangs

Wert	Beschreibung
Unknown	Der Abschlussstatus ist unbekannt.
NotStarted	Der Aktualisierungsvorgang wird nicht gestartet.
InProgress	Der Aktualisierungsvorgang wird ausgeführt.
Completed	Der Aktualisierungsvorgang wurde erfolgreich abgeschlossen.
TimedOut	Timeout des Aktualisierungsvorgangs
Failed	Der Aktualisierungsvorgang ist nicht erfolgreich.
Disabled	Der Aktualisierungsvorgang wird durch eine selektive Aktualisierung deaktiviert.
Cancelled	Der Aktualisierungsvorgang wurde vom Kunden abgebrochen.

DatasetRefreshDetailStatus

Enumeration

Allgemeiner Status des Datasetvorgangs

Wert	Beschreibung
Unknown	Der Abschlussstatus ist unbekannt, oder eine Aktualisierung wird ausgeführt.
Completed	Der Aktualisierungsvorgang wurde erfolgreich abgeschlossen.
Failed	Der Aktualisierungsvorgang ist nicht erfolgreich.
Disabled	Der Aktualisierungsvorgang wird durch eine selektive Aktualisierung deaktiviert.

DatasetRefreshDetailType

Enumeration

Der Typ der auszuführenden Verarbeitung

Wert	Beschreibung
Full	Aktualisieren Sie für alle Partitionen in der angegebenen Partition, Tabelle oder Datenbank Daten, und berechnen Sie alle Abhängigen neu. Bei einer Berechnungspartition müssen Sie die Partition und alle abhängigen Partitionen neu berechnen.
ClearValues	Löschen von Werten in diesem Objekt und allen abhängigen Objekten
Calculate	Berechnen Sie dieses Objekt und alle abhängigen Objekte neu, aber nur bei Bedarf. Dieser Wert erzwingt keine Neuberechnung, außer bei veränderliche Formeln.
DataOnly	Aktualisieren von Daten in diesem Objekt und Löschen aller Abhängigen
Automatic	Wenn das Objekt aktualisiert und neu berechnet werden muss, aktualisieren und berechnen Sie das Objekt und alle nachfolger. Gilt, wenn sich die Partition in einem anderen Zustand als "Ready" befindet.
Defragment	Defragmentieren sie die Daten in der angegebenen Tabelle. Wenn Daten zu einer Tabelle hinzugefügt oder daraus entfernt werden, können die Wörterbücher jeder Spalte mit Werten verunreinigt werden, die nicht mehr in den tatsächlichen Spaltenwerten vorhanden sind. Die Defragmentierungsoption bereinigt die Werte in den Wörterbüchern, die nicht mehr verwendet werden.

DatasetRefreshObjects

Objekt

Power BI-Datasetaktualisierungsziel

Name	Typ	Beschreibung
partition	string	Zu aktualisierende Partition
table	string	Zu aktualisierende Tabelle

EngineMessage

Objekt

Die Fehlermeldung oder Warnmeldung des Moduls für die erweiterte Aktualisierung

Name	Typ	Beschreibung
code	string	Der Fehlercode im Hex-Format
message	string	Der Text des Fehlers oder der Warnmeldung
type	RefreshEngineErrorType	Der Typ des Fehlers

RefreshAttempt

Objekt

Power BI führt automatisch mehrere Versuche aus, ein Dataset zu aktualisieren, wenn ein Aktualisierungsfehler auftritt. Dieses Objekt enthält Informationen zu jedem Aktualisierungsversuch.

Name	Typ	Beschreibung
attemptId	integer	Der Index des Aktualisierungsversuchs.
endTime	string (date-time)	Das Enddatum und die Uhrzeit des Aktualisierungsversuchs. Der Wert ist ungültig, wenn der Aktualisierungsversuch ausgeführt wird.
serviceExceptionJson	string	Fehlerfehlercode im JSON-Format. Ungültig, wenn kein Fehler auftritt.
startTime	string (date-time)	Das Startdatum und die Uhrzeit des Aktualisierungsversuchs.
type	RefreshAttemptType	Der Typ des Aktualisierungsversuchs.

RefreshAttemptType

Enumeration

Der Typ des Aktualisierungsversuchs.

Wert	Beschreibung
Data	Der Aktualisierungsversuch zum Laden von Daten in das Dataset.
Query	Der Versuch, Premium-Abfragecaches und Dashboardkacheln zu aktualisieren.u

RefreshEngineErrorType

Enumeration

Der Typ des Fehlers

Wert	Beschreibung
Error	Fehlermeldung
Warning	Warnmeldung

Freigeben über

Datasets - Get Refresh Execution Details

Erforderlicher Bereich

URI-Parameter

Antworten

Beispiele

Completed refresh example

Beispielanforderung

Beispiel für eine Antwort

Failed refresh example

Beispielanforderung

Beispiel für eine Antwort

In progress refresh example

Beispielanforderung

Beispiel für eine Antwort

Definitionen

DatasetRefreshDetail

DatasetRefreshDetailCommitMode

DatasetRefreshDetailExtendedStatus

DatasetRefreshDetailStatus

DatasetRefreshDetailType

DatasetRefreshObjects

EngineMessage

RefreshAttempt

RefreshAttemptType

RefreshEngineErrorType