Freigeben über

Datasets - Update Dataset In Group

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

Updates die Eigenschaften für das angegebene Dataset aus dem angegebenen Arbeitsbereich aus.

Berechtigungen

Der Benutzer muss der Besitzer des Datasets sein.

Erforderlicher Bereich

Dataset.ReadWrite.All

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
 path True

string

Die Dataset-ID
groupId
 path True

string

uuid

Arbeitsbereich-ID

Anforderungstext

Name Typ Beschreibung
queryScaleOutSettings

DatasetQueryScaleOutSettings

Abfragen von Horizontalskalierungseinstellungen eines Datasets
targetStorageMode

string

Der Datasetspeichermodus

Antworten

Name Typ Beschreibung
200 OK

OK

Beispiele

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

Definitionen

Name Beschreibung
DatasetQueryScaleOutSettings

Abfragen von Horizontalskalierungseinstellungen eines Datasets
UpdateDatasetRequest

Aktualisieren der Datasetanforderung

DatasetQueryScaleOutSettings

Abfragen von Horizontalskalierungseinstellungen eines Datasets

Name Typ Beschreibung
autoSyncReadOnlyReplicas

boolean

Gibt an, ob das Dataset schreibgeschützte Replikate automatisch synchronisiert.
maxReadOnlyReplicas

integer

Maximale Anzahl schreibgeschützter Replikate für das Dataset (0-64, -1 für die automatische Anzahl von Replikaten)

UpdateDatasetRequest

Aktualisieren der Datasetanforderung

Name Typ Beschreibung
queryScaleOutSettings

DatasetQueryScaleOutSettings

Abfragen von Horizontalskalierungseinstellungen eines Datasets
targetStorageMode

string

Der Datasetspeichermodus