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

Идентификатор набора данных
groupId
 path True

string

uuid

идентификатор рабочей области;

Текст запроса

Имя Тип Описание
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

Режим хранения набора данных