Datasets - Get Refresh Execution Details

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Gibt Ausführungsdetails eines erweiterten Aktualisierungsvorgangs für das angegebene Dataset aus "Mein Arbeitsbereich" zurü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

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
}

Definitionen

Name	Beschreibung
DatasetRefreshDetail	Ein Power BI-Aktualisierungsdetailseintrag
DatasetRefreshDetailCommitMode	Bestimmt, ob Objekte in Batches oder nur nach Abschluss eines Commits ausgeführt werden.
DatasetRefreshDetailExtendedStatus	Detaillierte status des Datasetvorgangs
DatasetRefreshDetailStatus	Allgemeine status des Datasetvorgangs
DatasetRefreshDetailType	Der Typ der auszuführenden Verarbeitung
DatasetRefreshObjects	Aktualisierungsziel für Power BI-Datasets
EngineMessage	Die Fehlermeldung oder Warnmeldung der Engine für die erweiterte Aktualisierung
RefreshAttempt	Power BI führt automatisch mehrere Versuche durch, 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

Ein Power BI-Aktualisierungsdetailseintrag

Name	Typ	Beschreibung
commitMode	DatasetRefreshDetailCommitMode	Bestimmt, ob Objekte in Batches oder nur nach Abschluss eines Commits ausgeführt werden.
currentRefreshType	DatasetRefreshDetailType	Der Verarbeitungstyp für die aktuelle Iteration. Dies ist nützlich, wenn `commitMode` auf festgelegt ist `PartialBatch`
endTime	string	Das Enddatum und die Uhrzeit der Aktualisierung (kann leer sein, wenn eine Aktualisierung ausgeführt wird)
extendedStatus	DatasetRefreshDetailExtendedStatus	Detaillierte status des Datasetvorgangs
messages	EngineMessage[]	Ein Array von Enginefehlern 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 Liste der Aktualisierungsversuche.
startTime	string	Startdatum und -uhrzeit der Aktualisierung
status	DatasetRefreshDetailStatus	Allgemeine status des Datasetvorgangs
type	DatasetRefreshDetailType	Der Typ der auszuführenden Verarbeitung

DatasetRefreshDetailCommitMode

Bestimmt, ob Objekte in Batches oder nur nach Abschluss eines Commits ausgeführt werden.

Name	Typ	Beschreibung
PartialBatch	string	Committen des Aktualisierungsvorgangs in Batches
Transactional	string	Committen des gesamten Aktualisierungsvorgangs als Transaktion

DatasetRefreshDetailExtendedStatus

Detaillierte status des Datasetvorgangs

Name	Typ	Beschreibung
Cancelled	string	Der Aktualisierungsvorgang wurde vom Kunden abgebrochen.
Completed	string	Der Aktualisierungsvorgang wurde erfolgreich abgeschlossen.
Disabled	string	Der Aktualisierungsvorgang wird durch eine selektive Aktualisierung deaktiviert.
Failed	string	Der Aktualisierungsvorgang ist nicht erfolgreich.
InProgress	string	Der Aktualisierungsvorgang wird ausgeführt.
NotStarted	string	Der Aktualisierungsvorgang wurde nicht gestartet.
TimedOut	string	Für den Aktualisierungsvorgang wird ein Timeout ausgeführt.
Unknown	string	Der Abschlussstatus ist unbekannt.

DatasetRefreshDetailStatus

Allgemeine status des Datasetvorgangs

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

DatasetRefreshDetailType

Der Typ der auszuführenden Verarbeitung

Name	Typ	Beschreibung
Automatic	string	Wenn das Objekt aktualisiert und neu berechnet werden muss, werden hiermit das Objekt und alle abhängigen Elemente aktualisiert und neu berechnet. Gilt, wenn die Partition in einem anderen Zustand als „bereit“ ist.
Calculate	string	Hiermit werden dieses Objekt und alle abhängigen Elemente neu berechnet, aber nur, wenn erforderlich. Dieser Wert erzwingt keine Neuberechnung, mit Ausnahme von flüchtigen Formeln.
ClearValues	string	Löschen von Werten in diesem Objekt und allen abhängigen Elementen
DataOnly	string	Aktualisieren von Daten in diesem Objekt und Löschen aller abhängigen Elemente
Defragment	string	Hiermit werden die Daten in der angegebenen Tabelle defragmentiert. Beim Hinzufügen oder Entfernen von Daten zu bzw. aus einer Tabelle verbleiben in den Wörterbüchern für jede Spalte Werte, die nicht mehr in den tatsächlichen Spaltenwerten vorhanden sind. Die Defragmentierung bereinigt die Werte in den Wörterbüchern, die nicht mehr verwendet werden.
Full	string	Hiermit werden für alle Partitionen in der angegebenen Partition, Tabelle oder Datenbank die Daten aktualisiert und alle abhängigen Elemente neu berechnet. Hiermit werden für eine Berechnungspartition die Partition und alle abhängigen Elemente neu berechnet.

DatasetRefreshObjects

Aktualisierungsziel für Power BI-Datasets

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

EngineMessage

Die Fehlermeldung oder Warnmeldung der Engine für die erweiterte Aktualisierung

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

RefreshAttempt

Power BI führt automatisch mehrere Versuche durch, 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	Das Enddatum und die Uhrzeit des Aktualisierungsversuchs. Der Wert ist ungültig, wenn der Aktualisierungsversuch ausgeführt wird.
serviceExceptionJson	string	Fehlerfehlercode im JSON-Format. Void, wenn kein Fehler vorliegt.
startTime	string	Das Startdatum und die Uhrzeit des Aktualisierungsversuchs.
type	RefreshAttemptType	Der Typ des Aktualisierungsversuchs.

RefreshAttemptType

Der Typ des Aktualisierungsversuchs.

Name	Typ	Beschreibung
Data	string	Der Aktualisierungsversuch, Daten in das Dataset zu laden.
Query	string	Der Versuch, Premium-Abfragecaches zu aktualisieren und kacheln Dashboard.u

RefreshEngineErrorType

Der Typ des Fehlers

Name	Typ	Beschreibung
Error	string	Fehlermeldung
Warning	string	Warnmeldung

Freigeben über

Datasets - Get Refresh Execution Details

Erforderlicher Bereich

URI-Parameter

Antworten

Beispiele

Completed refresh example

Sample Request

Sample Response

Failed refresh example

Sample Request

Sample Response

In progress refresh example

Sample Request

Sample Response

Definitionen

DatasetRefreshDetail

DatasetRefreshDetailCommitMode

DatasetRefreshDetailExtendedStatus

DatasetRefreshDetailStatus

DatasetRefreshDetailType

DatasetRefreshObjects

EngineMessage

RefreshAttempt

RefreshAttemptType

RefreshEngineErrorType

Zusätzliche Ressourcen