Datasets - Update Dataset In Group

Service:

Power BI REST APIs

API Version:

v1.0

Aktualizacje właściwości określonego zestawu danych z określonego obszaru roboczego.

Uprawnienia

Użytkownik musi być właścicielem zestawu danych.

Wymagany zakres

Dataset.ReadWrite.All

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
datasetId	path	True	string	Identyfikator zestawu danych
groupId	path	True	string uuid	Identyfikator obszaru roboczego

Treść żądania

Nazwa	Typ	Opis
queryScaleOutSettings	DatasetQueryScaleOutSettings	Ustawienia skalowania zapytań w poziomie zestawu danych
targetStorageMode	string	Tryb przechowywania zestawu danych

Odpowiedzi

Nazwa	Typ	Opis
200 OK		OK

Przykłady

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

Definicje

Nazwa	Opis
DatasetQueryScaleOutSettings	Ustawienia skalowania zapytań w poziomie zestawu danych
UpdateDatasetRequest	Aktualizowanie żądania zestawu danych

DatasetQueryScaleOutSettings

Ustawienia skalowania zapytań w poziomie zestawu danych

Nazwa	Typ	Opis
autoSyncReadOnlyReplicas	boolean	Czy zestaw danych automatycznie synchronizuje repliki tylko do odczytu
maxReadOnlyReplicas	integer	Maksymalna liczba replik tylko do odczytu dla zestawu danych (0-64, -1 dla automatycznej liczby replik)

UpdateDatasetRequest

Aktualizowanie żądania zestawu danych

Nazwa	Typ	Opis
queryScaleOutSettings	DatasetQueryScaleOutSettings	Ustawienia skalowania zapytań w poziomie zestawu danych
targetStorageMode	string	Tryb przechowywania zestawu danych