Datasets - Trigger Query Scale Out Sync

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Dispara uma sincronização de expansão de consulta de réplicas somente leitura para o conjunto de dados especificado do Meu workspace.

Escopo necessário

Dataset.ReadWrite.All

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
datasetId	path	True	string	A ID do conjunto de dados

Respostas

Nome	Tipo	Description
200 OK	DatasetQueryScaleOutSyncStatus	OKEY

Exemplos

Trigger query scale-out sync example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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"
}

Definições

Nome	Description
DatasetQueryScaleOutSyncStatus	Status de sincronização de expansão da consulta do conjunto de dados
QueryScaleOutStatus	Status de expansão de consulta
QueryScaleOutSyncTriggerReason	Motivo do gatilho de sincronização de expansão de consulta

DatasetQueryScaleOutSyncStatus

Objeto

Status de sincronização de expansão da consulta do conjunto de dados

Nome	Tipo	Description
commitTimestamp	string (date-time)	Carimbo de data/hora que indica a versão de confirmação mais recente
commitVersion	integer (int64)	Versão de confirmação mais recente
minActiveReadTimestamp	string (date-time)	Carimbo de data/hora que indica a versão de leitura ativa mínima
minActiveReadVersion	integer (int64)	Versão de leitura ativa mínima
scaleOutStatus	QueryScaleOutStatus	Status de expansão de consulta
syncEndTime	string (date-time)	Carimbo de data/hora indicando quando a última sincronização terminou
syncStartTime	string (date-time)	Carimbo de data/hora que indica quando a última sincronização foi iniciada
targetSyncTimestamp	string (date-time)	Carimbo de data/hora que indica a versão de sincronização de destino
targetSyncVersion	integer (int64)	Versão de sincronização de destino
triggerReason	QueryScaleOutSyncTriggerReason	Motivo do gatilho de sincronização de expansão de consulta

QueryScaleOutStatus

Enumeração

Status de expansão de consulta

Valor	Description
Enabled	A expansão da consulta está habilitada
TenantSettingDisabled	A configuração de locatário de expansão de consulta está desabilitada
StorageModeNotSupported	Não há suporte para expansão de consulta para o modo de armazenamento do conjunto de dados
ReadOnlyReplicasDisabled	As réplicas somente leitura máxima de expansão de consulta são definidas como 0

QueryScaleOutSyncTriggerReason