【TcaplusDB知識庫】表操作—如何檢查表結構是否發生改變
阿新 • • 發佈：2022-03-15
請求地址
POST
http://OmsAddress/app/newoms.php/webservice/business/table/truncating?cmd=10004&ip-type=webservicerest&access-token=AccessTokenVal
POST請求引數說明
| 引數名稱 | 資料型別 | 說明 | 是否必填欄位 | 備註 |
|---|---|---|---|---|
| app_id | 整型 | 清理表所在的業務id | 是 | |
| zone_id | 整型 | 清理表所在的遊戲區id | 是 | |
| table_name | 字串、字串陣列 | 清理表的表名，多個表時，可使用陣列傳遞表名稱，陣列中的資料項為表名稱 |
是 | |
| auto_approve | 整型（0或1） | 是否自動稽核清理表（表所在叢集允許自動稽核表清理申請） | 否，預設不自動稽核 | |
| auto_exec_trans | 整型（0或1） | 是否執行自動稽核清理表申請後，生成清理表事務（表所在的叢集允許自動執行清理表事務，auto_approve=1時，auto_exec_trans=1才有效） | 否，預設不自動執行 | |
| attention_man | 字串 | 用分號";"分隔關注人，欄位最大長度為200 | 否 |
Data引數
使用json格式表示記錄相關資訊，示例如下：
{
"app_id": 2,
"zone_id": 3,
"table_name": "test_table_generic_modify",
"auto_approve": 1,
"auto_exec_trans": "",
}
返回語法
返回引數說明
| 引數名稱 | 資料型別 | 說明 | 備註 |
|---|---|---|---|
| apply | json | ret：表示是否申請成功，0表示成功；其他表示失敗 msg：表示ret不等於0時的錯誤資訊 info：申請成功的清理表單據，其中uid表示單據id，稽核清理表申請時需要此值 | |
| check | json | ret：表示是否稽核成功，0表示成功；其他表示失敗 msg：表示ret不等於0時的錯誤資訊 info：其中trans_id表示生成的清理表的事務，set_id表示事務所在的叢集（表所在的叢集） |
請求示例
通過 curl 方法發起請求
命令中的紅色部分是需要使用者自行填寫的引數，請參閱
curl -H "Content-type: application/json" -X "POST" -d '{ "app_id": 2, "zone_id": 3, "table_name": "test_table_generic_modify", "auto_approve": 1, "auto_exec_trans": "" }' http://omsaddress/app/newoms.php/webservice/business/table/truncating?cmd=10004&ip-type=webservicerest&access-token=<access-token>
返回示例
成功返回示例
http請求的Status=200
{
"apply": {
"ret": 0,
"msg": "success to apply truncate table",
"info": {
"app_id": 2,
"app_name": "t_app",
"set_id": 126,
"zone_list": "3",
"table_name": "test_table_generic_modify",
"table_type": 0,
"estimated_write_load": 0,
"estimated_read_load": 0,
"type": "xml",
"table_maxnum": 0,
"write_time": "2017-03-02 21:52:25",
"apply_type": 2,
"key_avarage_record_size": 1,
"value_avarage_record_size": 1,
"compress": 0,
"active_record_num": "0",
"total_record_num": "3",
"memo": "",
"tdr": "-1",
"pcu": 1,
"relationship_chain_interval": 60,
"relationship_chain_count": 1,
"index_count": 1,
"read_index_interval": 60,
"read_index_count": 1,
"read_interval": 60,
"write_interval": 60,
"calc_resource_type": 2,
"dm_ratio": 5,
"user": "tcaplus",
"job_id": "42",
"id": 112,
"task_id": 407,
"trans_id": 407,
"execute_user": "tcaplus",
"execute_status": 1,
"audit_memo": ""
},
"find_dba": {
"need_find_dba": 0,
"dba_name": "eteet"
}
},
"check": {
"ret": 0,
"msg": "",
"info": {
"set_id": 126,
"trans_id": 407
}
}
}
錯誤返回
http請求的Status!=200
{
"name": "Unauthorized",
"message": "You are requesting with an invalid credential.",
"code": 0,
"status": 401,
"type": "yii\\web UnauthorizedHttpException"
}
{
"apply": {
"ret": -1,
"msg": "table_name:已經申請其他表操作 app:2 zone:3 table_name:test_table_generic_modify apply id:113 apply type:2 error type:1",
"info": null
}
}