Datasets - Update Dataset

Dienst:

Power BI REST APIs

API-Version:

v1.0

Updates die Eigenschaften für das angegebene Dataset aus "Mein Arbeitsbereich" aus.

Berechtigungen

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

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	Abfragen von Horizontalskalierungseinstellungen eines Datasets
UpdateDatasetRequest	Datasetanforderung aktualisieren

DatasetQueryScaleOutSettings

Object

Abfragen von Horizontalskalierungseinstellungen eines Datasets

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

UpdateDatasetRequest

Object

Datasetanforderung aktualisieren

Name	Typ	Beschreibung
queryScaleOutSettings	DatasetQueryScaleOutSettings	Abfragen von Horizontalskalierungseinstellungen eines Datasets
targetStorageMode	string	Der Datasetspeichermodus