Datasets - Trigger Query Scale Out Sync In Group

Servicio:: Power BI REST APIs

Versión de la API:: v1.0

Desencadena una sincronización horizontal de consultas de réplicas de solo lectura para el conjunto de datos especificado desde el área de trabajo especificada.

Permisos

Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: perfiles de entidad de servicio de en Power BI Embedded.

Ámbito requerido

Dataset.ReadWrite.All

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
datasetId	path	True	string	Identificador del conjunto de datos
groupId	path	True	string (uuid)	Identificador del área de trabajo

Respuestas

Nombre	Tipo	Description
200 OK	DatasetQueryScaleOutSyncStatus	De acuerdo

Ejemplos

Trigger query scale-out sync example

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre	Description
DatasetQueryScaleOutSyncStatus	Estado de sincronización escalada de consultas de conjunto de datos
QueryScaleOutStatus	Estado de escalado horizontal de consultas
QueryScaleOutSyncTriggerReason	Motivo del desencadenador de sincronización escalada de consultas

DatasetQueryScaleOutSyncStatus

Object

Estado de sincronización escalada de consultas de conjunto de datos

Nombre	Tipo	Description
commitTimestamp	string (date-time)	Marca de tiempo que indica la versión de confirmación más reciente
commitVersion	integer (int64)	Versión de confirmación más reciente
minActiveReadTimestamp	string (date-time)	Marca de tiempo que indica la versión de lectura activa mínima
minActiveReadVersion	integer (int64)	Versión de lectura activa mínima
scaleOutStatus	QueryScaleOutStatus	Estado de escalado horizontal de consultas
syncEndTime	string (date-time)	Marca de tiempo que indica cuándo finalizó la última sincronización
syncStartTime	string (date-time)	Marca de tiempo que indica cuándo se inició la última sincronización
targetSyncTimestamp	string (date-time)	Marca de tiempo que indica la versión de sincronización de destino
targetSyncVersion	integer (int64)	Versión de sincronización de destino
triggerReason	QueryScaleOutSyncTriggerReason	Motivo del desencadenador de sincronización escalada de consultas

QueryScaleOutStatus

Enumeración

Estado de escalado horizontal de consultas

Valor	Description
Enabled	El escalado horizontal de consultas está habilitado
TenantSettingDisabled	La configuración de inquilino de escalabilidad horizontal de consultas está deshabilitada
StorageModeNotSupported	No se admite el escalado horizontal de consultas para el modo de almacenamiento del conjunto de datos
ReadOnlyReplicasDisabled	Las réplicas de solo lectura máximas de escalado horizontal de consultas se establecen en 0.

QueryScaleOutSyncTriggerReason