Datasets - Refresh Dataset
Memicu refresh untuk himpunan data yang ditentukan dari Ruang kerja saya. Refresh yang disempurnakan dipicu hanya jika payload permintaan selain notifyOption
diatur.
Cakupan yang Diperlukan
Dataset.ReadWrite.All
Batasan
- Untuk Kapasitas bersama, maksimum delapan permintaan per hari, termasuk refresh yang dijalankan dengan menggunakan refresh terjadwal, dapat dimulai.
- Untuk Kapasitas bersama, hanya
notifyOption
dapat ditentukan dalam isi permintaan. - Penyegaran yang disempurnakan tidak didukung untuk kapasitas bersama.
- Untuk refresh yang ditingkatkan,
notifyOption
tidak diperlukan dan harus dikecualikan dari isi permintaan. Namun, satu atau beberapa parameter selainnotifyOption
diperlukan. - Untuk kapasitas Premium, permintaan maksimum per hari hanya dibatasi oleh sumber daya yang tersedia dalam kapasitas. Jika sumber daya yang tersedia kelebihan beban, refresh dibatasi hingga beban berkurang. Refresh akan gagal jika pembatasan melebihi 1 jam.
POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
dataset
|
path | True |
string |
ID himpunan data |
Isi Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
notifyOption | True |
Opsi pemberitahuan email. Parameter ini tidak berlaku untuk refresh yang ditingkatkan atau operasi API dengan perwakilan layanan. |
|
applyRefreshPolicy |
boolean |
Tentukan apakah kebijakan diterapkan atau tidak |
|
commitMode |
Menentukan apakah objek akan diterapkan dalam batch atau hanya ketika selesai |
||
effectiveDate |
string |
Jika kebijakan refresh bertahap diterapkan, parameter |
|
maxParallelism |
integer |
Jumlah maksimum utas untuk menjalankan perintah pemrosesan paralel |
|
objects |
Array objek yang akan diproses |
||
retryCount |
integer |
Berapa kali operasi akan mencoba kembali sebelum gagal |
|
type |
Jenis pemrosesan yang akan dilakukan |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
202 Accepted |
Diterima Headers
|
Contoh
Example of refreshing a dataset |
Example of refreshing one partition |
Example of refreshing a dataset
Sample Request
POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes
Sample Response
x-ms-request-id: 03f22bb5-2e98-4ae8-8113-329bec3987b1
Location: https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes/03f22bb5-2e98-4ae8-8113-329bec3987b1
Example of refreshing one partition
Sample Request
POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes
{
"type": "full",
"commitMode": "transactional",
"objects": [
{
"table": "Customer",
"partition": "Robert"
}
],
"applyRefreshPolicy": "false"
}
Sample Response
Definisi
Nama | Deskripsi |
---|---|
Dataset |
Menentukan apakah objek akan diterapkan dalam batch atau hanya ketika selesai |
Dataset |
Target refresh himpunan data Power BI |
Dataset |
Permintaan refresh himpunan data Power BI |
Dataset |
Jenis pemrosesan yang akan dilakukan |
Notify |
Opsi pemberitahuan email |
DatasetCommitMode
Menentukan apakah objek akan diterapkan dalam batch atau hanya ketika selesai
Nama | Jenis | Deskripsi |
---|---|---|
PartialBatch |
string |
Terapkan operasi refresh dalam batch. Saat menggunakan |
Transactional |
string |
Menerapkan seluruh operasi refresh sebagai transaksi |
DatasetRefreshObjects
Target refresh himpunan data Power BI
Nama | Jenis | Deskripsi |
---|---|---|
partition |
string |
Partisi untuk di-refresh |
table |
string |
Tabel yang akan di-refresh |
DatasetRefreshRequest
Permintaan refresh himpunan data Power BI
Nama | Jenis | Deskripsi |
---|---|---|
applyRefreshPolicy |
boolean |
Tentukan apakah kebijakan diterapkan atau tidak |
commitMode |
Menentukan apakah objek akan diterapkan dalam batch atau hanya ketika selesai |
|
effectiveDate |
string |
Jika kebijakan refresh bertahap diterapkan, parameter |
maxParallelism |
integer |
Jumlah maksimum utas untuk menjalankan perintah pemrosesan paralel |
notifyOption |
Opsi pemberitahuan email. Parameter ini tidak berlaku untuk refresh yang ditingkatkan atau operasi API dengan perwakilan layanan. |
|
objects |
Array objek yang akan diproses |
|
retryCount |
integer |
Berapa kali operasi akan mencoba kembali sebelum gagal |
type |
Jenis pemrosesan yang akan dilakukan |
DatasetRefreshType
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 |
Refresh 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 defragmentasi 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. |
NotifyOption
Opsi pemberitahuan email
Nama | Jenis | Deskripsi |
---|---|---|
MailOnCompletion |
string |
Pemberitahuan email yang menunjukkan keberhasilan atau kegagalan akan dikirim saat penyelesaian refresh |
MailOnFailure |
string |
Pemberitahuan email akan dikirim saat kegagalan refresh |
NoNotification |
string |
Tidak ada pemberitahuan yang akan dikirim |