通过

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 参数

名称 在 必需 类型 说明
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

示例请求

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

定义

名称 说明
DatasetQueryScaleOutSettings

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

更新数据集请求

DatasetQueryScaleOutSettings

Object

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

名称 类型 说明
autoSyncReadOnlyReplicas

boolean

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

integer

minimum: -1
maximum: 64

数据集的最大只读副本数（0-64，-1 自动副本数）

UpdateDatasetRequest

Object

更新数据集请求

名称 类型 说明
queryScaleOutSettings

DatasetQueryScaleOutSettings

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

string

数据集存储模式