【TcaplusDB知識庫】如何生成資料匯入的事務
阿新 • • 發佈:2022-04-12
請求地址
POST
http://OmsAddress/app/newoms.php/webservice/oamp/table-data/import?cmd=10013&ip-type=webservicerest&access-token=AccessTokenVal
POST請求引數說明
引數名稱 | 資料型別 | 說明 | 是否必填欄位 | 備註 |
---|---|---|---|---|
set_id | 整型 | 事務所在的叢集的id | 是 | |
tableKeysList | 陣列 | 匯入資料的表 | 是 | |
importSpeed | 整型 | 資料匯入的速度,返回: (0, 50000] | 是 | |
RollBackType |
整型 | 資料匯入型別 0:全量匯入 1:部分回檔 | 是 | |
DataType | 整型 | 資料來源型別0:關聯事務ID1:手動輸入機器 | 是 | |
RelateTransId | 整型 | DataType = 0時,關聯的事務的ID | DataType = 0,必填 | |
ipList | 字串 | DataType = 1時,資料的機器上的路徑,格式為:ip username password rollback_dir,並且帳號密碼中不能含有(\ | ; - 空格),多個用換行分開如:1.1.1.1 tcaplus tcaplus /data/rollback_dir | DataType = 1,必填 |
Data引數
使用json格式表示記錄相關資訊,示例如下:
{
"setId": 126,
"tableKeysList": [
{
"AppID": 2,
"ZoneID": 1,
"TableName": "type_right_4"
}
],
"ipList": "1.1.1.1 tcaplus tcaplus /data/rollback_dir",
"importSpeed": 2000,
"RollBackType": 0,
"DataType": 1
}
返回語法
返回引數說明
-
返回狀態碼不為200時,表示稽核失敗,返回資料為執行事務失敗的資訊
-
返回狀態碼為200,表示事務成功,返回的資料結構如下:
欄位名稱 | 資料型別 | 說明 | 備註 |
---|---|---|---|
trans_id | 整型 | 執行的對應的事務的id | |
set_id | 整型 | 事務所在的叢集 |
請求示例
通過 curl 方法發起請求
命令中的紅色部分是需要使用者自行填寫的引數,請參閱
curl -H "Content-type: application/json" -X "POST" -d '{ "setId": 126, "tableKeysList": [ { "AppID": 2, "ZoneID": 1, "TableName": "type_right_4" } ], "ipList": "1.1.1.1 tcaplus tcaplus /data/rollback_dir", "importSpeed": 2000, "RollBackType": 0, "DataType": 1 }' http://omsaddress/app/newoms.php/webservice/oamp/table-data/import?cmd=10013&ip-type=webservicerest&access-token=<access-token>
返回示例
成功返回示例
http請求的Status=200
{
"SetId": "126",
"TransId": 108,
"username": "username"
}
錯誤返回
http請求的Status!=200
{
"name": "Unauthorized",
"message": "You are requesting with an invalid credential.",
"code": 0,
"status": 401,
"type": "yii\\web UnauthorizedHttpException"
}
{
"Error": [
"can not find app_id(2),zone_id(3),table_name(add_table19)"
]
}