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

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

2022-03-21 14:35:45 作者：互联网

【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