共用方式為


Datasets - Update Parameters In Group

從指定的工作區更新指定資料集的參數值。

備註

我們建議使用此 API 呼叫使用 增強型資料集中繼資料

這很重要

  • 如果您使用 增強型資料集中繼資料,請重新整理資料集以套用新的參數值。
  • 如果您未使用 增強型資料集中繼資料,請等待 30 分鐘讓更新資料來源作業完成,然後重新整理資料集。

權限

必要範圍

Dataset.ReadWrite.All

局限性

  • 不支援使用公用 XMLA 端點 建立或修改的資料集。 若要變更這些資料集,系統管理員必須使用表格式物件模型的 Azure Analysis Services 用戶端程式庫。
  • DirectQuery 連線僅支援 增強型資料集中繼資料
  • 不支援具有 Azure Analysis Services 即時連線的資料集。
  • 每個請求最多有 100 個參數。
  • 所有指定的參數都必須存在於資料集中。
  • 參數值應該是預期的類型。
  • 參數清單不能是空的,也不能包含重複的參數。
  • 參數名稱區分大小寫。
  • 參數 IsRequired 必須具有非空值。
  • 參數類型AnyBinary,且無法更新。

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

URI 參數

名稱 位於 必要 類型 Description
datasetId
path True

string

groupId
path True

string (uuid)

工作區識別碼

要求本文

名稱 必要 類型 Description
updateDetails True

UpdateMashupParameterDetails[]

要更新的資料集參數清單

回應

名稱 類型 Description
200 OK

OK

範例

Example

範例要求

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"
    }
  ]
}

範例回覆

定義

名稱 Description
UpdateMashupParameterDetails

Power BI 資料集參數的更新詳細資料

UpdateMashupParametersRequest

Power BI 資料集參數的更新要求

UpdateMashupParameterDetails

Power BI 資料集參數的更新詳細資料

名稱 類型 Description
name

string

參數名稱

newValue

string

參數的新值

UpdateMashupParametersRequest

Power BI 資料集參數的更新要求

名稱 類型 Description
updateDetails

UpdateMashupParameterDetails[]

要更新的資料集參數清單