Datasets - Get Refresh Execution Details In Group

Referencia

Service:: Power BI REST APIs

API Version:: v1.0

Devuelve los detalles de ejecución de una operación de actualización mejorada para el conjunto de datos especificado del área de trabajo especificada.

Permisos

Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: Perfiles de entidad de servicio en Power BI Embedded.

Ámbito requerido

Dataset.ReadWrite.All o Dataset.Read.All

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
datasetId	path	True	string uuid	El identificador del conjunto de datos
groupId	path	True	string uuid	Identificador del área de trabajo
refreshId	path	True	string uuid	El identificador de actualización

Respuestas

Nombre	Tipo	Description
200 OK	DatasetRefreshDetail	Correcto (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 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/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
}

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	El tipo de error

DatasetRefreshDetail

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	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 error o advertencia del motor para la solicitud de actualización
numberOfAttempts	integer	Número de intentos de 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	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

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	RefreshEngineErrorType	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	RefreshAttemptType	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

Compartir a través de

Datasets - Get Refresh Execution Details In Group

Permisos

Ámbito requerido

Parámetros de identificador URI

Respuestas

Ejemplos

Completed refresh example

Sample Request

Sample Response

Failed refresh example

Sample Request

Sample Response

In progress refresh example

Sample Request

Sample Response

Definiciones

DatasetRefreshDetail

DatasetRefreshDetailCommitMode

DatasetRefreshDetailExtendedStatus

DatasetRefreshDetailStatus

DatasetRefreshDetailType

DatasetRefreshObjects

EngineMessage

RefreshAttempt

RefreshAttemptType

RefreshEngineErrorType

Recursos adicionales