0
点赞
收藏
分享

微信扫一扫

【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参数说明](https://tcaplusdb.tencent.com/UserGuide/06TcaplusDB Webservice API/04表操作/06重建表/59申请重建表[TableRebuild].html#getParamDesc)

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

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

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

举报

相关推荐

0 条评论