【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