Manually Trigger Compaction

Request

POST /api/compaction/run?tablet_id={int}&compact_type={enum} POST /api/compaction/run?table_id={int}&compact_type=full Note that table_id=xxx will take effect only when compact_type=full is specified. GET /api/compaction/run_status?tablet_id={int}

Description

Used to manually trigger the comparison and show status.

Query parameters

  • tablet_id

    • ID of the tablet

  • table_id

    • ID of table. Note that table_id=xxx will take effect only when compact_type=full is specified, and only one tablet_id and table_id can be specified, and cannot be specified at the same time. After specifying table_id, full_compaction will be automatically executed for all tablets under this table.

  • compact_type

    • The value is base or cumulative or full. For usage scenarios of full_compaction, please refer to Data Recovery.

Request body

None

Response

Trigger Compaction

If the tablet does not exist, an error in JSON format is returned:

  1. {
  2.     "status": "Fail",
  3.     "msg": "Tablet not found"
  4. }

If the tablet exists and the tablet is not running, JSON format is returned:

  1. {
  2.     "status": "Fail",
  3.     "msg": "fail to execute compaction, error = -2000"
  4. }

If the tablet exists and the tablet is running, JSON format is returned:

  1. {
  2.     "status": "Success",
  3.     "msg": "compaction task is successfully triggered."
  4. }

Explanation of results:

  • status: Trigger task status, when it is successfully triggered, it is Success; when for some reason (for example, the appropriate version is not obtained), it returns Fail.
  • msg: Give specific success or failure information.

Show Status

If the tablet does not exist, an error in JSON format is returned:

  1. {
  2.     "status": "Fail",
  3.     "msg": "Tablet not found"
  4. }

If the tablet exists and the tablet is not running, JSON format is returned:

  1. {
  2.     "status" : "Success",
  3.     "run_status" : false,
  4.     "msg" : "this tablet_id is not running",
  5.     "tablet_id" : 11308,
  6.     "schema_hash" : 700967178,
  7.     "compact_type" : ""
  8. }

If the tablet exists and the tablet is running, JSON format is returned:

  1. {
  2.     "status" : "Success",
  3.     "run_status" : true,
  4.     "msg" : "this tablet_id is running",
  5.     "tablet_id" : 11308,
  6.     "schema_hash" : 700967178,
  7.     "compact_type" : "cumulative"
  8. }

Explanation of results:

  • run_status: Get the current manual compaction task execution status.

Examples

  1. curl -X POST "http://127.0.0.1:8040/api/compaction/run?tablet_id=10015&compact_type=cumulative"