Datasets - Trigger Query Scale Out Sync

Service:: Power BI REST APIs

Version d'API:: v1.0

Déclenche une synchronisation de scale-out de requête de réplicas en lecture seule pour le jeu de données spécifié à partir de Mon espace de travail.

Étendue requise

Dataset.ReadWrite.All

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
datasetId	path	True	string	ID du jeu de données

Réponses

Nom	Type	Description
200 OK	DatasetQueryScaleOutSyncStatus	D’ACCORD

Exemples

Trigger query scale-out sync example

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
}

Définitions

Nom	Description
DatasetQueryScaleOutSyncStatus	État de synchronisation scale-out des requêtes de jeu de données
QueryScaleOutStatus	État de scale-out des requêtes
QueryScaleOutSyncTriggerReason	Raison du déclencheur de synchronisation avec montée en charge des requêtes

DatasetQueryScaleOutSyncStatus

Object

État de synchronisation scale-out des requêtes de jeu de données

Nom	Type	Description
commitTimestamp	string (date-time)	Horodatage indiquant la dernière version de validation
commitVersion	integer (int64)	Dernière version de validation
minActiveReadTimestamp	string (date-time)	Horodatage indiquant la version de lecture active minimale
minActiveReadVersion	integer (int64)	Version de lecture active minimale
scaleOutStatus	QueryScaleOutStatus	État de scale-out des requêtes
syncEndTime	string (date-time)	Horodatage indiquant quand la dernière synchronisation s’est terminée
syncStartTime	string (date-time)	Horodatage indiquant quand la dernière synchronisation a démarré
targetSyncTimestamp	string (date-time)	Horodatage indiquant la version de synchronisation cible
targetSyncVersion	integer (int64)	Version de synchronisation cible
triggerReason	QueryScaleOutSyncTriggerReason	Raison du déclencheur de synchronisation avec montée en charge des requêtes

QueryScaleOutStatus

Énumération

État de scale-out des requêtes

Valeur	Description
Enabled	Le scale-out des requêtes est activé
TenantSettingDisabled	Le paramètre de locataire scale-out de requête est désactivé
StorageModeNotSupported	Le scale-out des requêtes n’est pas pris en charge pour le mode de stockage du jeu de données
ReadOnlyReplicasDisabled	Les réplicas max en lecture seule de requête sont définis sur 0

QueryScaleOutSyncTriggerReason