Udostępnij za pośrednictwem

Datasets - Update Dataset

  • Odwołanie
Service:
Power BI REST APIs
API Version:
v1.0

Aktualizacje właściwości określonego zestawu danych z obszaru Mój obszar roboczy.

Uprawnienia

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

Wymagany zakres

Dataset.ReadWrite.All

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
datasetId
 path True

string

Identyfikator zestawu danych

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/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/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/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