【TcaplusDB知識庫】如何生成表資料構造的事務
每次允許構造一個zone的表的資料。
請求地址
POST
http://OmsAddress/app/newoms.php/webservice/oamp/table-data/make?cmd=10011&ip-type=webservicerest&access-token=AccessTokenVal
POST請求引數說明
引數名稱 | 資料型別 | 說明 | 是否必填欄位 | 備註 | |
---|---|---|---|---|---|
set_id | 整型 | 事務所在的叢集的id | 是 | ||
tableInfoList | 陣列 | 構造資料的表,只允許構造一個zone下資料 | 是 | ||
ipList |
字串 | 資料的機器上的路徑,格式為:ip username password,並且帳號密碼中不能含有(\ | ; - 空格),多個用換行分開如:1.1.1.1 tcaplus tcaplus | 是 | |
backType | 整型 | 資料構造型別,1:冷備時間構造,2:精確時間構造 | 是 | ||
engineBackupDate | 字串 | 冷備構造資料日期,格式:xxxx-xx-xx,如2018-03-07 | backType=1時,必填 | ||
uLogBackupTime | 字串 | Ulog構造資料時間點,格式:xxxx-xx-xx xx:xx:xx如2018-03-05 16:00:04 | backType=2時,必填 | ||
maxConcurrentActionNum | 整型 | 事務並行度,範圍: [1, 50],預設值:10 | 否 |
Data引數
使用json格式表示記錄相關資訊,示例如下:
{
"setId": 126,
"tableInfoList": {
"2-3-add_table1": {
"AppID": 2,
"ZoneID": 3,
"TableName": "add_table1",
"ShardNun": 1,
"ShardList": [
1
]
},
"2-3-add_table2": {
"AppID": 2,
"ZoneID": 3,
"TableName": "add_table2",
"ShardNum": 1,
"ShardList": [
6
]
} //表的shard全部構造的時候,ShardList = ["All"]
},
"ipList":"1.1.1.1 tcaplus tcaplus",
"engineBackupDate":"2018-03-07",
"backType":1,"maxConcurrentActionNum":10
}
//注:tableInfoList中的key格式為:{app_id}-{zone_id}-{table_name}
返回語法
返回引數說明
-
返回狀態碼不為200時,表示失敗,返回資料為構造表資料失敗的資訊
-
返回狀態碼為200,表示表資料構造建立成功,返回的資料結構如下:
欄位名稱 | 資料型別 | 說明 | 備註 |
---|---|---|---|
trans_id | 整型 | 執行的對應的事務的id | |
set_id | 整型 | 事務所在的叢集 |
請求示例
通過 curl 方法發起請求
命令中的紅色部分是需要使用者自行填寫的引數,請參閱
curl -H "Content-type: application/json" -X "POST" -d '{ "setId": 126, "tableInfoList": { "2-3-add_table1": { "AppID": 2, "ZoneID": 3, "TableName": "add_table1", "ShardNun": 1, "ShardList": [ 1 ] }, "2-3-add_table2": { "AppID": 2, "ZoneID": 3, "TableName": "add_table2", "ShardNum": 1, "ShardList": [ 6 ] } //表的shard全部構造的時候,ShardList = ["All"] }, "ipList":"1.1.1.1 tcaplus tcaplus", "engineBackupDate":"2018-03-07", "backType":1,"maxConcurrentActionNum":10 } //注:tableInfoList中的key格式為:{app_id}-{zone_id}-{table_name}' http://omsaddress/app/newoms.php/webservice/oamp/table-data/make?cmd=10011&ip-type=webservicerest&access-token=<access-token>
返回示例
成功返回示例
http請求的Status=200