Bagikan melalui

Datasets - Refresh Dataset

  • Referensi
Layanan:
Power BI REST APIs
Versi API:
v1.0

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 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. Kesalahan internal sementara dapat memicu coba lagi refresh, bahkan ketika parameter ini diatur ke 0.
timeout

string

Jika timeout ditentukan, setiap upaya refresh data pada model semantik akan mematuhi batas waktu tersebut. Perhatikan bahwa satu permintaan refresh dapat menyertakan beberapa upaya jika retryCount ditentukan, yang dapat menyebabkan total durasi refresh melebihi batas waktu yang ditentukan. Misalnya, menetapkan timeout selama 1 jam dan retryCount sebesar 2 dapat menghasilkan total durasi penyegaran hingga 3 jam. Pengguna dapat menyesuaikan timeout untuk mempersingkat durasi refresh untuk deteksi kegagalan yang lebih cepat atau memperluasnya di luar default 5 jam untuk refresh data yang lebih kompleks. Namun, total durasi refresh, termasuk percobaan ulang, tidak boleh melebihi 24 jam.
type

DatasetRefreshType

Jenis pemrosesan yang akan dilakukan

Respons

Nama Jenis Deskripsi
202 Accepted

Diterima

Header

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

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

Kode status:
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

Permintaan sampel

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes
Isi Permintaan
{
  "type": "full",
  "commitMode": "transactional",
  "objects": [
    {
      "table": "Customer",
      "partition": "Robert"
    }
  ],
  "applyRefreshPolicy": "false",
  "timeout": "05:00:00"
}

Respon sampel

Kode status:
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

Enumeration

Menentukan apakah objek akan diterapkan dalam batch atau hanya ketika selesai

Nilai Deskripsi
PartialBatch

Terapkan operasi refresh dalam batch. Saat menggunakan mode partialBatch, operasi refresh tidak terjadi dalam transaksi. Akibatnya, setiap perintah akan dilakukan 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

Menerapkan seluruh operasi refresh sebagai transaksi

DatasetRefreshObjects

Object

Target refresh himpunan data Power BI

Nama Jenis Deskripsi
partition

string

Partisi untuk di-refresh
table

string

Tabel yang akan di-refresh

DatasetRefreshRequest

Object

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. Kesalahan internal sementara dapat memicu coba lagi refresh, bahkan ketika parameter ini diatur ke 0.
timeout

string

Jika timeout ditentukan, setiap upaya refresh data pada model semantik akan mematuhi batas waktu tersebut. Perhatikan bahwa satu permintaan refresh dapat menyertakan beberapa upaya jika retryCount ditentukan, yang dapat menyebabkan total durasi refresh melebihi batas waktu yang ditentukan. Misalnya, menetapkan timeout selama 1 jam dan retryCount sebesar 2 dapat menghasilkan total durasi penyegaran hingga 3 jam. Pengguna dapat menyesuaikan timeout untuk mempersingkat durasi refresh untuk deteksi kegagalan yang lebih cepat atau memperluasnya di luar default 5 jam untuk refresh data yang lebih kompleks. Namun, total durasi refresh, termasuk percobaan ulang, tidak boleh melebihi 24 jam.
type

DatasetRefreshType

Jenis pemrosesan yang akan dilakukan

DatasetRefreshType

Enumeration

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

Enumeration

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