手動でCompactionをトリガー

リクエスト

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}

説明

手動で比較をトリガーし、ステータスを表示するために使用されます。

クエリパラメータ

• tablet_id

  • tabletのID

• table_id

  • tableのID。table_id=xxxは、compact_type=fullが指定された場合のみ有効になり、tablet_idとtable_idのうち1つのみ指定でき、同時に指定することはできないことに注意してください。table_idを指定した後、このtable配下の全てのtabletに対してfull_compactionが自動的に実行されます。

• compact_type

  • 値はbaseまたはcumulativeまたはfullです。full_compactionの使用シナリオについては、Data Recoveryを参照してください。

リクエストボディ

なし

レスポンス

Compactionのトリガー

tabletが存在しない場合、JSON形式のエラーが返されます：

{
    "status": "Fail",
    "msg": "Tablet not found"
}

タブレットが存在し、タブレットが実行されていない場合、JSON形式が返されます：

{
    "status": "Fail",
    "msg": "fail to execute compaction, error = -2000"
}

タブレットが存在し、タブレットが実行中の場合、JSON形式が返されます：

{
    "status": "Success",
    "msg": "compaction task is successfully triggered."
}

結果の説明：

• status: Trigger taskのステータス。正常にトリガーされた場合はSuccess、何らかの理由（例：適切なバージョンが取得できない）でFailが返される。
• msg: 具体的な成功または失敗情報を提供する。

Show Status

tabletが存在しない場合、JSON形式のエラーが返される：

{
    "status": "Fail",
    "msg": "Tablet not found"
}

tabletが存在し、tabletが実行されていない場合、JSON形式が返されます：

{
    "status" : "Success",
    "run_status" : false,
    "msg" : "this tablet_id is not running",
    "tablet_id" : 11308,
    "schema_hash" : 700967178,
    "compact_type" : ""
}

タブレットが存在し、タブレットが動作している場合、JSON形式が返されます：

{
    "status" : "Success",
    "run_status" : true,
    "msg" : "this tablet_id is running",
    "tablet_id" : 11308,
    "schema_hash" : 700967178,
    "compact_type" : "cumulative"
}

結果の説明：

• run_status: 現在の手動コンパクションタスクの実行ステータスを取得します。

例

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