通过

Datasets - Update Dataset In Group

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

汇报指定工作区中指定数据集的属性。

权限

用户必须是数据集所有者。

所需范围

Dataset.ReadWrite.All

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

URI 参数

名称 在 必需 类型 说明
datasetId
 path True

string

数据集 ID
groupId
 path True

string

uuid

工作区 ID

请求正文

名称 类型 说明
queryScaleOutSettings

DatasetQueryScaleOutSettings

查询数据集的横向扩展设置
targetStorageMode

string

数据集存储模式

响应

名称 类型 说明
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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229
Request Body
{
  "queryScaleOutSettings": {
    "autoSyncReadOnlyReplicas": false,
    "maxReadOnlyReplicas": -1
  }
}

Sample Response

Status code:
200

定义

名称 说明
DatasetQueryScaleOutSettings

查询数据集的横向扩展设置
UpdateDatasetRequest

更新数据集请求

DatasetQueryScaleOutSettings

查询数据集的横向扩展设置

名称 类型 说明
autoSyncReadOnlyReplicas

boolean

数据集是否自动同步只读副本
maxReadOnlyReplicas

integer

数据集的最大只读副本数 (0-64，-1 表示自动副本数)

UpdateDatasetRequest

更新数据集请求

名称 类型 说明
queryScaleOutSettings

DatasetQueryScaleOutSettings

查询数据集的横向扩展设置
targetStorageMode

string

数据集存储模式