Datasets - Get Refresh Execution Details In Group

Riferimento

Servizio:: Power BI REST APIs

Versione API:: v1.0

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

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere: Profili dell'entità servizio in Power BI Embedded.

Ambito obbligatorio

Dataset.ReadWrite.All o Dataset.Read.All

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
datasetId	path	True	string uuid	ID del set di dati
groupId	path	True	string uuid	ID area di lavoro
refreshId	path	True	string uuid	ID 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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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 dei dettagli dell'aggiornamento di Power BI
DatasetRefreshDetailCommitMode	Determina se gli oggetti verranno sottoposti a commit in batch o solo al completamento
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 dal motore per l'aggiornamento avanzato
RefreshAttempt	Power BI esegue automaticamente più tentativi di aggiornare 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

Object

Voce dei dettagli dell'aggiornamento di Power BI

Nome	Tipo	Descrizione
commitMode	DatasetRefreshDetailCommitMode	Determina se gli oggetti verranno sottoposti a commit in batch o solo al completamento
currentRefreshType	DatasetRefreshDetailType	Tipo di elaborazione per l'iterazione corrente. Questo è utile quando `commitMode` è impostato su `PartialBatch`
endTime	string	Data di fine e ora dell'aggiornamento (può essere vuoto se è in corso un aggiornamento)
extendedStatus	DatasetRefreshDetailExtendedStatus	Stato dettagliato dell'operazione del set di dati
messages	EngineMessage[]	Matrice di messaggi di errore o 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 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

Enumeration

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

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

DatasetRefreshDetailExtendedStatus

Enumeration

Stato dettagliato dell'operazione del set di dati

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

DatasetRefreshDetailStatus

Enumeration

Stato generale dell'operazione del set di dati

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

DatasetRefreshDetailType

Enumeration

Tipo di elaborazione da eseguire

Valore	Descrizione
Automatic	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	Ricalcolare questo oggetto e tutti i relativi dipendenti, ma solo se necessario. Questo valore non forza la ricalcolazione, ad eccezione delle formule volatili.
ClearValues	Cancellare i valori in questo oggetto e tutti i relativi dipendenti
DataOnly	Aggiornare i dati in questo oggetto e cancellare tutti i dipendenti
Defragment	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	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

Object

Destinazione di aggiornamento del set di dati di Power BI

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

EngineMessage

Object

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

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

RefreshAttempt

Object

Power BI esegue automaticamente più tentativi di aggiornare 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 di fine e ora del tentativo di aggiornamento. Il valore è vuoto se il tentativo di aggiornamento è in corso.
serviceExceptionJson	string	Codice errore errore 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

Enumeration

Tipo di tentativo di aggiornamento.

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

RefreshEngineErrorType

Enumeration

Tipo dell'errore

Valore	Descrizione
Error	Messaggio di errore
Warning	Messaggio di avviso

Condividi tramite

Datasets - Get Refresh Execution Details In Group

Autorizzazioni

Ambito obbligatorio

Parametri dell'URI

Risposte

Esempio

Completed refresh example

Esempio di richiesta

Risposta di esempio

Failed refresh example

Esempio di richiesta

Risposta di esempio

In progress refresh example

Esempio di richiesta

Risposta di esempio

Definizioni

DatasetRefreshDetail

DatasetRefreshDetailCommitMode

DatasetRefreshDetailExtendedStatus

DatasetRefreshDetailStatus

DatasetRefreshDetailType

DatasetRefreshObjects

EngineMessage

RefreshAttempt

RefreshAttemptType

RefreshEngineErrorType

Risorse aggiuntive