Datasets - Get Refresh Execution Details

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

Restituisce i dettagli di esecuzione di un'operazione di aggiornamento avanzata per il set di dati specificato dall'area di lavoro personale.

Ambito obbligatorio

Dataset.ReadWrite.All o Dataset.Read.All

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
datasetId	path	True	string uuid	ID del set di dati
refreshId	path	True	string uuid	ID di aggiornamento

Risposte

Nome	Tipo	Descrizione
200 OK	DatasetRefreshDetail	OK (questa risposta viene restituita quando l'operazione di aggiornamento è stata completata o non è riuscita)
202 Accepted	DatasetRefreshDetail	Accettato (questa risposta viene restituita quando l'operazione di aggiornamento è ancora in corso)

Esempio

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

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/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/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
}

Definizioni

Nome	Descrizione
DatasetRefreshDetail	Voce dettagli aggiornamento di Power BI
DatasetRefreshDetailCommitMode	Determina se gli oggetti verranno sottoposti a commit in batch o solo al termine
DatasetRefreshDetailExtendedStatus	Stato dettagliato dell'operazione del set di dati
DatasetRefreshDetailStatus	Stato generale dell'operazione del set di dati
DatasetRefreshDetailType	Tipo di elaborazione da eseguire
DatasetRefreshObjects	Destinazione di aggiornamento del set di dati di Power BI
EngineMessage	Messaggio di errore o avviso del motore per l'aggiornamento avanzato
RefreshAttempt	Power BI esegue automaticamente più tentativi di aggiornamento di un set di dati se si verifica un errore di aggiornamento. Questo oggetto contiene informazioni su ogni tentativo di aggiornamento.
RefreshAttemptType	Tipo di tentativo di aggiornamento.
RefreshEngineErrorType	Tipo dell'errore

DatasetRefreshDetail

Voce dettagli aggiornamento di Power BI

Nome	Tipo	Descrizione
commitMode	DatasetRefreshDetailCommitMode	Determina se gli oggetti verranno sottoposti a commit in batch o solo al termine
currentRefreshType	DatasetRefreshDetailType	Tipo di elaborazione per l'iterazione corrente. Ciò è utile quando `commitMode` è impostato su `PartialBatch`
endTime	string	Data e ora di fine dell'aggiornamento (può essere vuota se è in corso un aggiornamento)
extendedStatus	DatasetRefreshDetailExtendedStatus	Stato dettagliato dell'operazione del set di dati
messages	EngineMessage[]	Matrice di messaggi di errore o di avviso del motore per la richiesta di aggiornamento
numberOfAttempts	integer	Numero di tentativi per la richiesta di aggiornamento
objects	DatasetRefreshObjects[]	Matrice di oggetti inclusi nella richiesta di aggiornamento
refreshAttempts	RefreshAttempt[]	Elenco dei tentativi di aggiornamento.
startTime	string	Data e ora di inizio dell'aggiornamento
status	DatasetRefreshDetailStatus	Stato generale dell'operazione del set di dati
type	DatasetRefreshDetailType	Tipo di elaborazione da eseguire

DatasetRefreshDetailCommitMode

Determina se gli oggetti verranno sottoposti a commit in batch o solo al termine

Nome	Tipo	Descrizione
PartialBatch	string	Eseguire il commit dell'operazione di aggiornamento in batch
Transactional	string	Eseguire il commit dell'intera operazione di aggiornamento come transazione

DatasetRefreshDetailExtendedStatus

Stato dettagliato dell'operazione del set di dati

Nome	Tipo	Descrizione
Cancelled	string	L'operazione di aggiornamento è stata annullata dal cliente
Completed	string	L'operazione di aggiornamento è stata completata correttamente
Disabled	string	L'operazione di aggiornamento è disabilitata da un aggiornamento selettivo
Failed	string	L'operazione di aggiornamento non riesce
InProgress	string	L'operazione di aggiornamento è in corso
NotStarted	string	L'operazione di aggiornamento non viene avviata
TimedOut	string	Timeout dell'operazione di aggiornamento
Unknown	string	Lo stato di completamento è sconosciuto

DatasetRefreshDetailStatus

Stato generale dell'operazione del set di dati

Nome	Tipo	Descrizione
Completed	string	L'operazione di aggiornamento è stata completata correttamente
Disabled	string	L'operazione di aggiornamento è disabilitata da un aggiornamento selettivo
Failed	string	L'operazione di aggiornamento non riesce
Unknown	string	Lo stato di completamento è sconosciuto o è in corso un aggiornamento

DatasetRefreshDetailType

Tipo di elaborazione da eseguire

Nome	Tipo	Descrizione
Automatic	string	Se l'oggetto deve essere aggiornato e ricalcolato, eseguire l'operazione richiesta sia per l'oggetto che per tutti i dipendenti. Si applica se la partizione è in uno stato diverso da pronta.
Calculate	string	Ricalcolare questo oggetto e tutti i relativi dipendenti, ma solo se necessario. Questo valore non forza il ricalcolo, ad eccezione delle formule volatili.
ClearValues	string	Cancellare i valori in questo oggetto e tutti i relativi dipendenti
DataOnly	string	Aggiornare i dati in questo oggetto e cancellare tutti i dipendenti
Defragment	string	Deframmentare i dati nella tabella specificata. Man mano che vengono aggiunti o rimossi dati in una tabella, i dizionari di ogni colonna possono risultare contaminati da valori che non esistono più tra i valori di colonna effettivi. L'opzione defragment consentirà di pulire i valori non più usati nei dizionari.
Full	string	Per tutte le partizioni della partizione, della tabella o del database specificati, aggiornare i dati e ricalcolare tutti i dipendenti. Per una partizione di calcolo, ricalcolare la partizione e tutti i relativi dipendenti.

DatasetRefreshObjects

Destinazione di aggiornamento del set di dati di Power BI

Nome	Tipo	Descrizione
partition	string	Partizione da aggiornare
table	string	Tabella da aggiornare

EngineMessage

Messaggio di errore o avviso del motore per l'aggiornamento avanzato

Nome	Tipo	Descrizione
code	string	Codice di errore in formato esadecimale
message	string	Testo del messaggio di errore o di avviso
type	RefreshEngineErrorType	Tipo dell'errore

RefreshAttempt

Power BI esegue automaticamente più tentativi di aggiornamento di un set di dati se si verifica un errore di aggiornamento. Questo oggetto contiene informazioni su ogni tentativo di aggiornamento.

Nome	Tipo	Descrizione
attemptId	integer	Indice del tentativo di aggiornamento.
endTime	string	Data e ora di fine del tentativo di aggiornamento. Il valore è void se il tentativo di aggiornamento è in corso.
serviceExceptionJson	string	Codice di errore non riuscito in formato JSON. Void se non è presente alcun errore.
startTime	string	Data e ora di inizio del tentativo di aggiornamento.
type	RefreshAttemptType	Tipo di tentativo di aggiornamento.

RefreshAttemptType

Tipo di tentativo di aggiornamento.

Nome	Tipo	Descrizione
Data	string	Tentativo di aggiornamento di caricare i dati nel set di dati.
Query	string	Tentativo di aggiornare le cache delle query Premium e i riquadri del dashboard.u

RefreshEngineErrorType

Tipo dell'errore

Nome	Tipo	Descrizione
Error	string	Messaggio di errore
Warning	string	Messaggio di avviso

Datasets - Get Refresh Execution Details

Ambito obbligatorio

Parametri dell'URI

Risposte

Esempio

Completed refresh example

Sample Request

Sample Response

Failed refresh example

Sample Request

Sample Response

In progress refresh example

Sample Request

Sample Response

Definizioni

DatasetRefreshDetail

DatasetRefreshDetailCommitMode

DatasetRefreshDetailExtendedStatus

DatasetRefreshDetailStatus

DatasetRefreshDetailType

DatasetRefreshObjects

EngineMessage

RefreshAttempt

RefreshAttemptType

RefreshEngineErrorType

Risorse aggiuntive