请求地址

/v2/webservice/table-data/make

请求方法

Post

请求参数说明

参数名称	类型	是否必填	说明
tableInfoList	TableInfo数组	是
set_id	number	是
uLogBackupTime	string	是	构造时间点
ipList	array	是	在指定机器上构造数据。（当useSlaveMachine为1时或者useSlaveOnlineData为1时，可以为空数组）
autoDeleteData	number	否	默认传0
maxConcurrentActionNum	number	是	事务并行度
ignoreSvrVerion	number	否	是否忽略svr版本，默认传1，忽略，传0表示不忽略
useSlaveOnlineData	number	是	0表示冷备构造，1表示热备构造
useSlaveMachine	number	是	在Slave机器上构造数据，1代表“是”，0代表“否”
isDeletedTable	number	是	是否为已删除表，1表示“是”，0表示“否”
deleteTableLastBackupTime	string	是	删表前该表最后一次备份时间，默认为""

TableInfo

参数名称	类型	是否必填	说明
app_id	number	是
zone_id	number	是
table_name	string	是
ShardNum	number	是	shard数量，如果是选中表的全部shard，则填0。
ShardList	array	是	shard_id数组，如果是选中表的全部shard，则填空数组

示例

{
    "set_id": 1,
    "tableInfoList": [
        {
            "app_id": 2,
            "zone_id": 5,
            "table_name": "mails",
            "ShardNum": 0,
            "ShardList": []
        },
        {
            "app_id": 2,
            "zone_id": 5,
            "table_name": "users",
            "ShardNum": 0,
            "ShardList": []
        },
        {
            "app_id": 2,
            "zone_id": 4,
            "table_name": "chat_area_rank",
            "ShardNum": 0,
            "ShardList": []
        },
        {
            "app_id": 2,
            "zone_id": 4,
            "table_name": "common_info",
            "ShardNum": 0,
            "ShardList": []
        }
    ],
    "uLogBackupTime": "2024-12-01 10:31:11",
    "ipList": [
        "9.135.102.211 tcaplus OP0ZrrnR0#aY92miH /data/jinfzhao/test/other",
        "9.135.102.212 tcaplus OP0ZrrnR0#aY92miH /data/jinfzhao/test/other1"
    ],
    "maxConcurrentActionNum": 10,
    "ignoreSvrVerion": 0,
    "useSlaveOnlineData": 0,
    "useSlaveMachine": 0,
    "isDeletedTable": 0,
    "deleteTableLastBackupTime": ""
}

返回参数说明

data数组（如果请求参数的表数量超过2048个，则会被分成多组，每2048个表为一组，每一组一个任务ID）

参数名称	类型	说明
set_id	number
task_id	number	任务ID
tables	array	关联的表。

成功返回

{
    "code": 0,
    "request_id": "0ec25391-80ab-4116-a32a-3fbac3dd8267",
    "data": [
        {
            "set_id": 1,
            "task_id": 1374,
            "user": "tcaplus",
            "tables": [
                {
                    "app_id": 2,
                    "zone_id": 5,
                    "table_name": "mails",
                    "shard_num": 0,
                    "shard_list": []
                },
                {
                    "app_id": 2,
                    "zone_id": 5,
                    "table_name": "users",
                    "shard_num": 0,
                    "shard_list": []
                }
            ]
        }
    ]
}

失败返回

{
    "code": 0,
    "request_id": "b61445d7-d660-40f2-a836-92aed308d37f",
    "data": [
        {
            "task_id": 1375,
            "result": -1,
            "error_msg": "Failed to create transaction: -10000, err: invalid parameter. setAppID.size() > 1 || setZoneID.size() > 1 please check. ",
            "code": 110,
            "tables": [
                {
                    "app_id": 2,
                    "zone_id": 5,
                    "table_name": "mails",
                    "shard_num": 0,
                    "shard_list": []
                },
                {
                    "app_id": 2,
                    "zone_id": 5,
                    "table_name": "users",
                    "shard_num": 0,
                    "shard_list": []
                },
                {
                    "app_id": 2,
                    "zone_id": 4,
                    "table_name": "chat_area_rank",
                    "shard_num": 0,
                    "shard_list": []
                },
                {
                    "app_id": 2,
                    "zone_id": 4,
                    "table_name": "common_info",
                    "shard_num": 0,
                    "shard_list": []
                }
            ]
        }
    ]
}

规则说明

1.所有表必须在同一个项目中。

2.选择冷备构造（useSlaveOnlineData=0）时，ipList不能为空数组。

3.isDeletedTable=1时，deleteTableLastBackupTime不能为空字符串。

4.每张表选择的shard数量最大值是256。

5.ipList数组的元素，字符串格式必须是ip username password rollback_dir。

6.将ipList用";"拼成一段字符串，此字符串的长度不能超过10240。

表数据构造