Datasets - Get Refresh Execution Details

Referência

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Retorna detalhes de execução de uma operação de atualização aprimorada para o conjunto de dados especificado de Meu workspace.

Escopo necessário

Dataset.ReadWrite.All ou Dataset.Read.All

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
datasetId	path	True	string uuid	A ID do conjunto de dados
refreshId	path	True	string uuid	A ID de atualização

Respostas

Nome	Tipo	Description
200 OK	DatasetRefreshDetail	OK (essa resposta é retornada quando a operação de atualização é concluída ou falha)
202 Accepted	DatasetRefreshDetail	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

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 202

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

Definições

Nome	Description
DatasetRefreshDetail	Uma entrada de detalhes de atualização do Power BI
DatasetRefreshDetailCommitMode	Determina se os objetos serão confirmados em lotes ou somente quando concluídos
DatasetRefreshDetailExtendedStatus	Operação de conjunto de dados detalhada status
DatasetRefreshDetailStatus	Status geral da operação do conjunto de dados
DatasetRefreshDetailType	O tipo de processamento a ser executado
DatasetRefreshObjects	Destino de atualização do conjunto de dados do Power BI
EngineMessage	A mensagem de erro ou aviso do mecanismo para atualização aprimorada
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.
RefreshAttemptType	O tipo de tentativa de atualização.
RefreshEngineErrorType	O tipo do erro

DatasetRefreshDetail

Object

Uma entrada de detalhes de atualização do Power BI

Nome	Tipo	Description
commitMode	DatasetRefreshDetailCommitMode	Determina se os objetos serão confirmados em lotes ou somente quando concluídos
currentRefreshType	DatasetRefreshDetailType	O tipo de processamento para a iteração atual. Isso é útil quando é definido como `commitModePartialBatch`
endTime	string	A data e a hora de término da atualização (pode estar vazia se uma atualização estiver em andamento)
extendedStatus	DatasetRefreshDetailExtendedStatus	Operação de conjunto de dados detalhada status
messages	EngineMessage[]	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	DatasetRefreshObjects[]	Uma matriz de objetos incluídos na solicitação de atualização
refreshAttempts	RefreshAttempt[]	A lista de tentativas de atualização.
startTime	string	A data e a hora de início da atualização
status	DatasetRefreshDetailStatus	Status geral da operação do conjunto de dados
type	DatasetRefreshDetailType	O tipo de processamento a ser executado

DatasetRefreshDetailCommitMode

Enumeration

Determina se os objetos serão confirmados em lotes ou somente quando concluídos

Valor	Description
PartialBatch	Confirmar a operação de atualização em lotes
Transactional	Confirmar toda a operação de atualização como uma transação

DatasetRefreshDetailExtendedStatus

Enumeration

Operação de conjunto de dados detalhada status

Valor	Description
Cancelled	A operação de atualização foi cancelada pelo cliente
Completed	A operação de atualização foi concluída com êxito
Disabled	A operação de atualização é desabilitada por uma atualização seletiva
Failed	A operação de atualização não foi bem-sucedida
InProgress	A operação de atualização está em andamento
NotStarted	A operação de atualização não foi iniciada
TimedOut	A operação de atualização atingiu o tempo limite
Unknown	O estado de conclusão é desconhecido

DatasetRefreshDetailStatus

Enumeration

Status geral da operação do conjunto de dados

Valor	Description
Completed	A operação de atualização foi concluída com êxito
Disabled	A operação de atualização é desabilitada por uma atualização seletiva
Failed	A operação de atualização não foi bem-sucedida
Unknown	O estado de conclusão é desconhecido ou uma atualização está em andamento

DatasetRefreshDetailType

Enumeration

O tipo de processamento a ser executado

Valor	Description
Automatic	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	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	Limpar valores neste objeto e todos os seus dependentes
DataOnly	Atualizar dados neste objeto e limpar todos os dependentes
Defragment	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	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

Object

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

Object

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	RefreshEngineErrorType	O tipo do erro

RefreshAttempt

Object

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	RefreshAttemptType	O tipo de tentativa de atualização.

RefreshAttemptType

Enumeration

O tipo de tentativa de atualização.

Valor	Description
Data	A tentativa de atualização de carregar dados no conjunto de dados.
Query	A tentativa de atualizar caches de consulta premium e dashboard blocos.u

RefreshEngineErrorType

Enumeration

O tipo do erro

Valor	Description
Error	Mensagem de erro
Warning	Mensagem de aviso

Compartilhar via

Datasets - Get Refresh Execution Details

Escopo necessário

Parâmetros de URI

Respostas

Exemplos

Completed refresh example

Solicitação de exemplo

Resposta de exemplo

Failed refresh example

Solicitação de exemplo

Resposta de exemplo

In progress refresh example

Solicitação de exemplo

Resposta de exemplo

Definições

DatasetRefreshDetail

DatasetRefreshDetailCommitMode

DatasetRefreshDetailExtendedStatus

DatasetRefreshDetailStatus

DatasetRefreshDetailType

DatasetRefreshObjects

EngineMessage

RefreshAttempt

RefreshAttemptType

RefreshEngineErrorType

Recursos adicionais