Datasets - Refresh Dataset In Group
Memicu refresh untuk himpunan data yang ditentukan dari ruang kerja yang ditentukan. Refresh yang disempurnakan dipicu hanya jika payload permintaan selain notifyOption
diatur.
Izin
Panggilan API ini dapat dipanggil oleh profil perwakilan layanan. Untuk informasi selengkapnya lihat: Profil perwakilan layanan di Power BI Embedded.
Cakupan yang Diperlukan
Dataset.ReadWrite.All
Batasan
- Untuk Kapasitas bersama, maksimal 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 disempurnakan,
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/groups/{groupId}/datasets/{datasetId}/refreshes
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
dataset
|
path | True |
string |
ID himpunan data |
group
|
path | True |
string uuid |
ID ruang kerja |
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 |
Menentukan 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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes
{
"notifyOption": "MailOnFailure",
"retryCount": 3
}
Sample Response
x-ms-request-id: 87f31ef7-1e3a-4006-9b0b-191693e79e9e
Location: https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes/87f31ef7-1e3a-4006-9b0b-191693e79e9e
Example of refreshing one partition
Sample Request
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/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 untuk di-refresh |
DatasetRefreshRequest
Permintaan refresh himpunan data Power BI
Nama | Jenis | Deskripsi |
---|---|---|
applyRefreshPolicy |
boolean |
Menentukan 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 |
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. |
NotifyOption
Opsi pemberitahuan email
Nama | Jenis | Deskripsi |
---|---|---|
MailOnCompletion |
string |
Pemberitahuan email yang menunjukkan keberhasilan atau kegagalan akan dikirim pada penyelesaian refresh |
MailOnFailure |
string |
Pemberitahuan surat akan dikirim saat kegagalan refresh |
NoNotification |
string |
Tidak ada pemberitahuan yang akan dikirim |