Datasets - Get Query Scale Out Sync Status In Group

リファレンス

Service:: Power BI REST APIs

API Version:: v1.0

指定したワークスペースから、指定したデータセットのクエリスケールアウト同期状態を返します。

アクセス許可

この API 呼び出しは、サービスプリンシパルプロファイルによって呼び出すことができます。詳細については、「Power BI Embeddedのサービスプリンシパルプロファイル」を参照してください。

必要なスコープ

Dataset.ReadWrite.All または Dataset.Read.All

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

URI パラメーター

名前	/	必須	型	説明
datasetId	path	True	string	データセット ID
groupId	path	True	string uuid	ワークスペース ID

応答

名前	型	説明
200 OK	DatasetQueryScaleOutSyncStatus	OK

例

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

定義

名前	説明
DatasetQueryScaleOutSyncStatus	データセットクエリのスケールアウト同期の状態
QueryScaleOutStatus	クエリスケールアウトの状態
QueryScaleOutSyncTriggerReason	クエリスケールアウト同期トリガーの理由

DatasetQueryScaleOutSyncStatus

データセットクエリのスケールアウト同期の状態

名前	型	説明
commitTimestamp	string	最新のコミットバージョンを示すタイムスタンプ
commitVersion	integer	最新のコミットバージョン
minActiveReadTimestamp	string	アクティブな最小読み取りバージョンを示すタイムスタンプ
minActiveReadVersion	integer	アクティブな最小読み取りバージョン
scaleOutStatus	QueryScaleOutStatus	クエリスケールアウトの状態
syncEndTime	string	最終同期が終了した日時を示すタイムスタンプ
syncStartTime	string	前回の同期が開始された日時を示すタイムスタンプ
targetSyncTimestamp	string	ターゲット同期バージョンを示すタイムスタンプ
targetSyncVersion	integer	ターゲット同期のバージョン
triggerReason	QueryScaleOutSyncTriggerReason	クエリスケールアウト同期トリガーの理由

QueryScaleOutStatus

クエリスケールアウトの状態

名前	型	説明
Enabled	string	クエリのスケールアウトが有効になっている
ReadOnlyReplicasDisabled	string	クエリスケールアウトの最大読み取り専用レプリカが 0 に設定されている
StorageModeNotSupported	string	クエリスケールアウトは、データセットのストレージモードではサポートされていません
TenantSettingDisabled	string	クエリスケールアウトテナント設定が無効になっている

QueryScaleOutSyncTriggerReason

クエリスケールアウト同期トリガーの理由

名前	型	説明
automatic	string	同期が自動的にトリガーされました
explicit	string	同期が明示的にトリガーされました
system	string	システムイベントの後に同期がトリガーされました

次の方法で共有