Datasets - Get Refresh Execution Details In Group

Referenz

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

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
}

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

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

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

Name	Typ	Beschreibung
PartialBatch	string	Commit für den Aktualisierungsvorgang in Batches
Transactional	string	Commit für den gesamten Aktualisierungsvorgang als Transaktion

DatasetRefreshDetailExtendedStatus

Datasetvorgang detailliert status

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 ist ein Timeout festgelegt.
Unknown	string	Der Abschlusszustand ist unbekannt.

DatasetRefreshDetailStatus

Datasetvorgang allgemein status

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 es wird eine Aktualisierung ausgeführt.

DatasetRefreshDetailType

Die Art 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. Mit Ausnahme von flüchtigen Formeln erzwingt dieser Wert keine Neuberechnung.
ClearValues	string	Löschen von Werten in diesem Objekt und allen abhängigen Objekten
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

Ziel für die Aktualisierung des Power BI-Datasets

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

EngineMessage

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

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

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 Dashboard kacheln.u

RefreshEngineErrorType

Der Typ des Fehlers

Name	Typ	Beschreibung
Error	string	Fehlermeldung
Warning	string	Warnmeldung

Freigeben über

Datasets - Get Refresh Execution Details In Group

Berechtigungen

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