【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 方法发起请求
命令中的红色部分是需要用户自行填写的参数，请参阅url中GET参数说明
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=<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)"
]
}
TcaplusDB是腾讯出品的分布式NoSQL数据库，存储和调度的代码完全自研。具备缓存+落地融合架构、PB级存储、毫秒级时延、无损水平扩展和复杂数据结构等特性。同时具备丰富的生态、便捷的迁移、极低的运维成本和五个九高可用等特点。客户覆盖游戏、互联网、政务、金融、制造和物联网等领域。
原创文章，作者：kepupublish，如若转载，请注明出处：https://blog.ytso.com/245677.html