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

2022-03-21 14:35:45 阅读：166 来源： 互联网

标签：知识库 name app TcaplusDB ret table type id 重建

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

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

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

本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；
2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；
3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；
4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；
5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

ICode9

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

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

Data参数

返回语法

返回参数说明

请求示例

通过 curl 方法发起请求

返回示例

成功返回示例

错误返回