dm: refine openapi table migrate rule source/target (#11933)

close #4287

Author: JQWong7

dm/config/task_converters.go

@@ -610,21 +610,14 @@ func SubTaskConfigsToOpenAPITask(subTaskConfigList []*SubTaskConfig) *openapi.Ta
 	ruleMap := map[string]struct{}{}
 	appendOneRule := func(sourceName, schemaPattern, tablePattern, targetSchema, targetTable string) {
 		tableMigrateRule := openapi.TaskTableMigrateRule{
-			Source: struct {
-				Schema     string `json:"schema"`
-				SourceName string `json:"source_name"`
-				Table      string `json:"table"`
-			}{
+			Source: openapi.TaskTableMigrateRuleSource{
 				Schema:     schemaPattern,
 				SourceName: sourceName,
 				Table:      tablePattern,
 			},
 		}
 		if targetSchema != "" {
-			tableMigrateRule.Target = &struct {
-				Schema *string `json:"schema,omitempty"`
-				Table  *string `json:"table,omitempty"`
-			}{
+			tableMigrateRule.Target = &openapi.TaskTableMigrateRuleTarget{
 				Schema: &targetSchema,
 			}
 			if targetTable != "" {

dm/config/task_converters_test.go

@@ -459,18 +459,11 @@ func TestConvertBetweenOpenAPITaskAndTaskConfig(t *testing.T) {
 		sourceSchema := task.TableMigrateRule[0].Source.Schema
 		targetSchema := *task.TableMigrateRule[0].Target.Schema
 		// only route schema
-		task.TableMigrateRule[0].Source = struct {
-			Schema     string `json:"schema"`
-			SourceName string `json:"source_name"`
-			Table      string `json:"table"`
-		}{
+		task.TableMigrateRule[0].Source = openapi.TaskTableMigrateRuleSource{
 			SourceName: source1Name,
 			Schema:     sourceSchema,
 		}
-		task.TableMigrateRule[0].Target = &struct {
-			Schema *string `json:"schema,omitempty"`
-			Table  *string `json:"table,omitempty"`
-		}{
+		task.TableMigrateRule[0].Target = &openapi.TaskTableMigrateRuleTarget{
 			Schema: &targetSchema,
 		}
 		taskCfg, err = OpenAPITaskToTaskConfig(&task, sourceCfgMap)
@@ -504,38 +497,24 @@ func TestConvertBetweenOpenAPITaskAndTaskConfig(t *testing.T) {
 		// only route table will meet error
 		sourceTable := "tb"
 		targetTable := "tb1"
-		task.TableMigrateRule[0].Source = struct {
-			Schema     string `json:"schema"`
-			SourceName string `json:"source_name"`
-			Table      string `json:"table"`
-		}{
+		task.TableMigrateRule[0].Source = openapi.TaskTableMigrateRuleSource{
 			SourceName: source1Name,
 			Schema:     sourceSchema,
 			Table:      sourceTable,
 		}
-		task.TableMigrateRule[0].Target = &struct {
-			Schema *string `json:"schema,omitempty"`
-			Table  *string `json:"table,omitempty"`
-		}{
+		task.TableMigrateRule[0].Target = &openapi.TaskTableMigrateRuleTarget{
 			Table: &targetTable,
 		}
 		_, err = OpenAPITaskToTaskConfig(&task, sourceCfgMap)
 		require.True(t, terror.ErrConfigGenTableRouter.Equal(err))
 
 		// route both
-		task.TableMigrateRule[0].Source = struct {
-			Schema     string `json:"schema"`
-			SourceName string `json:"source_name"`
-			Table      string `json:"table"`
-		}{
+		task.TableMigrateRule[0].Source = openapi.TaskTableMigrateRuleSource{
 			SourceName: source1Name,
 			Schema:     sourceSchema,
 			Table:      sourceTable,
 		}
-		task.TableMigrateRule[0].Target = &struct {
-			Schema *string `json:"schema,omitempty"`
-			Table  *string `json:"table,omitempty"`
-		}{
+		task.TableMigrateRule[0].Target = &openapi.TaskTableMigrateRuleTarget{
 			Schema: &targetSchema,
 			Table:  &targetTable,
 		}
@@ -578,11 +557,7 @@ func TestConvertBetweenOpenAPITaskAndTaskConfig(t *testing.T) {
 		require.EqualValues(t, taskAfterConvert, &task)
 
 		// no route and sync one schema
-		task.TableMigrateRule[0].Source = struct {
-			Schema     string `json:"schema"`
-			SourceName string `json:"source_name"`
-			Table      string `json:"table"`
-		}{
+		task.TableMigrateRule[0].Source = openapi.TaskTableMigrateRuleSource{
 			SourceName: source1Name,
 			Schema:     sourceSchema,
 			Table:      "",

dm/openapi/gen.server.go

@@ -1412,6 +1412,37 @@ components:
         - "user"
         - "enable_gtid"
         - "enable"
+    TaskTableMigrateRuleSource:
+      description: source-related configuration
+      properties:
+        source_name:
+          type: string
+          description: source name
+          example: "source-name"
+        schema:
+          type: string
+          description: schema name, wildcard support
+          example: "db-*"
+        table:
+          type: string
+          description: table name, wildcard support
+          example: "tb-*"
+      required:
+        - "source_name"
+        - "schema"
+        - "table"
+    TaskTableMigrateRuleTarget:
+      type: object
+      description: downstream-related configuration
+      properties:
+        schema:
+          type: string
+          description: schema name, does not support wildcards
+          example: "db1"
+        table:
+          type: string
+          description: table name, does not support wildcards
+          example: "tb1"        
     ShardingGroup:
       type: object
       properties:
@@ -1646,37 +1677,9 @@ components:
       description: "upstream table to downstream migrate rules"
       properties:
         source:
-          type: object
-          description: source-related configuration
-          properties:
-            source_name:
-              type: string
-              description: source name
-              example: "source-name"
-            schema:
-              type: string
-              description: schema name, wildcard support
-              example: "db-*"
-            table:
-              type: string
-              description: table name, wildcard support
-              example: "tb-*"
-          required:
-            - "source_name"
-            - "schema"
-            - "table"
+          $ref: "#/components/schemas/TaskTableMigrateRuleSource"
         target:
-          type: object
-          description: downstream-related configuration
-          properties:
-            schema:
-              type: string
-              description: schema name, does not support wildcards
-              example: "db1"
-            table:
-              type: string
-              description: table name, does not support wildcards
-              example: "tb1"
+          $ref: "#/components/schemas/TaskTableMigrateRuleTarget"
         binlog_filter_rule:
           type: array
           description: "filter rule name"