GenerateDISyncTaskConfigForUpdating - 异步生成更新同步任务配置 - 大数据开发治理平台 DataWorks

异步生成更新同步任务的JSON。

接口说明

DataWorks 目前仅支持直接使用 UpdateDISyncTask 接口更新数据集成离线同步任务，而数据集成实时同步任务则需要先调用 GenerateDISyncTaskConfigForUpdating 和 QueryDISyncTaskConfigProcessResult 接口，异步生成更新数据集成同步任务需要的参数，再将该参数作为 UpdateDISyncTask 接口的入参，使用 UpdateDISyncTask 接口更新相应的实时同步任务。仅支持使用异步方式更新数据集成实时同步任务。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
ProjectId	long	是	DataWorks 工作空间的 ID。您可以登录 DataWorks 控制台，进入工作空间配置页面获取工作空间 ID。该参数用来确定本次 API 调用操作使用的 DataWorks 工作空间。	10000
TaskType	string	是	使用异步方式更新数据集成同步任务的任务类型。取值如下： DI_REALTIME：表示实时同步任务。 DI_SOLUTION：表示解决方案同步任务。仅支持使用异步方式更新数据集成实时同步任务和解决方案同步任务。	DI_REALTIME
TaskParam	string	是	更新同步任务的脚本语句。目前仅支持通过异步方式为数据集成同步任务新增表或者删除表，并且仅支持更新如下类型的同步任务：同步 MySQL 数据至 MaxCompute。同步 MySQL 数据至 Kafka。同步 MySQL 数据至 Hologres。同步任务中的 SelectedTables 用于多库模式选择同步表，Tables 用于单库模式选择同步表。当脚本中包含 SelectedTables 语句时，系统会使用 SelectedTables 语句中的表信息进行同步。当脚本中包含 Tables 语句时，系统会使用 Tables 的字段信息进行同步。	{"steps":[{"parameter":{"connection":[{"table":["xyx"]}]},"name":"Reader","category":"reader"}]}
ClientToken	string	否	幂等参数。用于避免多次调用导致操作重复。	ABFUOEUOTRTRJKE
TaskId	long	是	任务 ID。当 TaskType 参数配置为实时同步任务（DI_REALTIME），则 TaskId 为实时同步任务的 FileId。当 TaskType 参数配置为解决方案同步任务（DI_SOLUTION），则 TaskId 为解决方案同步任务的 FileId。	100

返回参数

名称	类型	描述	示例值
	object	返回结果。
Success	boolean	请求是否成功。取值如下： true：成功。 false：失败。	true
RequestId	string	请求 ID。用于定位日志，排查问题。	0bc1411515937635973****
Data	object	异步线程 ID 的生成结果。
Status	string	生成异步线程 ID 的结果状态。取值如下： success：表示成功生成异步线程 ID。 fail：表示异步线程 ID 生成失败。您可以查看失败原因，处理相关问题。	true
ProcessId	long	异步线程 ID。您需要通过该 ID，调用 QueryDISyncTaskConfigProcessResult 接口获取异步生成更新数据集成同步任务需要的参数，后续使用该参数更新数据集成同步任务。	10
Message	string	异步线程 ID 生成失败的原因描述。如果成功生成异步线程 ID，则该参数的返回值为空。	XXX is invalid.

示例

正常返回示例

JSON格式

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

错误码

HTTP status code	错误码	错误信息	描述
400	Invalid.DI.Parameter	The parameter is invalid.	参数错误
400	Invalid.DI.Parameter.File.Existed	The file name already exists.	参数不合法，文件名已存在
403	Forbidden.DI.NoPrivilege	No access.	没有权限访问
500	InternalError.DI.Parameter	A DI internal error occurred.	数据集成内部业务错误

访问错误中心查看更多错误码。