Bagikan melalui


Datasets - Update Parameters In Group

Updates nilai parameter untuk himpunan data yang ditentukan dari ruang kerja yang ditentukan.

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 agar operasi sumber data pembaruan selesai, lalu refresh himpunan data.

Izin

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 dan Binary tidak dapat diperbarui.

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/Default.UpdateParameters

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
datasetId
path True

string

groupId
path True

string

uuid

ID ruang kerja

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
updateDetails True

UpdateMashupParameterDetails[]

Daftar parameter himpunan data yang akan diperbarui

Respons

Nama Jenis Deskripsi
200 OK

OK

Contoh

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters
{
  "updateDetails": [
    {
      "name": "DatabaseName",
      "newValue": "NewDB"
    },
    {
      "name": "MaxId",
      "newValue": "5678"
    }
  ]
}

Sample Response

Definisi

Nama Deskripsi
UpdateMashupParameterDetails

Detail pembaruan untuk parameter himpunan data Power BI

UpdateMashupParametersRequest

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

UpdateMashupParameterDetails[]

Daftar parameter himpunan data yang akan diperbarui