Datasets - Update Dataset In Group

服務:

Power BI REST APIs

API 版本:

v1.0

從指定的工作區更新指定數據集的屬性。

權限

用戶必須是數據集擁有者。

必要範圍

Dataset.ReadWrite.All

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

URI 參數

名稱	位於	必要	類型	Description
datasetId	path	True	string	數據集標識碼
groupId	path	True	string (uuid)	工作區標識碼

要求本文

名稱	類型	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

範例要求

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229

要求本文

{
  "targetStorageMode": "PremiumFiles"
}

範例回覆

狀態碼:

200

Example of changing the dataset storage mode to support small datasets

範例要求

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229

要求本文

{
  "targetStorageMode": "Abf"
}

範例回覆

狀態碼:

200

Example of updating scale-out settings of a dataset

範例要求

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229

要求本文

{
  "queryScaleOutSettings": {
    "autoSyncReadOnlyReplicas": false,
    "maxReadOnlyReplicas": -1
  }
}

範例回覆

狀態碼:

200

定義

名稱	Description
DatasetQueryScaleOutSettings	查詢數據集的向外延展設定
UpdateDatasetRequest	更新數據集要求

DatasetQueryScaleOutSettings

Object

查詢數據集的向外延展設定

名稱	類型	Description
autoSyncReadOnlyReplicas	boolean	數據集是否自動同步只讀複本
maxReadOnlyReplicas	integer minimum: -1 maximum: 64	資料集的唯讀複本數目上限（0-64，-1 自動復本數目）

UpdateDatasetRequest

Object

更新數據集要求

名稱	類型	Description
queryScaleOutSettings	DatasetQueryScaleOutSettings	查詢數據集的向外延展設定
targetStorageMode	string	數據集儲存模式