Datasets - Get Query Scale Out Sync Status In Group

Service:

Power BI REST APIs

API Version:

v1.0

Zwraca stan synchronizacji skalowania zapytania w poziomie dla określonego zestawu danych z określonego obszaru roboczego.

Uprawnienia

To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: Profile jednostki usługi w Power BI Embedded.

Wymagany zakres

Dataset.ReadWrite.All lub Dataset.Read.All

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
datasetId	path	True	string	Identyfikator zestawu danych
groupId	path	True	string uuid	Identyfikator obszaru roboczego

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DatasetQueryScaleOutSyncStatus	OK

Przykłady

Get query scale-out sync status example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/queryScaleOut/syncStatus

Sample Response

Status code:

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

Definicje

Nazwa	Opis
DatasetQueryScaleOutSyncStatus	Stan synchronizacji zapytań dotyczących zestawu danych skalowalnego w poziomie
QueryScaleOutStatus	Stan skalowania zapytań w poziomie
QueryScaleOutSyncTriggerReason	Przyczyna wyzwalacza synchronizacji skalowania w poziomie zapytań

DatasetQueryScaleOutSyncStatus

Stan synchronizacji zapytań dotyczących zestawu danych skalowalnego w poziomie

Nazwa	Typ	Opis
commitTimestamp	string	Sygnatura czasowa wskazująca najnowszą wersję zatwierdzenia
commitVersion	integer	Najnowsza wersja zatwierdzenia
minActiveReadTimestamp	string	Sygnatura czasowa wskazująca minimalną aktywną wersję odczytu
minActiveReadVersion	integer	Minimalna aktywna wersja odczytu
scaleOutStatus	QueryScaleOutStatus	Stan skalowania zapytań w poziomie
syncEndTime	string	Sygnatura czasowa wskazująca, kiedy ostatnia synchronizacja została zakończona
syncStartTime	string	Sygnatura czasowa wskazująca, kiedy rozpoczęto ostatnią synchronizację
targetSyncTimestamp	string	Sygnatura czasowa wskazująca docelową wersję synchronizacji
targetSyncVersion	integer	Docelowa wersja synchronizacji
triggerReason	QueryScaleOutSyncTriggerReason	Przyczyna wyzwalacza synchronizacji skalowania w poziomie zapytań

QueryScaleOutStatus

Stan skalowania zapytań w poziomie

Nazwa	Typ	Opis
Enabled	string	Włączono skalowanie zapytań w poziomie
ReadOnlyReplicasDisabled	string	Maksymalna liczba replik tylko do odczytu dla zapytań jest ustawiona na 0
StorageModeNotSupported	string	Skalowanie zapytań w poziomie nie jest obsługiwane w trybie przechowywania zestawu danych
TenantSettingDisabled	string	Ustawienie dzierżawy skalowania zapytań w poziomie jest wyłączone

QueryScaleOutSyncTriggerReason

Przyczyna wyzwalacza synchronizacji skalowania w poziomie zapytań

Nazwa	Typ	Opis
automatic	string	Synchronizacja została automatycznie wyzwolona
explicit	string	Synchronizacja została jawnie wyzwolona
system	string	Synchronizacja została wyzwolona po zdarzeniu systemowym