Consulta del estado de un trabajo de sincronización de datos - Data Transmission Service

Consulta el estado de un trabajo de sincronización de datos.

Prueba

Puede llamar a esta operación en OpenAPI Explorer. Tras una llamada correcta, OpenAPI Explorer genera automáticamente el código de ejemplo del SDK.

Parámetros de solicitud

Nombre	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeSynchronizationJobStatus	Establezca el valor en DescribeSynchronizationJobStatus.
RegionId	String	No	cn-hangzhou	ID de la región donde reside la instancia de sincronización de datos. Para obtener más información, consulte Supported regions.
SynchronizationJobId	String	Sí	dtsexjk1alb116****	ID del trabajo de sincronización de datos. Puede llamar a la operación DescribeSynchronizationJobs para consultar el ID del trabajo.
SynchronizationDirection	String	No	Forward	Dirección de la sincronización. Valores válidos: Forward: Los datos se sincronizan desde la base de datos de origen hacia la base de datos de destino. Reverse: Los datos se sincronizan desde la base de datos de destino hacia la base de datos de origen. Nota El valor predeterminado es Forward. El valor Reverse solo surte efecto si la topología del trabajo de sincronización de datos es de sincronización bidireccional.
ClientToken	String	No	0c593ea1-3bea-11e9-b96b-88e9fe63****	Token de cliente que garantiza la idempotencia de la solicitud. El valor debe ser único entre distintas solicitudes y solo puede contener caracteres ASCII. Longitud máxima: 64 caracteres.
AccountId	String	No	12323344****	ID de la cuenta de Alibaba Cloud. No es necesario establecer este parámetro porque quedará obsoleto.
ResourceGroupId	String	No	rg-acfmzawhxxc****	ID del resource group.

Parámetros de respuesta

Nombre	Tipo	Ejemplo	Descripción
SynchronizationJobName	String	MySQL synchronization	Nombre del trabajo de sincronización de datos.
Status	String	synchronizing	Estado del trabajo de sincronización de datos. Valores válidos: notStarted: El trabajo no ha iniciado. prechecking: El trabajo se encuentra en fase de precomprobación. precheckFailed: La precomprobación del trabajo falló. initializating: El trabajo se encuentra en sincronización inicial. initializeFailed: Falló la sincronización inicial del trabajo. synchronizing: El trabajo se está sincronizando. failed: El trabajo falló. suspending: El trabajo está en pausa. modifying: Se están modificando los objetos de sincronización. finished: El trabajo ha finalizado.
DataInitialization	String	true	Indica si se realizó la sincronización inicial completa de datos. true: Sí. false: No.
Delay	String	0	Latencia de la sincronización, en segundos.
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].	Mensaje de error devuelto si falla la sincronización de datos.
ExpireTime	String	2021-03-07T16:00:00Z	Fecha de vencimiento del trabajo de sincronización de datos. El formato de la hora es aaaa-MM-ddTHH:mm:ssZ. La hora se muestra en UTC. Nota Este parámetro solo se devuelve si el valor del parámetro PayType es PrePaid.
ErrCode	String	InternalError	Código de error devuelto si la llamada falla.
Success	String	true	Indica si la solicitud se completó correctamente.
StructureInitialization	String	true	Indica si se realizó la sincronización inicial del esquema. true: Sí. false: No.
PayType	String	PrePaid	Método de facturación del trabajo de sincronización de datos. Valores válidos: PrePaid: suscripción. PostPaid: pay-as-you-go.
ErrMessage	String	The request processing has failed due to some unknown error.	Mensaje de error devuelto si la llamada falla.
SynchronizationJobClass	String	large	Especificación del trabajo de sincronización de datos.
RequestId	String	DACDF659-AFC6-4DC8-ADB8-4569419A4****	ID de la solicitud.
SynchronizationJobId	String	dtsexjk1alb116****	ID del trabajo de sincronización de datos.
DelayMillis	Long	506	Latencia de la sincronización, en milisegundos.
SynchronizationDirection	String	Forward	Dirección de la sincronización. Valores válidos: Forward: Los datos se sincronizan desde la base de datos de origen hacia la base de datos de destino. Reverse: Los datos se sincronizan desde la base de datos de destino hacia la base de datos de origen.
TaskId	String	exjk1alb116****	ID de la tarea de sincronización de datos.
Checkpoint	String	1610616144	Marca de tiempo del último registro de datos sincronizado, como marca de tiempo UNIX. Nota Puede utilizar un motor de búsqueda para encontrar un convertidor de marcas de tiempo UNIX.
DataInitializationStatus	Object		Estado de la sincronización inicial completa de datos.
Status	String	Finished	Estado de la sincronización inicial completa de datos. Valores válidos: NotStarted: La sincronización no ha iniciado. Migrating: La sincronización está en curso. Failed: La sincronización falló. Finished: La sincronización ha finalizado.
Percent	String	100	Progreso de la sincronización inicial completa de datos, en porcentaje.
ErrorMessage	String	java.lang.NumberFormatException: For input string: ""	Mensaje de error devuelto si falla la sincronización inicial completa de datos.
Progress	String	200,001	Número de registros sincronizados durante la sincronización inicial completa de datos.
DataSynchronizationStatus	Object		Estado de la sincronización incremental de datos.
Status	String	Finished	Estado de la sincronización incremental de datos. Valores válidos: NotStarted: La sincronización no ha iniciado. Migrating: La sincronización está en curso. Failed: La sincronización falló. Finished: La sincronización ha finalizado.
Delay	String	0	Latencia de la sincronización incremental de datos, en segundos.
Percent	String	100	Progreso de la sincronización incremental de datos, en porcentaje.
ErrorMessage	String	The task has failed for too long and cannot be recovered.	Mensaje de error devuelto si falla la sincronización incremental de datos.
DelayMillis	Long	856	Latencia de la sincronización incremental de datos, en milisegundos.
Checkpoint	String	1610709865	Marca de tiempo del último registro de datos sincronizado. Es una marca de tiempo UNIX.
DestinationEndpoint	Object		Configuración de conexión de la instancia de destino.
InstanceId	String	rm-bp162d4tp0500****	ID de la instancia de destino.
IP	String	172.16.88.***	Endpoint de la instancia de destino.
InstanceType	String	RDS	Tipo de la instancia de destino.
Port	String	3306	Puerto de servicio de la base de datos de destino.
UserName	String	dtstest	Cuenta de base de datos de la instancia de destino.
EngineName	String	MySQL	Tipo de base de datos de la instancia de destino.
Performance	Object		Resumen del enlace de sincronización.
RPS	String	100	Número de sentencias SQL sincronizadas por segundo, incluidas las sentencias BEGIN, COMMIT, DML y DDL.
FLOW	String	1	Tráfico de datos sincronizado por segundo, en MB/s.
PrecheckStatus	Object		Estado de la precomprobación.
Status	String	Success	Resultado de la precomprobación. Valores válidos: Success: El trabajo pasó la precomprobación. Failed: El trabajo no pasó la precomprobación.
Percent	String	100	Progreso general de la precomprobación, en porcentaje.
Detail	Array of CheckItem		Detalles de cada elemento de precomprobación.
CheckStatus	String	Success	Resultado de la comprobación. Valores válidos: Success: El elemento pasó la comprobación. Failed: El elemento no pasó la comprobación.
ErrorMessage	String	Original error: Access denied for user 'dtstest'@'100.104.*.' (using password: YES)	Mensaje de error devuelto si falla la precomprobación. Nota Este parámetro solo se devuelve si el valor del parámetro CheckStatus es Failed.
ItemName	String	CHECK_CONN_SRC	Elemento de precomprobación.
RepairMethod	String	CHECK_ERROR_DEST_CONN_REPAIR2	Método para corregir un fallo en la precomprobación. Nota Este parámetro solo se devuelve si el valor del parámetro CheckStatus es Failed.
SourceEndpoint	Object		Configuración de conexión de la instancia de origen.
InstanceId	String	rm-bp1i99e8l7913****	ID de la instancia de origen.
IP	String	172.16.88.***	Endpoint de la instancia de origen.
InstanceType	String	RDS	Tipo de la instancia de origen.
Port	String	3306	Puerto de servicio de la base de datos de origen.
UserName	String	dtstest	Cuenta de base de datos de la instancia de origen.
EngineName	String	MySQL	Tipo de base de datos de la instancia de origen.
StructureInitializationStatus	Object		Estado de la sincronización inicial del esquema.
Status	String	Finished	Estado de la sincronización inicial del esquema. Valores válidos: NotStarted: La sincronización no ha iniciado. Migrating: La sincronización está en curso. Failed: La sincronización falló. Finished: La sincronización ha finalizado.
Percent	String	100	Progreso de la sincronización inicial del esquema, en porcentaje.
ErrorMessage	String	DTS-1020042 Execute sql error sql: ERROR: type "geometry" does not exist;	Mensaje de error devuelto si ocurre una excepción durante la sincronización inicial del esquema.
Progress	String	1	Número de tablas cuyos esquemas se han sincronizado durante la sincronización inicial del esquema.
SynchronizationObjects	Array of SynchronizationObject		Objetos de sincronización.
NewSchemaName	String	newdtstestdatabase	Nombre de la base de datos a la que se asigna la base de datos de origen en el destino.
SchemaName	String	dtstestdatabase	Nombre de la base de datos de origen que se va a sincronizar.
TableExcludes	Array of TableExclude		Tablas excluidas de la sincronización en la base de datos.
TableName	String	order	Nombre de la tabla excluida.
TableIncludes	Array of TableInclude		Tablas que se van a sincronizar.
TableName	String	customer	Nombre de la tabla que se va a sincronizar.

Ejemplos

Solicitud de ejemplo

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

Respuesta correcta de ejemplo

Formato XML

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>

Formato JSON

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	Throttling.User	Request was denied due to user flow control.	La solicitud se rechazó porque la frecuencia de solicitudes alcanzó el umbral. Inténtelo de nuevo más tarde.
403	InvalidSecurityToken.Expired	Specified SecurityToken is expired.	El token de seguridad especificado ha caducado. Actualice la firma.
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	La solicitud falló porque el servidor agotó el tiempo de espera o no estaba available. Inténtelo de nuevo. Si la solicitud vuelve a fallar, póngase en contacto con el soporte técnico.

Para obtener una lista de códigos de error, consulte el Centro de errores.