Datasets - Trigger Query Scale Out Sync

Dienst:: Power BI REST APIs

API-Version:: v1.0

Löst eine Abfrageskalierungssynchronisierung von schreibgeschützten Replikaten für das angegebene Semantikmodell aus. Das Semantikmodell kann sich im Arbeitsbereich "Mein Arbeitsbereich" oder in einem anderen Arbeitsbereich befinden, vorausgesetzt, der Aufrufer verfügt über die erforderlichen Berechtigungen.

Erforderlicher Bereich

Dataset.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/queryScaleOut/sync

URI-Parameter

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

Antworten

Name	Typ	Beschreibung
200 OK	DatasetQueryScaleOutSyncStatus	OKAY

Beispiele

Trigger query scale-out sync example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 200

{
  "commitVersion": 133186221251720662,
  "commitTimestamp": "2023-01-19T17:15:25.1720662Z",
  "targetSyncVersion": 133184583205771509,
  "targetSyncTimestamp": "2023-01-17T19:45:20.5771509Z",
  "triggerReason": "explicit",
  "syncStartTime": "2023-01-17T20:37:49.9625479Z",
  "syncEndTime": "2023-01-17T20:37:50.6029293Z",
  "minActiveReadVersion": 133184583205771509,
  "minActiveReadTimestamp": "2023-01-17T19:45:20.5771509Z",
  "scaleOutStatus": "Enabled"
}

Definitionen

Name	Beschreibung
DatasetQueryScaleOutSyncStatus	Synchronisierungsstatus der Datasetabfrage
QueryScaleOutStatus	Abfrageskalierungsstatus
QueryScaleOutSyncTriggerReason	Ursache für den Auslöser für die Abfrageskalierung

DatasetQueryScaleOutSyncStatus

Objekt

Synchronisierungsstatus der Datasetabfrage

Name	Typ	Beschreibung
commitTimestamp	string (date-time)	Zeitstempel, der die neueste Commit-Version angibt
commitVersion	integer (int64)	Neueste Commit-Version
minActiveReadTimestamp	string (date-time)	Zeitstempel, der die mindestens aktive Leseversion angibt
minActiveReadVersion	integer (int64)	Mindestens aktive Leseversion
scaleOutStatus	QueryScaleOutStatus	Abfrageskalierungsstatus
syncEndTime	string (date-time)	Zeitstempel, der angibt, wann die letzte Synchronisierung beendet wurde
syncStartTime	string (date-time)	Zeitstempel, der angibt, wann die letzte Synchronisierung gestartet wurde
targetSyncTimestamp	string (date-time)	Zeitstempel, der die Zielsynchronisierungsversion angibt
targetSyncVersion	integer (int64)	Zielsynchronisierungsversion
triggerReason	QueryScaleOutSyncTriggerReason	Ursache für den Auslöser für die Abfrageskalierung

QueryScaleOutStatus

Enumeration

Abfrageskalierungsstatus

Wert	Beschreibung
Enabled	Die Abfrageskalierung ist aktiviert.
TenantSettingDisabled	Die Mandanteneinstellung für die Abfrageskalierung ist deaktiviert.
StorageModeNotSupported	Die Abfrageskalierung wird für den Speichermodus des Datasets nicht unterstützt.
ReadOnlyReplicasDisabled	Maximal schreibgeschützte Replikate für die Abfrageskalierung sind auf 0 festgelegt.

QueryScaleOutSyncTriggerReason

Enumeration

Ursache für den Auslöser für die Abfrageskalierung

Wert	Beschreibung
explicit	Die Synchronisierung wurde explizit ausgelöst.
automatic	Die Synchronisierung wurde automatisch ausgelöst.
system	Die Synchronisierung wurde nach einem Systemereignis ausgelöst.