Datasets - Refresh Dataset

  • Referensi
Service:
Power BI REST APIs
API Version:
v1.0

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 selain notifyOption 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
datasetId
 path True

string

ID himpunan data

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
notifyOption True

NotifyOption

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

DatasetCommitMode

Menentukan apakah objek akan diterapkan dalam batch atau hanya ketika selesai
effectiveDate

string

Jika kebijakan refresh bertahap diterapkan, parameter effectiveDate akan mengambil alih tanggal saat ini.
maxParallelism

integer

Jumlah maksimum utas untuk menjalankan perintah pemrosesan paralel
objects

DatasetRefreshObjects[]

Array objek yang akan diproses
retryCount

integer

Berapa kali operasi akan mencoba kembali sebelum gagal
type

DatasetRefreshType

Jenis pemrosesan yang akan dilakukan

Respons

Nama Jenis Deskripsi
202 Accepted

Diterima

Headers

  • x-ms-request-id: string
  • Location: string

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

Status code:
202 
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
Request Body
{
  "type": "full",
  "commitMode": "transactional",
  "objects": [
    {
      "table": "Customer",
      "partition": "Robert"
    }
  ],
  "applyRefreshPolicy": "false"
}

Sample Response

Status code:
200

Definisi

Nama Deskripsi
DatasetCommitMode

Menentukan apakah objek akan diterapkan dalam batch atau hanya ketika selesai
DatasetRefreshObjects

Target refresh himpunan data Power BI
DatasetRefreshRequest

Permintaan refresh himpunan data Power BI
DatasetRefreshType

Jenis pemrosesan yang akan dilakukan
NotifyOption

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 partialBatch mode, operasi refresh tidak terjadi dalam transaksi. Akibatnya, setiap perintah akan diterapkan secara individual, dan jika terjadi kegagalan, model mungkin berakhir dalam keadaan di mana hanya subset data yang dimuat, atau tabel dibiarkan kosong. Jika Anda ingin menjamin pelestarian data sebelumnya jika terjadi kegagalan, Anda harus menjalankan operasi dengan commitMode = transactional.
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

DatasetCommitMode

Menentukan apakah objek akan diterapkan dalam batch atau hanya ketika selesai
effectiveDate

string

Jika kebijakan refresh bertahap diterapkan, parameter effectiveDate akan mengambil alih tanggal saat ini.
maxParallelism

integer

Jumlah maksimum utas untuk menjalankan perintah pemrosesan paralel
notifyOption

NotifyOption

Opsi pemberitahuan email. Parameter ini tidak berlaku untuk refresh yang ditingkatkan atau operasi API dengan perwakilan layanan.
objects

DatasetRefreshObjects[]

Array objek yang akan diproses
retryCount

integer

Berapa kali operasi akan mencoba kembali sebelum gagal
type

DatasetRefreshType

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