GenerateDISyncTaskConfigForUpdating - DataWorks - Centro de documentación de Alibaba Cloud

Descripción de la operación

Actualmente, DataWorks admite llamar directamente a la operación UpdateDISyncTask para actualizar las tareas de sincronización sin conexión de integración de datos. Para actualizar una tarea de sincronización en tiempo real de integración de datos, primero debe llamar a las operaciones GenerateDISyncTaskConfigForUpdating y QueryDISyncTaskConfigProcessResult para generar de forma asíncrona los parámetros necesarios para la actualización. Luego, pase los parámetros generados como entrada a la operación UpdateDISyncTask para actualizar la tarea de sincronización en tiempo real. Solo puede utilizar el método asíncrono para actualizar las tareas de sincronización en tiempo real de integración de datos.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ProjectId	integer	Sí	El ID del espacio de trabajo de DataWorks. Puede iniciar sesión en la consola de DataWorks e ir a la página de configuración del espacio de trabajo para obtener el ID del espacio de trabajo. Este parámetro determina el espacio de trabajo de DataWorks en el que se llama a la operación de API.	10000
TaskType	string	Sí	El tipo de tarea de sincronización de Data Integration que se actualizará de forma asíncrona. Valores válidos: DI_REALTIME: tarea de sincronización en tiempo real. DI_SOLUTION: tarea de sincronización de solución. Solo las tareas de sincronización en tiempo real y de solución se pueden actualizar de forma asíncrona. Valores válidos: DI_REALTIME : Tarea de sincronización en tiempo real. DI_SOLUTION : Tarea de sincronización de solución. DI_OFFLINE : Tarea de sincronización sin conexión.	DI_REALTIME
TaskParam	string	Sí	Las instrucciones de script para actualizar la tarea de sincronización. Actualmente, el método asíncrono solo admite agregar o quitar tablas para las tareas de sincronización de integración de datos. Solo se pueden actualizar los siguientes tipos de tareas de sincronización: Sincronización de datos de MySQL a MaxCompute. Sincronización de datos de MySQL a Kafka. Sincronización de datos de MySQL a Hologres. En una tarea de sincronización, SelectedTables se utiliza para seleccionar tablas en el modo de múltiples bases de datos, y Tables se utiliza para seleccionar tablas en el modo de base de datos única. Si el script contiene la instrucción SelectedTables, el sistema utiliza la información de las tablas en la instrucción SelectedTables para la sincronización. Si el script contiene la instrucción Tables, el sistema utiliza la información de los campos en la instrucción Tables para la sincronización.	{"steps":[{"parameter":{"connection":[{"table":["xyx"]}]},"name":"Reader","category":"reader"}]}
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia. Este parámetro evita las operaciones duplicadas causadas por múltiples llamadas.	ABFUOEUOTRTRJKE
TaskId	integer	Sí	El ID de la tarea. Si TaskType se establece en DI_REALTIME, TaskId es el FileId de la tarea de sincronización en tiempo real. Si TaskType se establece en DI_SOLUTION, TaskId es el FileId de la tarea de sincronización de solución.	100

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	La respuesta.
Success	boolean	Indica si la solicitud se realizó correctamente. Valores válidos: true: La solicitud se realizó correctamente. false: La solicitud falló.	true
RequestId	string	El ID de la solicitud. Puede utilizar este ID para localizar los registros y solucionar problemas.	0bc1411515937635973****
Data	object	El resultado de generar el ID de subproceso asíncrono.
Status	string	El estado de la generación del ID de subproceso asíncrono. Valores válidos: success: Se generó el ID de subproceso asíncrono. fail: No se pudo generar el ID de subproceso asíncrono. Puede ver la causa del error y resolver el problema.	true
ProcessId	integer	El ID de subproceso asíncrono. Debe utilizar este ID para llamar a la operación QueryDISyncTaskConfigProcessResult y obtener los parámetros necesarios para actualizar de forma asíncrona la tarea de sincronización de integración de datos, y luego utilizar los parámetros para actualizar la tarea.	10
Message	string	El motivo por el que no se pudo generar el ID de subproceso asíncrono. Si se genera el ID de subproceso asíncrono, este parámetro queda vacío.	XXX is invalid.

Ejemplos

Respuesta exitosa

JSON Formato

{
  "Success": true,
  "RequestId": "0bc1411515937635973****",
  "Data": {
    "Status": "true",
    "ProcessId": 10,
    "Message": "XXX is invalid."
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	Invalid.DI.Parameter	The parameter is invalid.	Se produjo un error en un parámetro.
400	Invalid.DI.Parameter.File.Existed	The file name already exists.	El parámetro no es válido porque el nombre del archivo ya existe.
500	InternalError.DI.Parameter	A DI internal error occurred.	Se produjo un error interno de negocio en Data Integration.
403	Forbidden.DI.NoPrivilege	No access.	No tiene los permisos de acceso.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.