共用方式為

Datasets - Update Dataset

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

從 [我的工作區] 更新指定資料集的屬性。

權限

使用者必須是資料集擁有者。

必要範圍

Dataset.ReadWrite.All

PATCH https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}

URI 參數

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

string

資料集識別碼

要求本文

名稱 類型 Description
queryScaleOutSettings

DatasetQueryScaleOutSettings

查詢資料集的向外延展設定
targetStorageMode

string

資料集儲存模式

回應

名稱 類型 Description
200 OK

確定

範例

Example of changing the dataset storage mode to support large datasets
Example of changing the dataset storage mode to support small datasets
Example of updating scale-out settings of a dataset

Example of changing the dataset storage mode to support large datasets

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229
Request Body
{
  "targetStorageMode": "PremiumFiles"
}

Sample Response

Status code:
200

Example of changing the dataset storage mode to support small datasets

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229
Request Body
{
  "targetStorageMode": "Abf"
}

Sample Response

Status code:
200

Example of updating scale-out settings of a dataset

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229
Request Body
{
  "queryScaleOutSettings": {
    "autoSyncReadOnlyReplicas": false,
    "maxReadOnlyReplicas": -1
  }
}

Sample Response

Status code:
200

定義

名稱 Description
DatasetQueryScaleOutSettings

查詢資料集的向外延展設定
UpdateDatasetRequest

更新資料集要求

DatasetQueryScaleOutSettings

查詢資料集的向外延展設定

名稱 類型 Description
autoSyncReadOnlyReplicas

boolean

資料集是否自動同步唯讀複本
maxReadOnlyReplicas

integer

資料集的唯讀複本數目上限 (0-64，-1 則為自動複本數目)

UpdateDatasetRequest

更新資料集要求

名稱 類型 Description
queryScaleOutSettings

DatasetQueryScaleOutSettings

查詢資料集的向外延展設定
targetStorageMode

string

資料集儲存模式