Datasets - Get Refresh Execution Details

Service:

Power BI REST APIs

API Version:

v1.0

Mengembalikan detail eksekusi operasi refresh yang disempurnakan untuk himpunan data yang ditentukan dari Ruang kerja saya.

Cakupan yang Diperlukan

Dataset.ReadWrite.All atau Dataset.Read.All

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
datasetId	path	True	string uuid	ID himpunan data
refreshId	path	True	string uuid	The refresh ID

Respons

Nama	Jenis	Deskripsi
200 OK	DatasetRefreshDetail	OK (respons ini dikembalikan ketika operasi refresh telah selesai atau gagal)
202 Accepted	DatasetRefreshDetail	Diterima (respons ini dikembalikan ketika operasi refresh masih berlangsung)

Contoh

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
}

Definisi

Nama	Deskripsi
DatasetRefreshDetail	Entri detail refresh Power BI
DatasetRefreshDetailCommitMode	Menentukan apakah objek akan diterapkan dalam batch atau hanya ketika selesai
DatasetRefreshDetailExtendedStatus	Status terperinci operasi himpunan data
DatasetRefreshDetailStatus	Status umum operasi himpunan data
DatasetRefreshDetailType	Jenis pemrosesan yang akan dilakukan
DatasetRefreshObjects	Target refresh himpunan data Power BI
EngineMessage	Kesalahan atau pesan peringatan dari mesin untuk refresh yang disempurnakan
RefreshAttempt	Power BI secara otomatis melakukan beberapa upaya untuk merefresh himpunan data jika mengalami kegagalan refresh. Obyek ini memuat informasi tentang setiap upaya penyegaran.
RefreshAttemptType	Jenis upaya refresh.
RefreshEngineErrorType	Jenis kesalahan

DatasetRefreshDetail

Entri detail refresh Power BI

Nama	Jenis	Deskripsi
commitMode	DatasetRefreshDetailCommitMode	Menentukan apakah objek akan diterapkan dalam batch atau hanya ketika selesai
currentRefreshType	DatasetRefreshDetailType	Jenis pemrosesan untuk perulangan saat ini. Ini berguna ketika commitMode diatur ke PartialBatch
endTime	string	Tanggal akhir dan waktu refresh (mungkin kosong jika refresh sedang berlangsung)
extendedStatus	DatasetRefreshDetailExtendedStatus	Status terperinci operasi himpunan data
messages	EngineMessage[]	Array kesalahan mesin atau pesan peringatan untuk permintaan refresh
numberOfAttempts	integer	Jumlah upaya untuk permintaan refresh
objects	DatasetRefreshObjects[]	Array objek yang disertakan dalam permintaan refresh
refreshAttempts	RefreshAttempt[]	Daftar upaya refresh.
startTime	string	Tanggal dan waktu mulai refresh
status	DatasetRefreshDetailStatus	Status umum operasi himpunan data
type	DatasetRefreshDetailType	Jenis pemrosesan yang akan dilakukan

DatasetRefreshDetailCommitMode

Menentukan apakah objek akan diterapkan dalam batch atau hanya ketika selesai

Nama	Jenis	Deskripsi
PartialBatch	string	Menerapkan operasi refresh dalam batch
Transactional	string	Menerapkan seluruh operasi refresh sebagai transaksi

DatasetRefreshDetailExtendedStatus

Status terperinci operasi himpunan data

Nama	Jenis	Deskripsi
Cancelled	string	Operasi refresh telah dibatalkan oleh pelanggan
Completed	string	Operasi refresh berhasil diselesaikan
Disabled	string	Operasi refresh dinonaktifkan oleh refresh selektif
Failed	string	Operasi refresh tidak berhasil
InProgress	string	Operasi refresh sedang berlangsung
NotStarted	string	Operasi refresh tidak dimulai
TimedOut	string	Waktu operasi refresh habis
Unknown	string	Status penyelesaian tidak diketahui

DatasetRefreshDetailStatus

Status umum operasi himpunan data

Nama	Jenis	Deskripsi
Completed	string	Operasi refresh berhasil diselesaikan
Disabled	string	Operasi refresh dinonaktifkan oleh refresh selektif
Failed	string	Operasi refresh tidak berhasil
Unknown	string	Status penyelesaian tidak diketahui atau refresh sedang berlangsung

DatasetRefreshDetailType

Jenis pemrosesan yang akan dilakukan

Nama	Jenis	Deskripsi
Automatic	string	Jika objek perlu disegarkan dan dihitung ulang, refresh dan hitung ulang objek dan semua dependennya. Berlaku jika partisi dalam keadaan selain Siap.
Calculate	string	Hitung ulang objek ini dan semua dependennya, tetapi hanya jika diperlukan. Nilai ini tidak memaksa perhitungan ulang, kecuali untuk rumus volatil.
ClearValues	string	Hapus nilai dalam objek ini dan semua dependennya
DataOnly	string	Segarkan data dalam objek ini dan hapus semua dependen
Defragment	string	Defragmentasi data dalam tabel yang ditentukan. Saat data ditambahkan ke atau dihapus dari tabel, kamus setiap kolom bisa tercemari dengan nilai yang tidak lagi ada dalam nilai kolom aktual. Opsi defragment akan membersihkan nilai dalam kamus yang tidak lagi digunakan.
Full	string	Untuk semua partisi dalam partisi, tabel, atau database yang ditentukan, refresh data dan hitung ulang semua dependen. Untuk partisi perhitungan, hitung ulang partisi dan semua dependennya.

DatasetRefreshObjects

Target refresh himpunan data Power BI

Nama	Jenis	Deskripsi
partition	string	Partisi untuk di-refresh
table	string	Tabel untuk di-refresh

EngineMessage

Kesalahan atau pesan peringatan dari mesin untuk refresh yang disempurnakan

Nama	Jenis	Deskripsi
code	string	Kode kesalahan dalam format hex
message	string	Teks kesalahan atau pesan peringatan
type	RefreshEngineErrorType	Jenis kesalahan

RefreshAttempt

Power BI secara otomatis melakukan beberapa upaya untuk merefresh himpunan data jika mengalami kegagalan refresh. Obyek ini memuat informasi tentang setiap upaya penyegaran.

Nama	Jenis	Deskripsi
attemptId	integer	Indeks upaya refresh.
endTime	string	Tanggal akhir dan waktu upaya refresh. Nilai batal jika upaya refresh sedang berlangsung.
serviceExceptionJson	string	Kode kesalahan kegagalan dalam format JSON. Batalkan jika tidak ada kesalahan.
startTime	string	Tanggal dan waktu mulai upaya refresh.
type	RefreshAttemptType	Jenis upaya refresh.

RefreshAttemptType

Jenis upaya refresh.

Nama	Jenis	Deskripsi
Data	string	Refresh mencoba memuat data ke dalam himpunan data.
Query	string	Upaya untuk menyegarkan cache kueri premium dan petak dasbor.u

RefreshEngineErrorType

Jenis kesalahan

Nama	Jenis	Deskripsi
Error	string	Pesan kesalahan
Warning	string	Pesan peringatan