其他分享
首页 > 其他分享> > 【TcaplusDB知识库】表操作—如何申请重建表

【TcaplusDB知识库】表操作—如何申请重建表

作者:互联网

【TcaplusDB知识库】表操作—如何申请重建表

请求地址

POST
http://OmsAddress/app/newoms.php/webservice/business/table/rebuild?cmd=10023&ip-type=webservicerest&access-token=AccessTokenVal

POST请求参数说明

参数名称数据类型说明是否必填字段备注
app_id 整型 重建的表所在的业务id  
zone_id 整型 重建的表所在的游戏区id  
table_name 字符串 重建的表的表名  
attach_id 数组 定义修改后的表结构的文件的id列表,利用接口“3.4.1. 上传定义表结构的xml/tdr文件”获取    
auto_approve 整型(0或1) 是否自动审核重建表申请(表所在集群允许自动审核表删除申请) 否,默认不自动审核  
auto_exec_trans 整型(0或1) 是否执行自动审核重建表申请后,生成重建表事务(表所在的集群允许自动执行删除表事务,auto_approve=1时,auto_exec_trans=1才有效) 否,默认不自动执行  
attention_man 字符串 用分号“;”分隔关注人,字段最大长度为200  

Data参数

使用json格式表示记录相关信息,示例如下:

示例1

{
  "app_id": 2,
  "zone_id": 3,
  "table_name": "test_table_generic_modify",
  "auto_approve": 0,
  "auto_exec_trans": 0
}

示例2

{
  "app_id": 2,
  "zone_id": 3,
  "table_name": "test_table_generic_modify",
  "auto_approve": 1,
  "auto_exec_trans": 1
}

返回语法

返回参数说明

参数名称数据类型说明备注
apply json ret:表示是否申请成功,0表示成功;其他表示失败msg:表示ret不等于0时的错误信息info:申请成功的删除表单据,其中uid表示单据id,审核时需要  
check json ret:表示是否审核成功,0表示成功;其他表示失败msg:表示ret不等于0时的错误信息info:其中trans_id表示生成的删除表的事务,set_id表示事务所在的集群(表所在的集群)  
exec Json ret:表示是否执行成功,0表示成功;其他表示失败msg:表示ret不等于0时的错误信息  

请求示例

通过 curl 方法发起请求

命令中的红色部分是需要用户自行填写的参数,请参阅url中GET参数说明

curl -H "Content-type: application/json" -X "POST" -d '{ "app_id": 2, "zone_id": 3, "table_name": "test_table_generic_modify", "auto_approve": 0, "auto_exec_trans": 0 }' http://omsaddress/app/newoms.php/webservice/business/table/rebuild?cmd=10023&ip-type=webservicerest&access-token=<access-token>

返回示例

成功返回示例

http请求的Status=200

示例1

{
  "apply": {
      "ret": 0,
      "info": {
          "app_id": 2,
          "app_name": "tdr_app",
          "set_id": 1,
          "zone_list": "4",
          "table_name": "table_list_name_diff",
          "table_type": 0,
          "estimated_write_load": 1,
          "estimated_read_load": 1,
          "type": "xml",
          "table_maxnum": 0,
          "write_time": "2021-03-16 22:06:11",
          "apply_type": 4,
          "key_avarage_record_size": 1,
          "value_avarage_record_size": 1,
          "compress": 1,
          "active_record_num": "1",
          "total_record_num": "1",
          "memo": "",
          "tdr": "3",
          "pcu": 0,
          "engine_parameters": "bnum=7500000#xmsiz=200000000#xikmsiz=80000000#kmapow=6#kfapow=6#vmapow=6#vfapow=6#lnum=2",
          "relationship_chain_interval": 0,
          "relationship_chain_count": 0,
          "index_count": 0,
          "read_index_interval": 0,
          "read_index_count": 0,
          "read_interval": 0,
          "write_interval": 0,
          "calc_resource_type": 1,
          "data_protocol_type": "TBD",
          "user": "username",
          "job_id": "7",
          "attention_man": "",
          "sort_rule": 0,
          "sort_field_num": 0,
          "dm_ratio": 5,
          "id": 245
      },
      "msg": ""
  }
}

示例2

{
  "apply": {
      "ret": 0,
      "info": {
          "app_id": 2,
          "app_name": "tdr_app",
          "set_id": 1,
          "zone_list": "4",
          "table_name": "table_list_name_diff",
          "table_type": 0,
          "estimated_write_load": 1,
          "estimated_read_load": 1,
          "type": "xml",
          "table_maxnum": 0,
          "write_time": "2021-03-16 22:07:28",
          "apply_type": 4,
          "key_avarage_record_size": 1,
          "value_avarage_record_size": 1,
          "compress": 1,
          "active_record_num": "1",
          "total_record_num": "1",
          "memo": "",
          "tdr": "3",
          "pcu": 0,
          "engine_parameters": "bnum=7500000#xmsiz=200000000#xikmsiz=80000000#kmapow=6#kfapow=6#vmapow=6#vfapow=6#lnum=2",
          "relationship_chain_interval": 0,
          "relationship_chain_count": 0,
          "index_count": 0,
          "read_index_interval": 0,
          "read_index_count": 0,
          "read_interval": 0,
          "write_interval": 0,
          "calc_resource_type": 1,
          "data_protocol_type": "TBD",
          "user": "username",
          "job_id": "7",
          "attention_man": "",
          "sort_rule": 0,
          "sort_field_num": 0,
          "dm_ratio": 5,
          "id": 246
      },
      "msg": ""
  },
  "check": {
      "ret": 0,
      "info": {
          "set_id": 1,
          "trans_id": 238
      },
      "msg": ""
  },
  "exec": {
      "ret": 0,
      "info": {
          "set_id": 1,
          "trans_id": 238,
          "user_name": "username"
      },
      "msg": ""
  }
}

错误返回

http请求的Status!=200

{
  "name": "Unauthorized",
  "message": "You are requesting with an invalid credential.",
  "code": 0,
  "status": 401,
  "type": "yii\\web UnauthorizedHttpException"
}
{
  "apply": {
      "ret": -1,
      "info": null,
      "msg": "table_name:ip(10.28.2.18) not in whitelist for applying to rebuild table(cmd:10023) of app_id:2 zone_id:4 table_name:table_list_name_diff"
  }
}

 


 

img

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

标签:知识库,name,app,TcaplusDB,ret,table,type,id,重建
来源: https://www.cnblogs.com/shujurener/p/16034534.html