Datasets - Update Parameters
Updates nilai parameter untuk himpunan data yang ditentukan dari Ruang kerja saya.
Catatan
Sebaiknya gunakan metadata himpunan data yang disempurnakan dengan panggilan API ini.
Penting
- Jika Anda menggunakan metadata himpunan data yang disempurnakan, refresh himpunan data untuk menerapkan nilai parameter baru.
- Jika Anda tidak menggunakan metadata himpunan data yang disempurnakan, tunggu 30 menit hingga operasi perbarui sumber data selesai, lalu refresh himpunan data.
Izin
Pengguna harus menjadi pemilik himpunan data.
Cakupan yang Diperlukan
Dataset.ReadWrite.All
Batasan
- Himpunan data yang dibuat atau dimodifikasi menggunakan titik akhir XMLA publik tidak didukung. Untuk membuat perubahan pada himpunan data tersebut, admin harus menggunakan pustaka klien Azure Analysis Services untuk Model Objek Tabular.
- Koneksi DirectQuery hanya didukung dengan metadata himpunan data yang disempurnakan.
- Himpunan data dengan koneksi langsung Azure Analysis Services tidak didukung.
- Maksimum 100 parameter per permintaan.
- Semua parameter yang ditentukan harus ada dalam himpunan data.
- Nilai parameter harus dari jenis yang diharapkan.
- Daftar parameter tidak boleh kosong atau menyertakan parameter duplikat.
- Nama parameter peka huruf besar/kecil.
- Parameter
IsRequired
harus memiliki nilai yang tidak kosong. - Jenis
Any
parameter danBinary
tidak dapat diperbarui.
POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.UpdateParameters
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
dataset
|
path | True |
string |
ID himpunan data |
Isi Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
updateDetails | True |
Daftar parameter himpunan data untuk diperbarui |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
OK |
Contoh
Example
Permintaan sampel
POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters
{
"updateDetails": [
{
"name": "DatabaseName",
"newValue": "NewDB"
},
{
"name": "MaxId",
"newValue": "5678"
}
]
}
Respon sampel
Definisi
Nama | Deskripsi |
---|---|
Update |
Detail pembaruan untuk parameter himpunan data Power BI |
Update |
Permintaan pembaruan untuk parameter himpunan data Power BI |
UpdateMashupParameterDetails
Detail pembaruan untuk parameter himpunan data Power BI
Nama | Jenis | Deskripsi |
---|---|---|
name |
string |
Nama parameter |
newValue |
string |
Nilai baru untuk parameter |
UpdateMashupParametersRequest
Permintaan pembaruan untuk parameter himpunan data Power BI
Nama | Jenis | Deskripsi |
---|---|---|
updateDetails |
Daftar parameter himpunan data untuk diperbarui |