Updates a new-version synchronization task. The following type of task is supported: real-time synchronization of all data in a MySQL database to Hologres.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
DIJobId | long | No | The ID of the synchronization task. | 11588 |
Description | string | No | The description of the synchronization task. | |
ResourceSettings | object | No | The resource settings. | |
OfflineResourceSettings | object | No | The resource used for batch synchronization. | |
ResourceGroupIdentifier | string | No | The identifier of the resource group for Data Integration used for batch synchronization. | S_res_group_111_222 |
RealtimeResourceSettings | object | No | The resource used for real-time synchronization. | |
ResourceGroupIdentifier | string | No | The identifier of the resource group for Data Integration used for real-time synchronization. | S_res_group_111_222 |
TransformationRules | array<object> | No | The list of transformation rules for objects involved in the synchronization task. Each entry in the list defines a transformation rule. | |
object | No | |||
RuleName | string | No | The name of the rule. If the values of the RuleActionType parameter and the RuleTargetType parameter are the same for multiple transformation rules, you must make sure that the transformation rule names are unique. | rename_rule_1 |
RuleActionType | string | No | The type of the action. Valid values:
| Rename |
RuleTargetType | string | No | The type of the object on which you want to perform the action. Valid values:
Enumeration Value:
| Table |
RuleExpression | string | No | The expression of the rule. The expression is a JSON string. Example of a renaming rule: {"expression":"${srcDatasourceName}_${srcDatabaseName}_0922","variables":[{"variableName":"srcDatabaseName","variableRules":[{"from":"fromdb","to":"todb"}]}]}. expression: the expression of the renaming rule. The expression may contain the following variables: ${srcDatasourceName}, ${srcDatabaseName}, and ${srcTableName}. ${srcDatasourceName} indicates the name of the source. ${srcDatabaseName} indicates the name of a source database. ${srcTableName} indicates the name of a source table. variables: the generation rule for a variable used in the expression of the renaming rule. The default value of the specified variable is the original value of the object indicated by the variable. You can define a group of string replacement rules to change the original values based on your business requirements. variableName: the name of the variable. The variable name is not enclosed in ${}. variableRules: the string replacement rules for variables. The system runs the string replacement rules in sequence for string replacement. from indicates the original string. to indicates the new string. Example of a rule used to add a specific field to the destination and assign a value to the field: {"columns":[{"columnName":"my_add_column","columnValueType":"Constant","columnValue":"123"}]}. If no rule of this type is configured, no fields are added to the destination and no values are assigned by default. columnName: the name of the field that is added. columnValueType: the value type of the field. Valid values: Constant and Variable. columnValue: the value of the field that is added. If the valueType parameter is set to Constant, the value of the columnValue parameter must be a constant of the STRING type. If the valueType parameter is set to Variable, the value of the columnValue parameter must be a built-in variable. The following built-in variables are supported: EXECUTE_TIME (LONG data type), DB_NAME_SRC (STRING data type), DATASOURCE_NAME_SRC (STRING data type), TABLE_NAME_SRC (STRING data type), DB_NAME_DEST (STRING data type), DATASOURCE_NAME_DEST (STRING data type), TABLE_NAME_DEST (STRING data type), and DB_NAME_SRC_TRANSED (STRING data type). EXECUTE_TIME indicates the execution time. DB_NAME_SRC indicates the name of a source database. DATASOURCE_NAME_SRC indicates the name of the source. TABLE_NAME_SRC indicates the name of a source table. DB_NAME_DEST indicates the name of a destination database. DATASOURCE_NAME_DEST indicates the name of the destination. TABLE_NAME_DEST indicates the name of a destination table. DB_NAME_SRC_TRANSED indicates the database name obtained after a transformation. Example of a rule used to specify primary key fields for a destination table: {"columns":["ukcolumn1","ukcolumn2"]}. If no rule of this type is configured, the primary key fields in the mapped source table are used for the destination table by default. If the destination table is an existing table, Data Integration does not modify the schema of the destination table. If the specified primary key fields do not exist in the destination table, an error is reported when the synchronization task starts to run. If the destination table is automatically created by the system, Data Integration automatically creates the schema of the destination table. The schema contains the primary key fields that you specify. If the specified primary key fields do not exist in the destination table, an error is reported when the synchronization task starts to run. Example of a rule used to process DML messages: {"dmlPolicies":[{"dmlType":"Delete","dmlAction":"Filter","filterCondition":"id > 1"}]}. If no rule of this type is configured, the default processing policy for messages generated for insert, update, and delete operations is Normal. dmlType: the DML operation. Valid values: Insert, Update, and Delete. dmlAction: the processing policy for DML messages. Valid values: Normal, Ignore, Filter, and LogicalDelete. Filter indicates conditional processing. You can set the dmlAction parameter to Filter only when the dmlType parameter is set to Update or Delete. filterCondition: the condition used to filter DML messages. This parameter is required only when the dmlAction parameter is set to Filter. | {"expression":"${srcDatasoureName}_${srcDatabaseName}"} |
TableMappings | array<object> | No | The list of mappings between rules used to select synchronization objects in the source and transformation rules applied to the selected synchronization objects. Each entry in the list displays a mapping between a rule used to select synchronization objects and a transformation rule applied to the selected synchronization objects. | |
object | No | |||
SourceObjectSelectionRules | array<object> | No | The rule used to select synchronization objects in the source. You can configure multiple rules. | |
object | No | |||
ObjectType | string | No | The type of the object. Valid values:
| Table |
Expression | string | No | The expression. | mysql_table_1 |
TransformationRules | array<object> | No | The transformation rules that are applied to the selected synchronization objects. | |
object | No | |||
RuleName | string | No | The name of the rule. If the values of the RuleActionType parameter and the RuleTargetType parameter are the same for multiple transformation rules, you must make sure that the transformation rule names are unique. | rename_rule_1 |
RuleActionType | string | No | The type of the action. Valid values:
| Rename |
RuleTargetType | string | No | The type of the object on which you want to perform the action. Valid values:
Enumeration Value:
| Table |
JobSettings | object | No | The settings for the dimension of the synchronization task. The settings include processing policies for DDL messages, policies for data type mappings between source fields and destination fields, and runtime parameters of the synchronization task. | |
DdlHandlingSettings | array<object> | No | The settings for processing DDL messages. The value of this parameter must be an array. | |
object | No | |||
Type | string | No | The type of the DDL operation. Valid values:
| AddColumn |
Action | string | No | The processing policy for DDL messages. Valid values:
| Critical |
ColumnDataTypeSettings | array<object> | No | The settings for data type mappings between source fields and destination fields. The value of this parameter must be an array. | |
object | No | |||
SourceDataType | string | No | The data type of a source field. | bigint |
DestinationDataType | string | No | The data type of a destination field. | text |
RuntimeSettings | array<object> | No | The runtime settings. The value of this parameter must be an array. | |
object | No | |||
Name | string | No | The name of the configuration item. Valid values:
| runtime.offline.concurrent |
Value | string | No | The value of the configuration item. | 1 |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "AAC30B35-820D-5F3E-A42C-E96BB6379325"
}
Error codes
HTTP status code | Error code | Error message |
---|---|---|
429 | Throttling.Api | The request for this resource has exceeded your available limit. |
429 | Throttling.System | The DataWorks system is busy. Try again later. |
429 | Throttling.User | Your request is too frequent. Try again later. |
500 | InternalError.System | An internal system error occurred. Try again later. |
500 | InternalError.UserId.Missing | An internal system error occurred. Try again later. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2024-06-04 | The Error code has changed | View Change Details |
2024-01-18 | The Error code has changed | View Change Details |