Datasets - Update Dataset

Dienst:: Power BI REST APIs

API-Version:: v1.0

Aktualisiert die Eigenschaften für das angegebene Semantikmodell. Das Semantikmodell kann sich im Arbeitsbereich "Mein Arbeitsbereich" oder in einem anderen Arbeitsbereich befinden, vorausgesetzt, der Aufrufer verfügt über die erforderlichen Berechtigungen.

Erlaubnisse

Der Benutzer muss der Datasetbesitzer sein.

Erforderlicher Bereich

Dataset.ReadWrite.All

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string	Die Dataset-ID

Anforderungstext

Name	Typ	Beschreibung
queryScaleOutSettings	DatasetQueryScaleOutSettings	Abfrageskalierungseinstellungen eines Datasets
targetStorageMode	string	Der Datasetspeichermodus

Antworten

Name	Typ	Beschreibung
200 OK		OKAY

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

Beispielanforderung

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229

Anforderungstext

{
  "targetStorageMode": "PremiumFiles"
}

Beispiel für eine Antwort

Statuscode:: 200

Example of changing the dataset storage mode to support small datasets

Beispielanforderung

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229

Anforderungstext

{
  "targetStorageMode": "Abf"
}

Beispiel für eine Antwort

Statuscode:: 200

Example of updating scale-out settings of a dataset

Beispielanforderung

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229

Anforderungstext

{
  "queryScaleOutSettings": {
    "autoSyncReadOnlyReplicas": false,
    "maxReadOnlyReplicas": -1
  }
}

Beispiel für eine Antwort

Statuscode:: 200

Definitionen

Name	Beschreibung
DatasetQueryScaleOutSettings	Abfrageskalierungseinstellungen eines Datasets
UpdateDatasetRequest	Aktualisieren der Datasetanforderung

DatasetQueryScaleOutSettings

Objekt

Abfrageskalierungseinstellungen eines Datasets

Name	Typ	Beschreibung
autoSyncReadOnlyReplicas	boolean	Gibt an, ob das Dataset schreibgeschützte Replikate automatisch synchronisiert.
maxReadOnlyReplicas	integer minimum: -1 maximum: 64	Maximale Anzahl schreibgeschützter Replikate für das Dataset (0-64, -1 für die automatische Anzahl von Replikaten)

UpdateDatasetRequest

Objekt

Aktualisieren der Datasetanforderung

Name	Typ	Beschreibung
queryScaleOutSettings	DatasetQueryScaleOutSettings	Abfrageskalierungseinstellungen eines Datasets
targetStorageMode	string	Der Datasetspeichermodus