Datasets - Get Refresh Execution Details
Devuelve los detalles de ejecución de una operación de actualización mejorada para el conjunto de datos especificado de Mi área de trabajo.
Ámbito requerido
Dataset.ReadWrite.All o Dataset.Read.All
GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes/{refreshId}
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
dataset
|
path | True |
string uuid |
El identificador del conjunto de datos |
refresh
|
path | True |
string uuid |
El identificador de actualización |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Correcto (esta respuesta se devuelve cuando la operación de actualización se ha completado o ha producido un error). |
|
202 Accepted |
Aceptado (esta respuesta se devuelve cuando la operación de actualización sigue en curso) |
Ejemplos
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
{
"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
{
"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
{
"startTime": "2021-12-14T03:46:04.833",
"type": "Full",
"commitMode": "Transactional",
"status": "Unknown",
"extendedStatus": "NotStarted",
"currentRefreshType": "Full",
"numberOfAttempts": 0
}
Definiciones
Nombre | Description |
---|---|
Dataset |
Una entrada de detalles de actualización de Power BI |
Dataset |
Determina si los objetos se confirmarán en lotes o solo cuando se completen. |
Dataset |
Estado detallado de la operación del conjunto de datos |
Dataset |
Estado general de la operación del conjunto de datos |
Dataset |
Tipo de procesamiento que se va a realizar |
Dataset |
Destino de actualización del conjunto de datos de Power BI |
Engine |
Mensaje de error o advertencia del motor para una actualización mejorada |
Refresh |
Power BI realiza automáticamente varios intentos de actualizar un conjunto de datos si experimenta un error de actualización. Este objeto contiene información sobre cada intento de actualización. |
Refresh |
Tipo de intento de actualización. |
Refresh |
El tipo de error |
DatasetRefreshDetail
Una entrada de detalles de actualización de Power BI
Nombre | Tipo | Description |
---|---|---|
commitMode |
Determina si los objetos se confirmarán en lotes o solo cuando se completen. |
|
currentRefreshType |
Tipo de procesamiento para la iteración actual. Esto resulta útil cuando |
|
endTime |
string |
La fecha y hora de finalización de la actualización (puede estar vacía si hay una actualización en curso) |
extendedStatus |
Estado detallado de la operación del conjunto de datos |
|
messages |
Matriz de mensajes de error o advertencia del motor para la solicitud de actualización |
|
numberOfAttempts |
integer |
Número de intentos de la solicitud de actualización |
objects |
Matriz de objetos incluidos en la solicitud de actualización |
|
refreshAttempts |
Lista de intentos de actualización. |
|
startTime |
string |
Fecha y hora de inicio de la actualización |
status |
Estado general de la operación del conjunto de datos |
|
type |
Tipo de procesamiento que se va a realizar |
DatasetRefreshDetailCommitMode
Determina si los objetos se confirmarán en lotes o solo cuando se completen.
Nombre | Tipo | Description |
---|---|---|
PartialBatch |
string |
Confirmación de la operación de actualización en lotes |
Transactional |
string |
Confirmar toda la operación de actualización como una transacción |
DatasetRefreshDetailExtendedStatus
Estado detallado de la operación del conjunto de datos
Nombre | Tipo | Description |
---|---|---|
Cancelled |
string |
El cliente canceló la operación de actualización. |
Completed |
string |
La operación de actualización se completó correctamente. |
Disabled |
string |
La operación de actualización está deshabilitada por una actualización selectiva. |
Failed |
string |
La operación de actualización no se realiza correctamente |
InProgress |
string |
La operación de actualización está en curso |
NotStarted |
string |
La operación de actualización no se inicia |
TimedOut |
string |
Se agota el tiempo de espera de la operación de actualización. |
Unknown |
string |
El estado de finalización es desconocido |
DatasetRefreshDetailStatus
Estado general de la operación del conjunto de datos
Nombre | Tipo | Description |
---|---|---|
Completed |
string |
La operación de actualización se completó correctamente. |
Disabled |
string |
La operación de actualización está deshabilitada por una actualización selectiva. |
Failed |
string |
La operación de actualización no se realiza correctamente |
Unknown |
string |
El estado de finalización es desconocido o una actualización está en curso. |
DatasetRefreshDetailType
Tipo de procesamiento que se va a realizar
Nombre | Tipo | Description |
---|---|---|
Automatic |
string |
Si el objeto se debe actualizar, actualice el objeto y todos sus elementos dependientes. Se aplica si la partición se encuentra en un estado que no sea Ready. |
Calculate |
string |
Actualice este objeto y todos sus elementos dependientes, pero solo si es necesario. Este valor no fuerza la actualización, excepto las fórmulas volátiles. |
ClearValues |
string |
Borrar valores de este objeto y todos sus dependientes |
DataOnly |
string |
Actualizar los datos de este objeto y borrar todos los dependientes |
Defragment |
string |
Desfragmente los datos de la tabla especificada. Ya que los datos se agregan a una tabla o se quitan de ella, los diccionarios de cada columna pueden contaminarse con valores que ya no existen en los valores de columna reales. La opción de desfragmentar limpiará los valores de los diccionarios que ya no se usan. |
Full |
string |
Para todas las particiones en la partición, tabla o base de datos especificada, actualice los datos y actualice todos los elementos dependientes. Para una partición de cálculo, actualice la partición y todos sus elementos dependientes. |
DatasetRefreshObjects
Destino de actualización del conjunto de datos de Power BI
Nombre | Tipo | Description |
---|---|---|
partition |
string |
Partición para actualizar |
table |
string |
Tabla que se va a actualizar |
EngineMessage
Mensaje de error o advertencia del motor para una actualización mejorada
Nombre | Tipo | Description |
---|---|---|
code |
string |
El código de error en formato hexadecimal |
message |
string |
Texto del mensaje de error o advertencia |
type |
El tipo de error |
RefreshAttempt
Power BI realiza automáticamente varios intentos de actualizar un conjunto de datos si experimenta un error de actualización. Este objeto contiene información sobre cada intento de actualización.
Nombre | Tipo | Description |
---|---|---|
attemptId |
integer |
Índice del intento de actualización. |
endTime |
string |
Fecha y hora de finalización del intento de actualización. El valor es void si el intento de actualización está en curso. |
serviceExceptionJson |
string |
Código de error de error en formato JSON. Void si no hay ningún error. |
startTime |
string |
Fecha y hora de inicio del intento de actualización. |
type |
Tipo de intento de actualización. |
RefreshAttemptType
Tipo de intento de actualización.
Nombre | Tipo | Description |
---|---|---|
Data |
string |
El intento de actualización de cargar datos en el conjunto de datos. |
Query |
string |
El intento de actualizar las cachés de consultas prémium y los iconos del panel.u |
RefreshEngineErrorType
El tipo de error
Nombre | Tipo | Description |
---|---|---|
Error |
string |
Mensaje de error |
Warning |
string |
Mensaje de advertencia |