【TcaplusDB知识库】如何生成数据导入的事务
请求地址
POST
http://OmsAddress/app/newoms.php/webservice/oamp/table-data/import?cmd=10013&ip-type=webservicerest&access-token=AccessTokenVal
POST请求参数说明
| 参数名称 | 数据类型 | 说明 | 是否必填字段 | 备注 |
|---|---|---|---|---|
| set_id | 整型 | 事务所在的集群的id | 是 | |
| tableKeysList | 数组 | 导入数据的表 | 是 | |
| importSpeed | 整型 | 数据导入的速度，返回: (0, 50000] | 是 | |
| RollBackType | 整型 | 数据导入类型 0:全量导入 1:部分回档 | 是 | |
| DataType | 整型 | 数据来源类型0:关联事务ID1:手动输入机器 | 是 | |
| RelateTransId | 整型 | DataType = 0时，关联的事务的ID | DataType = 0，必填 | |
| ipList | 字符串 | DataType = 1时，数据的机器上的路径，格式为：ip username password rollback_dir，并且帐号密码中不能含有（\ | ; - 空格），多个用换行分开如：1.1.1.1 tcaplus tcaplus /data/rollback_dir | DataType = 1，必填 |
Data参数
使用json格式表示记录相关信息，示例如下：
{
"setId": 126,
"tableKeysList": [
{
"AppID": 2,
"ZoneID": 1,
"TableName": "type_right_4"
}
],
"ipList": "1.1.1.1 tcaplus tcaplus /data/rollback_dir",
"importSpeed": 2000,
"RollBackType": 0,
"DataType": 1
}
返回语法
返回参数说明
-
返回状态码不为200时，表示审核失败，返回数据为执行事务失败的信息
-
返回状态码为200，表示事务成功，返回的数据结构如下：
| 字段名称 | 数据类型 | 说明 | 备注 |
|---|---|---|---|
| trans_id | 整型 | 执行的对应的事务的id | |
| set_id | 整型 | 事务所在的集群 |
请求示例
通过 curl 方法发起请求
命令中的红色部分是需要用户自行填写的参数，请参阅
curl -H "Content-type: application/json" -X "POST" -d '{ "setId": 126, "tableKeysList": [ { "AppID": 2, "ZoneID": 1, "TableName": "type_right_4" } ], "ipList": "1.1.1.1 tcaplus tcaplus /data/rollback_dir", "importSpeed": 2000, "RollBackType": 0, "DataType": 1 }' http://omsaddress/app/newoms.php/webservice/oamp/table-data/import?cmd=10013&ip-type=webservicerest&access-token=
返回示例
成功返回示例
http请求的Status=200
{
"SetId": "126",
"TransId": 108,
"username": "username"
}
错误返回
http请求的Status!=200
{
"name": "Unauthorized",
"message": "You are requesting with an invalid credential.",
"code": 0,
"status": 401,
"type": "yii\\web UnauthorizedHttpException"
}
{
"Error": [
"can not find app_id(2),zone_id(3),table_name(add_table19)"
]
}
