GenerateDISyncTaskConfigForUpdating - - Centro de documentación de Alibaba Cloud

Genera un ID para un hilo asíncrono que se utiliza para actualizar un nodo de sincronización en tiempo real o una solución de sincronización en Data Integration. Este ID se usa al llamar a la operación QueryDISyncTaskConfigProcessResult para obtener los parámetros generados de forma asíncrona y necesarios para actualizar un nodo de sincronización en tiempo real o una solución de sincronización en Data Integration.

DataWorks permite usar únicamente la operación UpdateDISyncTask para actualizar un nodo de sincronización por lotes en Data Integration. Para actualizar un nodo de sincronización en tiempo real o una solución de sincronización, primero debe llamar a la operación GenerateDISyncTaskConfigForUpdating con el fin de generar el ID de un hilo asíncrono. Después, llame a la operación QueryDISyncTaskConfigProcessResult para obtener los parámetros generados de forma asíncrona según dicho ID. Posteriormente, podrá llamar a la operación UpdateDISyncTask y utilizar esos parámetros como parámetros de solicitud para actualizar un nodo de sincronización en tiempo real o una solución de sincronización en Data Integration. DataWorks solo admite la actualización de nodos de sincronización en tiempo real y soluciones de sincronización en Data Integration mediante el modo asíncrono.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda llamar a esta operación from OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	GenerateDISyncTaskConfigForUpdating	La operación que desea ejecutar.
ProjectId	Long	Sí	10000	El ID del espacio de trabajo de DataWorks. Inicie sesión en la consola de DataWorks y vaya a la página Workspace Management para obtener el ID del espacio de trabajo. Este parámetro especifica el espacio de trabajo de DataWorks al que se aplica la operación.
TaskType	String	Sí	DI_REALTIME	El tipo de objeto que desea actualizar en Data Integration mediante el modo asíncrono. Valores válidos: DI_REALTIME: nodo de sincronización en tiempo real DI_SOLUTION: solución de sincronización DataWorks solo permite actualizar nodos de sincronización en tiempo real y soluciones de sincronización en Data Integration mediante el modo asíncrono.
RegionId	String	Sí	cn-zhangjiakou	El ID de la región. Por ejemplo, el ID de la región China (Shanghai) es cn-shanghai y el de la región China (Zhangjiakou) es cn-zhangjiakou. El sistema determina el valor de este parámetro según el endpoint utilizado para llamar a la operación.
TaskParam	String	Sí	{ "steps": [ { "parameter": { "connection": [ { "table": [ "xyx" ] } ] }, "name": "Reader", "category": "reader" } ] }	El script para actualizar el nodo de sincronización en tiempo real o la solución de sincronización en Data Integration. DataWorks solo permite agregar o eliminar tablas de un nodo de sincronización en tiempo real o una solución de sincronización en Data Integration mediante el modo asíncrono. Se admiten a continuación tipos de nodos de sincronización en tiempo real y soluciones de sincronización: Nodo de sincronización en tiempo real o solución de sincronización utilizada para sincronizar datos de MySQL a MaxCompute Nodo de sincronización en tiempo real o solución de sincronización utilizada para sincronizar datos de MySQL a Kafka Nodo de sincronización en tiempo real o solución de sincronización utilizada para sincronizar datos de MySQL a Hologres El parámetro SelectedTables se usa para especificar las tablas que desea sincronizar from varias bases de datos. El parámetro Tables se usa para especificar las tablas que desea sincronizar from una sola base de datos. Si el script contiene el parámetro SelectedTables, el sistema sincroniza las tablas que especifique en dicho parámetro. Si el script contiene el parámetro Tables, el sistema sincroniza las tablas que especifique en dicho parámetro.
ClientToken	String	No	ABFUOEUOTRTRJKE	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Este parámetro evita operaciones repetidas causadas por varios llamadas.
TaskId	Long	Sí	100	El ID del nodo de sincronización en tiempo real o de la solución de sincronización. Si establece el parámetro TaskType en DI_REALTIME, configure el parámetro TaskId con el valor del parámetro FileId correspondiente al nodo de sincronización en tiempo real. Si establece el parámetro TaskType en DI_SOLUTION, configure el parámetro TaskId con el valor del parámetro FileId correspondiente a la solución de sincronización.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Success	Boolean	true	Indica si la solicitud se completó correctamente. Valores válidos: true: La solicitud se completó correctamente. false: La solicitud falló.
RequestId	String	0bc1411515937635973****	El ID de la solicitud. Puede localizar registros y solucionar problemas con base en este ID.
Data	Object		La información devuelta para el ID del hilo asíncrono.
Status	String	true	Indica si se generó el ID del hilo asíncrono. Valores válidos: success: indica que se generó el ID del hilo asíncrono. fail: indica que no se pudo generar el ID del hilo asíncrono. Puede consultar el motivo del fallo y solucionar el problema con base en dicha información.
ProcessId	Long	10	El ID del hilo asíncrono. Puede llamar a la operación QueryDISyncTaskConfigProcessResult para obtener los parámetros generados de forma asíncrona según este ID. Dichos parámetros se utilizan para actualizar un nodo de sincronización en tiempo real o una solución de sincronización en Data Integration.
Message	String	XXX is invalid.	El motivo por el cual no se generó el ID del hilo asíncrono. Si el ID se genera correctamente, se devuelve el valor null.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=GenerateDISyncTaskConfigForUpdating
&ProjectId=10000
&TaskType=DI_REALTIME
&TaskParam={"steps":[{"parameter":{"connection":[{"table":["xyx"]}]},"name":"Reader","category":"reader"}]}
&ClientToken=ABFUOEUOTRTRJKE
&TaskId=100
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<GenerateDISyncTaskConfigForUpdatingResponse>
    <Success>true</Success>
    <RequestId>0bc1411515937635973****</RequestId>
    <Data>
        <Status>true</Status>
        <ProcessId>10</ProcessId>
        <Message>XXX is invalid.</Message>
    </Data>
</GenerateDISyncTaskConfigForUpdatingResponse>

Formato JSON

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

{
  "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.	El mensaje de error devuelto porque uno o más parámetros no son válidos.
400	Invalid.DI.Parameter.File.Existed	The file name already exists.	El mensaje de error devuelto porque el nombre de archivo especificado ya existe.
403	Forbidden.DI.NoPrivilege	No access.	El mensaje de error devuelto porque no cuenta con los permisos necesarios.
500	InternalError.DI.Parameter	A DI internal error occurred.	El mensaje de error devuelto porque ocurrió un error interno en Data Integration.

Para consultar una lista de códigos de error, visite el Centro de errores de API.