Consulter le statut d'une tâche de synchronisation de données - Data Transmission Service

Test

Vous pouvez appeler cette opération dans OpenAPI Explorer. Après un appel réussi, OpenAPI Explorer génère automatiquement l'exemple de code SDK.

Paramètres de requête

Nom	Type	Obligatoire	Exemple	Description
Action	String	Oui	DescribeSynchronizationJobStatus	Définissez la valeur sur DescribeSynchronizationJobStatus.
RegionId	String	Non	cn-hangzhou	L'ID de la région où réside l'instance de synchronisation de données. Pour plus d'informations, consultez Régions prises en charge.
SynchronizationJobId	String	Oui	dtsexjk1alb116****	L'ID de la tâche de synchronisation de données. Vous pouvez appeler l'opération DescribeSynchronizationJobs pour interroger l'ID de la tâche.
SynchronizationDirection	String	Non	Forward	La direction de la synchronisation. Valeurs possibles : Forward : Les données sont synchronisées de la base de données source vers la base de données de destination. Reverse : Les données sont synchronisées de la base de données de destination vers la base de données source. Remarque La valeur par défaut est Forward. La valeur Reverse prend effet uniquement si la topologie de la tâche de synchronisation de données est une synchronisation bidirectionnelle.
ClientToken	String	Non	0c593ea1-3bea-11e9-b96b-88e9fe63****	Un jeton client qui garantit l'idempotence de la requête. La valeur doit être unique parmi les différentes requêtes et ne peut contenir que des caractères ASCII. Longueur maximale : 64 caractères.
AccountId	String	Non	12323344****	L'ID du compte Alibaba Cloud. Il n'est pas nécessaire de définir ce paramètre car il sera obsolète.
ResourceGroupId	String	Non	rg-acfmzawhxxc****	L'ID du groupe de ressources.

Paramètres de réponse

Nom	Type	Exemple	Description
SynchronizationJobName	String	MySQL synchronization	Le nom de la tâche de synchronisation de données.
Status	String	synchronizing	Le statut de la tâche de synchronisation de données. Valeurs possibles : notStarted : La tâche n'a pas démarré. prechecking : La tâche est en cours de précontrôle. precheckFailed : Le précontrôle de la tâche a échoué. initializating : La tâche est en cours de synchronisation initiale. initializeFailed : La synchronisation initiale de la tâche a échoué. synchronizing : La tâche est en cours de synchronisation. failed : La tâche a échoué. suspending : La tâche est suspendue. modifying : Les objets de synchronisation sont en cours de modification. finished : La tâche est terminée.
DataInitialization	String	true	Indique si la synchronisation initiale complète des données est effectuée. true : Oui. false : Non.
Delay	String	0	La latence de synchronisation, en secondes.
ErrorMessage	String	DTS-070211: Connect Source DB failed. cause by [com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException:Could not create connection to database server. Attempted reconnect 3 times. Giving up.][com.mysql.jdbc.exceptions.jdbc4.CommunicationsException:Communications link failure\n\nThe last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.][java.net.ConnectException:Connection timed out (Connection timed out)] About more information in [https://yq.aliyun.com/articles/499178].	Le message d'erreur renvoyé en cas d'échec de la synchronisation des données.
ExpireTime	String	2021-03-07T16:00:00Z	L'heure d'expiration de la tâche de synchronisation de données. L'heure est au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC. Remarque Ce paramètre est renvoyé uniquement si la valeur de retour du paramètre PayType est PrePaid.
ErrCode	String	InternalError	Le code d'erreur renvoyé en cas d'échec de l'appel.
Success	String	true	Indique si la requête a abouti.
StructureInitialization	String	true	Indique si la synchronisation initiale du schéma est effectuée. true : Oui. false : Non.
PayType	String	PrePaid	La méthode de facturation de la tâche de synchronisation de données. Valeurs possibles : PrePaid : abonnement. PostPaid : paiement à l'utilisation.
ErrMessage	String	The request processing has failed due to some unknown error.	Le message d'erreur renvoyé en cas d'échec de l'appel.
SynchronizationJobClass	String	large	La spécification de la tâche de synchronisation de données.
RequestId	String	DACDF659-AFC6-4DC8-ADB8-4569419A4****	L'ID de la requête.
SynchronizationJobId	String	dtsexjk1alb116****	L'ID de la tâche de synchronisation de données.
DelayMillis	Long	506	La latence de synchronisation, en millisecondes.
SynchronizationDirection	String	Forward	La direction de la synchronisation. Valeurs possibles : Forward : Les données sont synchronisées de la base de données source vers la base de données de destination. Reverse : Les données sont synchronisées de la base de données de destination vers la base de données source.
TaskId	String	exjk1alb116****	L'ID de la tâche de synchronisation de données.
Checkpoint	String	1610616144	L'horodatage du dernier enregistrement de données synchronisé, sous forme d'horodatage UNIX. Remarque Vous pouvez utiliser un moteur de recherche pour trouver un convertisseur d'horodatage UNIX.
DataInitializationStatus	Object		Le statut de la synchronisation initiale complète des données.
Status	String	Finished	Le statut de la synchronisation initiale complète des données. Valeurs possibles : NotStarted : La synchronisation n'a pas démarré. Migrating : La synchronisation est en cours. Failed : La synchronisation a échoué. Finished : La synchronisation est terminée.
Percent	String	100	La progression de la synchronisation initiale complète des données, en pourcentage.
ErrorMessage	String	java.lang.NumberFormatException: For input string: ""	Le message d'erreur renvoyé en cas d'échec de la synchronisation initiale complète des données.
Progress	String	200001	Le nombre d'enregistrements synchronisés lors de la synchronisation initiale complète des données.
DataSynchronizationStatus	Object		Le statut de la synchronisation incrémentielle des données.
Status	String	Finished	Le statut de la synchronisation incrémentielle des données. Valeurs possibles : NotStarted : La synchronisation n'a pas démarré. Migrating : La synchronisation est en cours. Failed : La synchronisation a échoué. Finished : La synchronisation est terminée.
Delay	String	0	La latence de la synchronisation incrémentielle des données, en secondes.
Percent	String	100	La progression de la synchronisation incrémentielle des données, en pourcentage.
ErrorMessage	String	The task has failed for too long and cannot be recovered.	Le message d'erreur renvoyé en cas d'échec de la synchronisation incrémentielle des données.
DelayMillis	Long	856	La latence de la synchronisation incrémentielle des données, en millisecondes.
Checkpoint	String	1610709865	L'horodatage du dernier enregistrement de données synchronisé. Il s'agit d'un horodatage UNIX.
DestinationEndpoint	Object		Les paramètres de connexion de l'instance de destination.
InstanceId	String	rm-bp162d4tp0500****	L'ID de l'instance de destination.
IP	String	172.16.88.***	Le point de terminaison de l'instance de destination.
InstanceType	String	RDS	Le type de l'instance de destination.
Port	String	3306	Le port de service de la base de données de destination.
UserName	String	dtstest	Le compte de base de données de l'instance de destination.
EngineName	String	MySQL	Le type de base de données de l'instance de destination.
Performance	Object		Aperçu du lien de synchronisation.
RPS	String	100	Le nombre d'instructions SQL synchronisées par seconde, y compris les instructions BEGIN, COMMIT, DML et DDL.
FLOW	String	1	Le trafic de données synchronisé par seconde, en Mo/s.
PrecheckStatus	Object		Le statut du précontrôle.
Status	String	Success	Le résultat du précontrôle. Valeurs possibles : Success : La tâche a passé le précontrôle. Failed : La tâche a échoué au précontrôle.
Percent	String	100	La progression globale du précontrôle, en pourcentage.
Detail	Array of CheckItem		Les détails de chaque élément de précontrôle.
CheckStatus	String	Success	Le résultat de la vérification. Valeurs possibles : Success : L'élément a passé la vérification. Failed : L'élément a échoué à la vérification.
ErrorMessage	String	Original error: Access denied for user 'dtstest'@'100.104.*.' (using password: YES)	Le message d'erreur renvoyé en cas d'échec du précontrôle. Remarque Ce paramètre est renvoyé uniquement si la valeur de retour du paramètre CheckStatus est Failed.
ItemName	String	CHECK_CONN_SRC	L'élément de précontrôle.
RepairMethod	String	CHECK_ERROR_DEST_CONN_REPAIR2	La méthode pour corriger un échec de précontrôle. Remarque Ce paramètre est renvoyé uniquement si la valeur de retour du paramètre CheckStatus est Failed.
SourceEndpoint	Object		Les paramètres de connexion de l'instance source.
InstanceId	String	rm-bp1i99e8l7913****	L'ID de l'instance source.
IP	String	172.16.88.***	Le point de terminaison de l'instance source.
InstanceType	String	RDS	Le type de l'instance source.
Port	String	3306	Le port de service de la base de données source.
UserName	String	dtstest	Le compte de base de données de l'instance source.
EngineName	String	MySQL	Le type de base de données de l'instance source.
StructureInitializationStatus	Object		Le statut de la synchronisation initiale du schéma.
Status	String	Finished	Le statut de la synchronisation initiale du schéma. Valeurs possibles : NotStarted : La synchronisation n'a pas démarré. Migrating : La synchronisation est en cours. Failed : La synchronisation a échoué. Finished : La synchronisation est terminée.
Percent	String	100	La progression de la synchronisation initiale du schéma, en pourcentage.
ErrorMessage	String	DTS-1020042 Execute sql error sql: ERROR: type "geometry" does not exist;	Le message d'erreur renvoyé en cas d'exception lors de la synchronisation initiale du schéma.
Progress	String	1	Le nombre de tables dont les schémas ont été synchronisés lors de la synchronisation initiale du schéma.
SynchronizationObjects	Array of SynchronizationObject		Les objets de synchronisation.
NewSchemaName	String	newdtstestdatabase	Le nom de la base de données vers laquelle la base de données source est mappée dans la destination.
SchemaName	String	dtstestdatabase	Le nom de la base de données source à synchroniser.
TableExcludes	Array of TableExclude		Les tables exclues de la synchronisation dans la base de données.
TableName	String	order	Le nom de la table exclue.
TableIncludes	Array of TableInclude		Les tables à synchroniser.
TableName	String	customer	Le nom de la table à synchroniser.

Exemples

Exemple de requête

http(s)://dts.aliyuncs.com/?Action=DescribeSynchronizationJobStatus
&SynchronizationJobId=dtsexjk1alb116****
&<Common request parameters>

Exemple de réponse réussie

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeSynchronizationJobStatusResponse>
    <TaskId>exjk1alb116****</TaskId>
    <SynchronizationObjects>
        <SchemaName>newdtstestdatabase</SchemaName>
        <NewSchemaName>dtstestdatabase</NewSchemaName>
    </SynchronizationObjects>
    <DataInitializationStatus>
        <Status>Finished</Status>
        <Progress>200001</Progress>
        <Percent>100</Percent>
    </DataInitializationStatus>
    <Delay>0</Delay>
    <Success>true</Success>
    <DelayMillis>0</DelayMillis>
    <DataInitialization>true</DataInitialization>
    <SynchronizationJobClass>large</SynchronizationJobClass>
    <Status>synchronizing</Status>
    <RequestId>DACDF659-AFC6-4DC8-ADB8-4569419A****</RequestId>
    <SynchronizationJobName>MySQL synchronization</SynchronizationJobName>
    <PayType>PostPaid</PayType>
    <ErrMessage/>
    <PrecheckStatus>
        <Status>Finished</Status>
        <Percent>100</Percent>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_CONN_SRC</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_AUTH_SRC</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_CONN_DEST</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_AUTH_DEST</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_BINLOG_ON</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_BINLOG_MODE</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_BINLOG_ROW_IMAGE</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_SERVER_ID</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_BINLOG_EXIST</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_ENGINE</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_MYSQL_PASSOWRD_FORMAT</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_SRC</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_SAME_OBJ</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_SQL_MODE</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_SAME_USER</ItemName>
        </Detail>
        <Detail>
            <CheckStatus>Success</CheckStatus>
            <ItemName>CHECK_TOPOLOGY</ItemName>
        </Detail>
    </PrecheckStatus>
    <Checkpoint>1610616144</Checkpoint>
    <SynchronizationJobId>dtsexjk1alb116****</SynchronizationJobId>
    <DestinationEndpoint>
        <InstanceId>rm-bp1u40w1ip917****</InstanceId>
        <InstanceType>RDS</InstanceType>
        <EngineName>MySQL</EngineName>
    </DestinationEndpoint>
    <SourceEndpoint>
        <InstanceId>rm-bp1i99e8l7913****</InstanceId>
        <InstanceType>RDS</InstanceType>
        <EngineName>MySQL</EngineName>
    </SourceEndpoint>
    <StructureInitialization>true</StructureInitialization>
    <Performance>
        <RPS>0</RPS>
        <FLOW>0.00MB/s</FLOW>
    </Performance>
    <StructureInitializationStatus>
        <Status>Finished</Status>
        <Progress>1</Progress>
        <Percent>100</Percent>
    </StructureInitializationStatus>
</DescribeSynchronizationJobStatusResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TaskId" : "exjk1alb116****",
  "SynchronizationObjects" : [ {
    "TableIncludes" : [ ],
    "TableExcludes" : [ ],
    "SchemaName" : "newdtstestdatabase",
    "NewSchemaName" : "dtstestdatabase"
  } ],
  "DataInitializationStatus" : {
    "Status" : "Finished",
    "Progress" : "200001",
    "Percent" : "100"
  },
  "Delay" : "0",
  "Success" : true,
  "DelayMillis" : 0,
  "DataInitialization" : true,
  "SynchronizationJobClass" : "large",
  "Status" : "synchronizing",
  "RequestId" : "DACDF659-AFC6-4DC8-ADB8-4569419A****",
  "SynchronizationJobName" : "MySQL synchronization",
  "PayType" : "PostPaid",
  "ErrMessage" : "",
  "PrecheckStatus" : {
    "Status" : "Finished",
    "Percent" : "100",
    "Detail" : [ {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_CONN_SRC"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_AUTH_SRC"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_CONN_DEST"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_AUTH_DEST"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_BINLOG_ON"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_BINLOG_MODE"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_BINLOG_ROW_IMAGE"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_SERVER_ID"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_BINLOG_EXIST"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_ENGINE"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_MYSQL_PASSOWRD_FORMAT"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_SRC"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_SAME_OBJ"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_SQL_MODE"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_SAME_USER"
    }, {
      "CheckStatus" : "Success",
      "ItemName" : "CHECK_TOPOLOGY"
    } ]
  },
  "Checkpoint" : "1610616144",
  "SynchronizationJobId" : "dtsexjk1alb116****",
  "DestinationEndpoint" : {
    "InstanceId" : "rm-bp1u40w1ip917****",
    "InstanceType" : "RDS",
    "EngineName" : "MySQL"
  },
  "SourceEndpoint" : {
    "InstanceId" : "rm-bp1i99e8l7913****",
    "InstanceType" : "RDS",
    "EngineName" : "MySQL"
  },
  "StructureInitialization" : true,
  "Performance" : {
    "RPS" : "0",
    "FLOW" : "0.00MB/s"
  },
  "StructureInitializationStatus" : {
    "Status" : "Finished",
    "Progress" : "1",
    "Percent" : "100"
  }
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	Throttling.User	Request was denied due to user flow control.	La requête a été rejetée car la fréquence des requêtes a atteint le seuil. Réessayez ultérieurement.
403	InvalidSecurityToken.Expired	Specified SecurityToken is expired.	Le jeton de sécurité spécifié a expiré. Mettez à jour la signature.
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	La requête a échoué car le serveur a expiré ou était indisponible. Réessayez. Si la requête échoue à nouveau, contactez le support technique.

Pour une liste des codes d'erreur, consultez le Centre d'erreurs.