触发 Compaction
Request
POST /api/compaction/run?tablet_id={int}&compact_type={enum}
POST /api/compaction/run?table_id={int}&compact_type=full
注意,table_id=xxx 只有在 compact_type=full 时指定才会生效。
GET /api/compaction/run_status?tablet_id={int}
Description
用于手动触发 Compaction 以及状态查询。
Query parameters
tablet_id
- tablet 的 id
table_id
- table 的 id。注意,table_id=xxx 只有在 compact_type=full 时指定才会生效,并且 tablet_id 和 table_id 只能指定一个,不能够同时指定,指定 table_id 后会自动对此 table 下所有 tablet 执行 full_compaction。
compact_type
- 取值为
base
或cumulative
或full
。full_compaction 的使用场景请参考数据恢复。
- 取值为
Request body
无
Response
触发 Compaction
若 tablet 不存在,返回 JSON 格式的错误:
{
"status": "Fail",
"msg": "Tablet not found"
}
若 compaction 执行任务触发失败时,返回 JSON 格式的错误:
{
"status": "Fail",
"msg": "fail to execute compaction, error = -2000"
}
若 compaction 执行触发成功时,则返回 JSON 格式的结果:
{
"status": "Success",
"msg": "compaction task is successfully triggered."
}
结果说明:
status:触发任务状态,当成功触发时为 Success;当因某些原因(比如,没有获取到合适的版本)时,返回 Fail。
msg:给出具体的成功或失败的信息。
查询状态
若 tablet 不存在,返回 JSON 格式:
{
"status": "Fail",
"msg": "Tablet not found"
}
若 tablet 存在并且 tablet 不在正在执行 compaction,返回 JSON 格式:
{
"status" : "Success",
"run_status" : false,
"msg" : "this tablet_id is not running",
"tablet_id" : 11308,
"schema_hash" : 700967178,
"compact_type" : ""
}
若 tablet 存在并且 tablet 正在执行 compaction,返回 JSON 格式:
{
"status" : "Success",
"run_status" : true,
"msg" : "this tablet_id is running",
"tablet_id" : 11308,
"schema_hash" : 700967178,
"compact_type" : "cumulative"
}
结果说明:
- run_status:获取当前手动 compaction 任务执行状态
Examples
curl -X POST "http://127.0.0.1:8040/api/compaction/run?tablet_id=10015&compact_type=cumulative"