Datasets - Get Refresh Execution Details

Servicio:: Power BI REST APIs

Versión de la API:: v1.0

Devuelve los detalles de ejecución de una operación de actualización mejorada para el conjunto de datos especificado desde 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
datasetId	path	True	string (uuid)	Identificador del conjunto de datos
refreshId	path	True	string (uuid)	El identificador de actualización

Respuestas

Nombre	Tipo	Description
200 OK	DatasetRefreshDetail	Aceptar (esta respuesta se devuelve cuando la operación de actualización se ha completado o ha producido un error)
202 Accepted	DatasetRefreshDetail	Aceptado (esta respuesta se devuelve cuando la operación de actualización todavía está en curso)

Ejemplos

Completed refresh example

Failed refresh example

In progress refresh example

Completed refresh example

Solicitud de ejemplo

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

Respuesta de muestra

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

Solicitud de ejemplo

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

Respuesta de muestra

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

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 202

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

Definiciones

Nombre	Description
DatasetRefreshDetail	Una entrada de detalles de actualización de Power BI
DatasetRefreshDetailCommitMode	Determina si los objetos se confirmarán en lotes o solo cuando se completen.
DatasetRefreshDetailExtendedStatus	Estado detallado de la operación del conjunto de datos
DatasetRefreshDetailStatus	Estado general de la operación del conjunto de datos
DatasetRefreshDetailType	Tipo de procesamiento que se va a realizar
DatasetRefreshObjects	Destino de actualización del conjunto de datos de Power BI
EngineMessage	Mensaje de error o advertencia del motor para una actualización mejorada
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.
RefreshAttemptType	Tipo de intento de actualización.
RefreshEngineErrorType	Tipo del error

DatasetRefreshDetail

Object

Una entrada de detalles de actualización de Power BI

Nombre	Tipo	Description
commitMode	DatasetRefreshDetailCommitMode	Determina si los objetos se confirmarán en lotes o solo cuando se completen.
currentRefreshType	DatasetRefreshDetailType	Tipo de procesamiento para la iteración actual. Esto resulta útil cuando `commitMode` se establece en `PartialBatch`
endTime	string (date-time)	La fecha y hora de finalización de la actualización (puede estar vacía si hay una actualización en curso)
extendedStatus	DatasetRefreshDetailExtendedStatus	Estado detallado de la operación del conjunto de datos
messages	EngineMessage[]	Matriz de mensajes de advertencia o error del motor para la solicitud de actualización
numberOfAttempts	integer	Número de intentos para la solicitud de actualización
objects	DatasetRefreshObjects[]	Matriz de objetos incluidos en la solicitud de actualización
refreshAttempts	RefreshAttempt[]	Lista de intentos de actualización.
startTime	string (date-time)	La fecha y hora de inicio de la actualización
status	DatasetRefreshDetailStatus	Estado general de la operación del conjunto de datos
type	DatasetRefreshDetailType	Tipo de procesamiento que se va a realizar

DatasetRefreshDetailCommitMode

Enumeración

Determina si los objetos se confirmarán en lotes o solo cuando se completen.

Valor	Description
Transactional	Confirmar toda la operación de actualización como una transacción
PartialBatch	Confirmación de la operación de actualización en lotes

DatasetRefreshDetailExtendedStatus

Enumeración

Estado detallado de la operación del conjunto de datos

Valor	Description
Unknown	El estado de finalización es desconocido
NotStarted	La operación de actualización no se inicia
InProgress	La operación de actualización está en curso
Completed	La operación de actualización se ha completado correctamente.
TimedOut	Se agota el tiempo de espera de la operación de actualización.
Failed	La operación de actualización no se realiza correctamente
Disabled	La operación de actualización está deshabilitada por una actualización selectiva.
Cancelled	El cliente canceló la operación de actualización.

DatasetRefreshDetailStatus

Enumeración

Estado general de la operación del conjunto de datos

Valor	Description
Unknown	El estado de finalización es desconocido o una actualización está en curso.
Completed	La operación de actualización se ha completado correctamente.
Failed	La operación de actualización no se realiza correctamente
Disabled	La operación de actualización está deshabilitada por una actualización selectiva.

DatasetRefreshDetailType

Enumeración

Tipo de procesamiento que se va a realizar

Valor	Description
Full	Para todas las particiones de la partición, tabla o base de datos especificadas, actualice los datos y vuelva a calcular todos los dependientes. Para una partición de cálculo, recalcule la partición y todos sus dependientes.
ClearValues	Borrar valores de este objeto y todos sus dependientes
Calculate	Vuelva a calcular este objeto y todos sus dependientes, pero solo si es necesario. Este valor no fuerza la actualización, excepto las fórmulas volátiles.
DataOnly	Actualizar datos en este objeto y borrar todos los dependientes
Automatic	Si el objeto debe actualizarse y recalcularse, actualice y recalcule el objeto y todos sus dependientes. Se aplica si la partición está en un estado distinto de Listo.
Defragment	Desfragmente los datos de la tabla especificada. A medida que se agregan o quitan datos de una tabla, los diccionarios de cada columna se pueden contaminar con valores que ya no existen en los valores de columna reales. La opción de desfragmentación limpiará los valores de los diccionarios que ya no se usan.

DatasetRefreshObjects

Object

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

Object

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	RefreshEngineErrorType	Tipo del error

RefreshAttempt

Object

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 (date-time)	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 (date-time)	Fecha y hora de inicio del intento de actualización.
type	RefreshAttemptType	Tipo de intento de actualización.

RefreshAttemptType

Enumeración

Tipo de intento de actualización.

Valor	Description
Data	La actualización intenta cargar datos en el conjunto de datos.
Query	El intento de actualizar las cachés de consultas premium y los iconos del panel.u

RefreshEngineErrorType

Enumeración

Tipo del error

Valor	Description
Error	Mensaje de error
Warning	Mensaje de advertencia

Compartir a través de

Datasets - Get Refresh Execution Details

Ámbito requerido

Parámetros de identificador URI

Respuestas

Ejemplos

Completed refresh example

Solicitud de ejemplo

Respuesta de muestra

Failed refresh example

Solicitud de ejemplo

Respuesta de muestra

In progress refresh example

Solicitud de ejemplo

Respuesta de muestra

Definiciones

DatasetRefreshDetail

DatasetRefreshDetailCommitMode

DatasetRefreshDetailExtendedStatus

DatasetRefreshDetailStatus

DatasetRefreshDetailType

DatasetRefreshObjects

EngineMessage

RefreshAttempt

RefreshAttemptType

RefreshEngineErrorType