Datasets - Trigger Query Scale Out Sync In Group

Dienst:: Power BI REST APIs

API-Version:: v1.0

Löst eine Abfrageskalierungssynchronisierung von schreibgeschützten Replikaten für das angegebene Dataset aus dem angegebenen Arbeitsbereich aus.

Erlaubnisse

Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter: Dienstprinzipalprofile in Power BI Embedded.

Erforderlicher Bereich

Dataset.ReadWrite.All

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string	Die Dataset-ID
groupId	path	True	string (uuid)	Arbeitsbereich-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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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