Datasets - Trigger Query Scale Out Sync

서비스:

Power BI REST APIs

API 버전:

v1.0

내 작업 영역지정된 데이터 세트에 대한 읽기 전용 복제본의 쿼리 스케일 아웃 동기화를 트리거합니다.

필수 범위

Dataset.ReadWrite.All

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
datasetId	path	True	string	데이터 세트 ID

응답

Name	형식	Description
200 OK	DatasetQueryScaleOutSyncStatus	그래

예제

Trigger query scale-out sync example

샘플 요청

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

샘플 응답

상태 코드:

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

정의

Name	Description
DatasetQueryScaleOutSyncStatus	데이터 세트 쿼리 스케일 아웃 동기화 상태
QueryScaleOutStatus	쿼리 스케일 아웃 상태
QueryScaleOutSyncTriggerReason	쿼리 스케일 아웃 동기화 트리거 이유

DatasetQueryScaleOutSyncStatus

Object

데이터 세트 쿼리 스케일 아웃 동기화 상태

Name	형식	Description
commitTimestamp	string (date-time)	최신 커밋 버전을 나타내는 타임스탬프
commitVersion	integer (int64)	최신 커밋 버전
minActiveReadTimestamp	string (date-time)	최소 활성 읽기 버전을 나타내는 타임스탬프
minActiveReadVersion	integer (int64)	최소 활성 읽기 버전
scaleOutStatus	QueryScaleOutStatus	쿼리 스케일 아웃 상태
syncEndTime	string (date-time)	마지막 동기화가 종료된 시기를 나타내는 타임스탬프
syncStartTime	string (date-time)	마지막 동기화가 시작된 시기를 나타내는 타임스탬프
targetSyncTimestamp	string (date-time)	대상 동기화 버전을 나타내는 타임스탬프
targetSyncVersion	integer (int64)	대상 동기화 버전
triggerReason	QueryScaleOutSyncTriggerReason	쿼리 스케일 아웃 동기화 트리거 이유

QueryScaleOutStatus

열거형

쿼리 스케일 아웃 상태

값	Description
Enabled	쿼리 스케일 아웃이 사용하도록 설정됨
TenantSettingDisabled	쿼리 스케일 아웃 테넌트 설정이 비활성화됨
StorageModeNotSupported	데이터 세트의 스토리지 모드에는 쿼리 스케일 아웃이 지원되지 않습니다.
ReadOnlyReplicasDisabled	쿼리 스케일 아웃 최대 읽기 전용 복제본이 0으로 설정됩니다.

QueryScaleOutSyncTriggerReason

열거형

쿼리 스케일 아웃 동기화 트리거 이유

값	Description
explicit	동기화가 명시적으로 트리거됨
automatic	동기화가 자동으로 트리거됨
system	시스템 이벤트 후 동기화가 트리거되었습니다.