Datasets - Get Refresh Execution Details In Group

Referenz

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gibt Ausführungsdetails eines erweiterten Aktualisierungsvorgangs für das angegebene Dataset aus dem angegebenen Arbeitsbereich zurück.

Berechtigungen

Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter Dienstprinzipalprofile in Power BI Embedded.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string uuid	Die Dataset-ID
groupId	path	True	string uuid	Arbeitsbereich-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/groups/fdb91b8f-0a9b-44c1-b6c0-0cb185c6ebfb/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/groups/fdb91b8f-0a9b-44c1-b6c0-0cb185c6ebfb/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/groups/fdb91b8f-0a9b-44c1-b6c0-0cb185c6ebfb/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-Aktualisierungsdetailsetaileintrag
DatasetRefreshDetailCommitMode	Bestimmt, ob Objekte in Batches oder erst nach Abschluss des Commits ausgeführt werden.
DatasetRefreshDetailExtendedStatus	Datasetvorgang detailliert status
DatasetRefreshDetailStatus	Datasetvorgang allgemein status
DatasetRefreshDetailType	Die Art der auszuführenden Verarbeitung
DatasetRefreshObjects	Ziel für die Aktualisierung des Power BI-Datasets
EngineMessage	Fehler- oder Warnmeldung des Moduls für die erweiterte Aktualisierung
RefreshAttempt	Power BI führt automatisch mehrere Versuche zum Aktualisieren eines Datasets durch, wenn ein Aktualisierungsfehler auftritt. Dieses Objekt enthält Informationen zu jedem Aktualisierungsversuch.
RefreshAttemptType	Der Typ des Aktualisierungsversuchs.
RefreshEngineErrorType	Der Typ des Fehlers

DatasetRefreshDetail

Object

Ein Power BI-Aktualisierungsdetailsetaileintrag

Name	Typ	Beschreibung
commitMode	DatasetRefreshDetailCommitMode	Bestimmt, ob Objekte in Batches oder erst nach Abschluss des 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	Datasetvorgang detailliert status
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	Datasetvorgang allgemein status
type	DatasetRefreshDetailType	Die Art der auszuführenden Verarbeitung

DatasetRefreshDetailCommitMode

Enumeration

Bestimmt, ob Objekte in Batches oder erst nach Abschluss des Commits ausgeführt werden.

Wert	Beschreibung
PartialBatch	Commit für den Aktualisierungsvorgang in Batches
Transactional	Commit für den gesamten Aktualisierungsvorgang als Transaktion

DatasetRefreshDetailExtendedStatus

Enumeration

Datasetvorgang detailliert status

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

DatasetRefreshDetailStatus

Enumeration

Datasetvorgang allgemein status

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

DatasetRefreshDetailType

Enumeration

Die Art der auszuführenden Verarbeitung

Wert	Beschreibung
Automatic	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	Hiermit werden dieses Objekt und alle abhängigen Elemente neu berechnet, aber nur, wenn erforderlich. Mit Ausnahme von flüchtigen Formeln erzwingt dieser Wert keine Neuberechnung.
ClearValues	Löschen von Werten in diesem Objekt und allen abhängigen Objekten
DataOnly	Aktualisieren von Daten in diesem Objekt und Löschen aller abhängigen Elemente
Defragment	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	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

Object

Ziel für die Aktualisierung des Power BI-Datasets

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

EngineMessage

Object

Fehler- oder Warnmeldung des Moduls für die erweiterte Aktualisierung

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

RefreshAttempt

Object

Power BI führt automatisch mehrere Versuche zum Aktualisieren eines Datasets durch, 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

Enumeration

Der Typ des Aktualisierungsversuchs.

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

RefreshEngineErrorType

Enumeration

Der Typ des Fehlers

Wert	Beschreibung
Error	Fehlermeldung
Warning	Warnmeldung

Freigeben über

Datasets - Get Refresh Execution Details In Group

Berechtigungen

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

Zusätzliche Ressourcen