Datasets - Refresh Dataset
Memicu refresh untuk himpunan data yang ditentukan dari Ruang kerja saya. Refresh ditingkatkan dipicu hanya jika payload permintaan selain notifyOption
diatur.
Cakupan yang Diperlukan
Himpunan Data.ReadWrite.All
Keterbatasan
- Untuk Kapasitas bersama, maksimum delapan permintaan per hari, termasuk refresh yang dijalankan dengan menggunakan refresh terjadwal, dapat dimulai.
- Untuk Kapasitas bersama, hanya
notifyOption
yang dapat ditentukan dalam isi permintaan. - Refresh 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. Kesalahan internal sementara dapat memicu coba lagi refresh, bahkan ketika parameter ini diatur ke 0. |
|
timeout |
string |
Jika |
|
type |
Jenis pemrosesan yang akan dilakukan |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
202 Accepted |
Diterima Header
|
Contoh
Example of refreshing a dataset |
Example of refreshing one partition |
Example of refreshing a dataset
Permintaan sampel
POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes
Respon sampel
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
Permintaan sampel
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",
"timeout": "05:00:00"
}
Respon sampel
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
Nilai | Deskripsi |
---|---|
PartialBatch |
Terapkan operasi refresh dalam batch. Saat menggunakan mode |
Transactional |
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. Kesalahan internal sementara dapat memicu coba lagi refresh, bahkan ketika parameter ini diatur ke 0. |
timeout |
string |
Jika |
type |
Jenis pemrosesan yang akan dilakukan |
DatasetRefreshType
Jenis pemrosesan yang akan dilakukan
Nilai | Deskripsi |
---|---|
Automatic |
Jika objek perlu disegarkan dan dihitung ulang, refresh dan hitung ulang objek dan semua dependennya. Berlaku jika partisi dalam keadaan selain Siap. |
Calculate |
Hitung ulang objek ini dan semua dependennya, tetapi hanya jika diperlukan. Nilai ini tidak memaksa perhitungan ulang, kecuali untuk rumus volatil. |
ClearValues |
Hapus nilai dalam objek ini dan semua dependennya |
DataOnly |
Refresh data dalam objek ini dan hapus semua dependen |
Defragment |
Defragmentasi data dalam tabel yang ditentukan. Saat data ditambahkan ke atau dihapus dari tabel, kamus setiap kolom dapat tercemari dengan nilai yang tidak ada lagi dalam nilai kolom aktual. Opsi defragment akan membersihkan nilai dalam kamus yang tidak lagi digunakan. |
Full |
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
Nilai | Deskripsi |
---|---|
MailOnCompletion |
Pemberitahuan email yang menunjukkan keberhasilan atau kegagalan akan dikirim pada penyelesaian refresh |
MailOnFailure |
Pemberitahuan email akan dikirim saat kegagalan refresh |
NoNotification |
Tidak ada pemberitahuan yang akan dikirim |