Datasets - Get Refresh Execution Details In Group
Retorna detalhes de execução de uma operação de atualização aprimorada para o conjunto de dados especificado do workspace especificado.
Permissões
Essa chamada à API pode ser chamada por um perfil de entidade de serviço. Para obter mais informações, consulte: Perfis de entidade de serviço no Power BI Embedded.
Escopo necessário
Dataset.ReadWrite.All ou Dataset.Read.All
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshes/{refreshId}Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
dataset
|
path | True |
string uuid |
A ID do conjunto de dados |
|
group
|
path | True |
string uuid |
A ID do workspace |
|
refresh
|
path | True |
string uuid |
A ID de atualização |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
OK (essa resposta é retornada quando a operação de atualização é concluída ou falha) |
|
| 202 Accepted |
Aceito (essa resposta é retornada quando a operação de atualização ainda está em andamento) |
Exemplos
| 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-191693e79e9eSample 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/groups/fdb91b8f-0a9b-44c1-b6c0-0cb185c6ebfb/datasets/f7fc6510-e151-42a3-850b-d0805a391db0/refreshes/351f7113-59bb-4e5e-8c1e-e15ae7414121Sample 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/groups/fdb91b8f-0a9b-44c1-b6c0-0cb185c6ebfb/datasets/f7fc6510-e151-42a3-850b-d0805a391db0/refreshes/630110f5-8f93-49c2-afee-bfc87072460cSample Response
{
"startTime": "2021-12-14T03:46:04.833",
"type": "Full",
"commitMode": "Transactional",
"status": "Unknown",
"extendedStatus": "NotStarted",
"currentRefreshType": "Full",
"numberOfAttempts": 0
}Definições
| Nome | Description |
|---|---|
|
Dataset |
Uma entrada de detalhes de atualização do Power BI |
|
Dataset |
Determina se os objetos serão confirmados em lotes ou somente quando concluídos |
|
Dataset |
Operação de conjunto de dados detalhada status |
|
Dataset |
Status geral da operação do conjunto de dados |
|
Dataset |
O tipo de processamento a ser executado |
|
Dataset |
Destino de atualização do conjunto de dados do Power BI |
|
Engine |
A mensagem de erro ou aviso do mecanismo para atualização aprimorada |
|
Refresh |
O Power BI faz automaticamente várias tentativas de atualizar um conjunto de dados se ele apresentar uma falha de atualização. Esse objeto contém informações sobre cada tentativa de atualização. |
|
Refresh |
O tipo de tentativa de atualização. |
|
Refresh |
O tipo do erro |
DatasetRefreshDetail
Uma entrada de detalhes de atualização do Power BI
| Nome | Tipo | Description |
|---|---|---|
| commitMode |
Determina se os objetos serão confirmados em lotes ou somente quando concluídos |
|
| currentRefreshType |
O tipo de processamento para a iteração atual. Isso é útil quando é definido como |
|
| endTime |
string |
A data e a hora de término da atualização (pode estar vazia se uma atualização estiver em andamento) |
| extendedStatus |
Operação de conjunto de dados detalhada status |
|
| messages |
Uma matriz de mensagens de erro ou aviso do mecanismo para a solicitação de atualização |
|
| numberOfAttempts |
integer |
O número de tentativas para a solicitação de atualização |
| objects |
Uma matriz de objetos incluídos na solicitação de atualização |
|
| refreshAttempts |
A lista de tentativas de atualização. |
|
| startTime |
string |
A data e a hora de início da atualização |
| status |
Status geral da operação do conjunto de dados |
|
| type |
O tipo de processamento a ser executado |
DatasetRefreshDetailCommitMode
Determina se os objetos serão confirmados em lotes ou somente quando concluídos
| Nome | Tipo | Description |
|---|---|---|
| PartialBatch |
string |
Confirmar a operação de atualização em lotes |
| Transactional |
string |
Confirmar toda a operação de atualização como uma transação |
DatasetRefreshDetailExtendedStatus
Operação de conjunto de dados detalhada status
| Nome | Tipo | Description |
|---|---|---|
| Cancelled |
string |
A operação de atualização foi cancelada pelo cliente |
| Completed |
string |
A operação de atualização foi concluída com êxito |
| Disabled |
string |
A operação de atualização é desabilitada por uma atualização seletiva |
| Failed |
string |
A operação de atualização não foi bem-sucedida |
| InProgress |
string |
A operação de atualização está em andamento |
| NotStarted |
string |
A operação de atualização não foi iniciada |
| TimedOut |
string |
A operação de atualização atingiu o tempo limite |
| Unknown |
string |
O estado de conclusão é desconhecido |
DatasetRefreshDetailStatus
Status geral da operação do conjunto de dados
| Nome | Tipo | Description |
|---|---|---|
| Completed |
string |
A operação de atualização foi concluída com êxito |
| Disabled |
string |
A operação de atualização é desabilitada por uma atualização seletiva |
| Failed |
string |
A operação de atualização não foi bem-sucedida |
| Unknown |
string |
O estado de conclusão é desconhecido ou uma atualização está em andamento |
DatasetRefreshDetailType
O tipo de processamento a ser executado
| Nome | Tipo | Description |
|---|---|---|
| Automatic |
string |
Se o objeto precisar ser atualizado e recalculado, atualize e recalcule o objeto e todos os seus dependentes. Será aplicado se a partição estiver em um estado diferente de Ready. |
| Calculate |
string |
Recalcule este objeto e todos os seus dependentes, mas somente se necessário. Esse valor não força o recálculo, exceto fórmulas voláteis. |
| ClearValues |
string |
Limpar valores neste objeto e todos os seus dependentes |
| DataOnly |
string |
Atualizar dados neste objeto e limpar todos os dependentes |
| Defragment |
string |
Desfragmente os dados na tabela especificada. Como os dados são adicionados ou removidos de uma tabela, os dicionários de cada coluna podem ficar poluídos com valores que não existem mais nos valores de coluna reais. A opção de desfragmentar limpará os valores nos dicionários que não são mais usados. |
| Full |
string |
Para todas as partições na partição, tabela ou banco de dados especificado, atualize os dados e recalcule todos os dependentes. Para uma partição de cálculo, recalcule a partição e todos os seus dependentes. |
DatasetRefreshObjects
Destino de atualização do conjunto de dados do Power BI
| Nome | Tipo | Description |
|---|---|---|
| partition |
string |
Partição a ser atualizada |
| table |
string |
Tabela a ser atualizada |
EngineMessage
A mensagem de erro ou aviso do mecanismo para atualização aprimorada
| Nome | Tipo | Description |
|---|---|---|
| code |
string |
O código de erro no formato hex |
| message |
string |
O texto do erro ou da mensagem de aviso |
| type |
O tipo do erro |
RefreshAttempt
O Power BI faz automaticamente várias tentativas de atualizar um conjunto de dados se ele apresentar uma falha de atualização. Esse objeto contém informações sobre cada tentativa de atualização.
| Nome | Tipo | Description |
|---|---|---|
| attemptId |
integer |
O índice da tentativa de atualização. |
| endTime |
string |
A data e a hora de término da tentativa de atualização. O valor será nulo se a tentativa de atualização estiver em andamento. |
| serviceExceptionJson |
string |
Código de erro de falha no formato JSON. Nulo se não houver erro. |
| startTime |
string |
A data e a hora de início da tentativa de atualização. |
| type |
O tipo de tentativa de atualização. |
RefreshAttemptType
O tipo de tentativa de atualização.
| Nome | Tipo | Description |
|---|---|---|
| Data |
string |
A tentativa de atualização de carregar dados no conjunto de dados. |
| Query |
string |
A tentativa de atualizar caches de consulta premium e dashboard blocos.u |
RefreshEngineErrorType
O tipo do erro
| Nome | Tipo | Description |
|---|---|---|
| Error |
string |
Mensagem de erro |
| Warning |
string |
Mensagem de aviso |