更新数据集成任务。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
DIJobId | long | 是 | 任务 ID。 | 11588 |
Description | string | 否 | 任务的描述。 | 任务的描述 |
TableMappings | array<object> | 否 | 同步对象转换映射列表,列表中每个元素描述了一组源端同步对象选择规则列表和在该组同步对象上应用的同步对象转换规则列表。 | |
object | 否 | 同步对象转换映射列表,列表中每个元素描述了一组源端同步对象选择规则列表和在该组同步对象上应用的同步对象转换规则列表。 | ||
SourceObjectSelectionRules | array<object> | 否 | 每条规则可选择待同步源端对象的不同对象类型,如选择源端数据库、源端数据表。 | |
object | 否 | 每条规则可选择待同步源端对象的不同对象类型,如选择源端数据库、源端数据表。 | ||
Action | string | 否 | 选择动作,取值范围:Include/Exclude | Include |
Expression | string | 否 | 表达式。 | mysql_table_1 |
ExpressionType | string | 否 | 表达式类型,取值范围:Exact/Regex | Exact |
ObjectType | string | 否 | 对象类型,可选的枚举值:
| Table |
TransformationRules | array<object> | 否 | 源端对象上应用的转换规则。 | |
object | 否 | 源端对象上应用的转换规则。 | ||
RuleName | string | 否 | 规则名称,在一种动作类型+动作作用的目标类型下规则名称唯一。 | rename_rule_1 |
RuleActionType | string | 否 | 动作类型,可选的枚举值:
| Rename |
RuleTargetType | string | 否 | 动作作用的目标类型,可选的枚举值;
| Table |
JobSettings | object | 否 | 同步任务维度的设置,含 DDL 处理策略、源端和目标端列数据类型映射策略、任务运行时参数等。 | |
ChannelSettings | string | 否 | 通道相关任务设置,Json String 形式。 | {"structInfo":"MANAGED","storageType":"TEXTFILE","writeMode":"APPEND","partitionColumns":[{"columnName":"pt","columnType":"STRING","comment":""}],"fieldDelimiter":""} |
ColumnDataTypeSettings | array<object> | 否 | 列类型映射。 | |
object | 否 | 列类型映射。 | ||
DestinationDataType | string | 否 | 目标端类型。 | text |
SourceDataType | string | 否 | 源端类型。 | bigint |
CycleScheduleSettings | object | 否 | 周期调度设置。 | |
ScheduleParameters | string | 否 | 调度参数。 | bizdate=$bizdate |
DdlHandlingSettings | array<object> | 否 | DDL 处理设置。 | |
object | 否 | DDL 处理设置。 | ||
Action | string | 否 | 处理动作,可选的枚举值:
| Critical |
Type | string | 否 | DDL 类型,可选的枚举值;
| AddColumn |
RuntimeSettings | array<object> | 否 | 运行时设置。 | |
object | 否 | 运行时设置。 | ||
Name | string | 否 | 设置名称,可选的枚举值:
| runtime.offline.concurrent |
Value | string | 否 | 设置取值。 | 1 |
ResourceSettings | object | 否 | 资源设置。 | |
OfflineResourceSettings | object | 否 | 离线同步资源。 | |
RequestedCu | double | 否 | 离线同步使用的数据集成资源组 cu | 2.0 |
ResourceGroupIdentifier | string | 否 | 离线同步使用的数据集成资源组标识。 | S_res_group_111_222 |
RealtimeResourceSettings | object | 否 | 实时同步资源。 | |
RequestedCu | double | 否 | 实时同步使用的数据集成资源组 cu | 2.0 |
ResourceGroupIdentifier | string | 否 | 实时同步使用的数据集成资源组标识。 | S_res_group_111_222 |
ScheduleResourceSettings | object | 否 | 调度资源 | |
RequestedCu | double | 否 | 离线同步任务使用的调度资源组 cu | 2.0 |
ResourceGroupIdentifier | string | 否 | 离线同步任务使用的调度资源组标识 | S_res_group_235454102432001_1721021993437 |
TransformationRules | array<object> | 否 | 同步对象转换规则定义列表,列表中每个元素为一条转换规则定义。 | |
object | 否 | 同步对象转换规则定义列表,列表中每个元素为一条转换规则定义。 | ||
RuleActionType | string | 否 | 动作类型,可选的枚举值:
| Rename |
RuleExpression | string | 否 | 规则表达式,json string 格式。 重命名规则(Rename)示例: {"expression":"${srcDatasourceName}_${srcDatabaseName}_0922","variables":[{"variableName":"srcDatabaseName","variableRules":[{"from":"fromdb","to":"todb"}]}]}
在目标端增加指定列并赋值规则(AddColumn)示例: {"columns":[{"columnName":"my_add_column","columnValueType":"Constant","columnValue":"123"}]}
指定目标端表的主键列列名(DefinePrimaryKey)示例: {"columns":["ukcolumn1","ukcolumn2"]}
DML 处理规则(HandleDml)示例: {"dmlPolicies":[{"dmlType":"Delete","dmlAction":"Filter","filterCondition":"id > 1"}]}
| {"expression":"${srcDatasoureName}_${srcDatabaseName}"} |
RuleName | string | 否 | 规则名称,当动作类型和动作作用的目标类型相同时,规则名称需保证唯一性。 | rename_rule_1 |
RuleTargetType | string | 否 | 动作作用的目标类型,可选的枚举值:
| Table |
ProjectId | long | 否 | DataWorks 工作空间 ID。您可以通过 ListProjects 接口获取工作空间 ID。 | 10000 |
返回参数
示例
正常返回示例
JSON
格式
{
"Success": true,
"RequestId": "AAC30B35-820D-5F3E-A42C-E96BB6379325"
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2024-12-11 | API 内部配置变更,不影响调用 | 查看变更详情 |
2024-10-14 | OpenAPI 入参发生变更 | 查看变更详情 |