【TcaplusDB知识库】如何生成数据导入的事务


【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
}

返回语法

返回参数说明

  1. 返回状态码不为200时,表示审核失败,返回数据为执行事务失败的信息

  2. 返回状态码为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)"
  ]
}

img

TcaplusDB是腾讯出品的分布式NoSQL数据库,存储和调度的代码完全自研。具备缓存+落地融合架构、PB级存储、毫秒级时延、无损水平扩展和复杂数据结构等特性。同时具备丰富的生态、便捷的迁移、极低的运维成本和五个九高可用等特点。客户覆盖游戏、互联网、政务、金融、制造和物联网等领域。

原创文章,作者:kepupublish,如若转载,请注明出处:https://blog.ytso.com/245677.html

(0)
上一篇 2022年4月18日
下一篇 2022年4月18日

相关推荐

发表回复

登录后才能评论