Coverage Report

Created: 2026-08-06 19:00

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
be/src/service/http/action/compaction_action.cpp
Line
Count
Source
1
// Licensed to the Apache Software Foundation (ASF) under one
2
// or more contributor license agreements.  See the NOTICE file
3
// distributed with this work for additional information
4
// regarding copyright ownership.  The ASF licenses this file
5
// to you under the Apache License, Version 2.0 (the
6
// "License"); you may not use this file except in compliance
7
// with the License.  You may obtain a copy of the License at
8
//
9
//   http://www.apache.org/licenses/LICENSE-2.0
10
//
11
// Unless required by applicable law or agreed to in writing,
12
// software distributed under the License is distributed on an
13
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
// KIND, either express or implied.  See the License for the
15
// specific language governing permissions and limitations
16
// under the License.
17
18
#include "service/http/action/compaction_action.h"
19
20
// IWYU pragma: no_include <bits/chrono.h>
21
#include <chrono> // IWYU pragma: keep
22
#include <exception>
23
#include <future>
24
#include <memory>
25
#include <mutex>
26
#include <sstream>
27
#include <string>
28
#include <thread>
29
#include <utility>
30
31
#include "absl/strings/substitute.h"
32
#include "common/logging.h"
33
#include "common/metrics/doris_metrics.h"
34
#include "common/status.h"
35
#include "service/backend_options.h"
36
#include "service/http/http_channel.h"
37
#include "service/http/http_headers.h"
38
#include "service/http/http_request.h"
39
#include "service/http/http_status.h"
40
#include "storage/compaction/base_compaction.h"
41
#include "storage/compaction/binlog_compaction.h"
42
#include "storage/compaction/cumulative_compaction.h"
43
#include "storage/compaction/cumulative_compaction_policy.h"
44
#include "storage/compaction/cumulative_compaction_time_series_policy.h"
45
#include "storage/compaction_task_tracker.h"
46
#include "storage/olap_define.h"
47
#include "storage/storage_engine.h"
48
#include "storage/tablet/tablet_manager.h"
49
#include "util/stopwatch.hpp"
50
51
namespace doris {
52
using namespace ErrorCode;
53
54
namespace {
55
56
constexpr std::string_view HEADER_JSON = "application/json";
57
58
} // namespace
59
60
CompactionAction::CompactionAction(CompactionActionType ctype, ExecEnv* exec_env,
61
                                   StorageEngine& engine, TPrivilegeHier::type hier,
62
                                   TPrivilegeType::type ptype)
63
33
        : HttpHandlerWithAuth(exec_env, hier, ptype), _engine(engine), _compaction_type(ctype) {}
64
65
/// check param and fetch tablet_id & table_id from req
66
11
static Status _check_param(HttpRequest* req, uint64_t* tablet_id, uint64_t* table_id) {
67
    // req tablet id and table id, we have to set only one of them.
68
11
    const auto& req_tablet_id = req->param(TABLET_ID_KEY);
69
11
    const auto& req_table_id = req->param(TABLE_ID_KEY);
70
11
    if (req_tablet_id.empty()) {
71
2
        if (req_table_id.empty()) {
72
            // both tablet id and table id are empty, return error.
73
1
            return Status::InternalError(
74
1
                    "tablet id and table id can not be empty at the same time!");
75
1
        } else {
76
1
            try {
77
1
                *table_id = std::stoull(req_table_id);
78
1
            } catch (const std::exception& e) {
79
0
                return Status::InternalError("convert table_id failed, {}", e.what());
80
0
            }
81
1
            return Status::OK();
82
1
        }
83
9
    } else if (req_table_id.empty()) {
84
8
        try {
85
8
            *tablet_id = std::stoull(req_tablet_id);
86
8
        } catch (const std::exception& e) {
87
1
            return Status::InternalError("convert tablet_id failed, {}", e.what());
88
1
        }
89
7
        return Status::OK();
90
8
    } else {
91
        // both tablet id and table id are not empty, return err.
92
1
        return Status::InternalError("tablet id and table id can not be set at the same time!");
93
1
    }
94
11
}
95
96
/// retrieve specific id from req
97
4
static Status _check_param(HttpRequest* req, uint64_t* id_param, const std::string param_name) {
98
4
    const auto& req_id_param = req->param(param_name);
99
4
    if (!req_id_param.empty()) {
100
2
        try {
101
2
            *id_param = std::stoull(req_id_param);
102
2
        } catch (const std::exception& e) {
103
0
            return Status::InternalError("convert {} failed, {}", param_name, e.what());
104
0
        }
105
2
    }
106
107
4
    return Status::OK();
108
4
}
109
110
// for viewing the compaction status
111
2
Status CompactionAction::_handle_show_compaction(HttpRequest* req, std::string* json_result) {
112
2
    uint64_t tablet_id = 0;
113
    // check & retrieve tablet_id from req if it contains
114
2
    RETURN_NOT_OK_STATUS_WITH_WARN(_check_param(req, &tablet_id, TABLET_ID_KEY),
115
2
                                   "check param failed");
116
2
    if (tablet_id == 0) {
117
1
        return Status::InternalError("check param failed: missing tablet_id");
118
1
    }
119
120
1
    TabletSharedPtr tablet = _engine.tablet_manager()->get_tablet(tablet_id);
121
1
    if (tablet == nullptr) {
122
1
        return Status::NotFound("Tablet not found. tablet_id={}", tablet_id);
123
1
    }
124
125
0
    tablet->get_compaction_status(json_result);
126
0
    return Status::OK();
127
1
}
128
129
11
Status CompactionAction::_handle_run_compaction(HttpRequest* req, std::string* json_result) {
130
    // 1. param check
131
    // check req_tablet_id or req_table_id is not empty and can not be set together.
132
11
    uint64_t tablet_id = 0;
133
11
    uint64_t table_id = 0;
134
11
    RETURN_NOT_OK_STATUS_WITH_WARN(_check_param(req, &tablet_id, &table_id), "check param failed");
135
136
    // check compaction_type
137
8
    std::string compaction_type = req->param(PARAM_COMPACTION_TYPE);
138
8
    if (compaction_type != PARAM_COMPACTION_BASE &&
139
8
        compaction_type != PARAM_COMPACTION_CUMULATIVE &&
140
8
        compaction_type != PARAM_COMPACTION_FULL && compaction_type != PARAM_COMPACTION_BINLOG) {
141
1
        return Status::NotSupported("The compaction type '{}' is not supported", compaction_type);
142
1
    }
143
144
    // "force" = "true" means skip permit limiter when submitting full compaction to thread pool
145
7
    bool force = false;
146
7
    std::string param_force = req->param(PARAM_COMPACTION_FORCE);
147
7
    if (param_force == "true") {
148
2
        force = true;
149
5
    } else if (!param_force.empty() && param_force != "false") {
150
1
        return Status::NotSupported("The force = '{}' is not supported", param_force);
151
1
    }
152
153
6
    if (tablet_id == 0 && table_id != 0) {
154
1
        std::vector<TabletSharedPtr> tablet_vec = _engine.tablet_manager()->get_all_tablet(
155
1
                [table_id](Tablet* tablet) -> bool { return tablet->get_table_id() == table_id; });
156
1
        for (const auto& tablet : tablet_vec) {
157
0
            tablet->set_last_full_compaction_schedule_time(UnixMillis());
158
0
            RETURN_IF_ERROR(_engine.submit_compaction_task(tablet, CompactionType::FULL_COMPACTION,
159
0
                                                           force, true, 1));
160
0
        }
161
5
    } else {
162
        // 2. fetch the tablet by tablet_id
163
5
        TabletSharedPtr tablet = _engine.tablet_manager()->get_tablet(tablet_id);
164
5
        if (tablet == nullptr) {
165
5
            return Status::NotFound("Tablet not found. tablet_id={}", tablet_id);
166
5
        }
167
168
0
        DBUG_EXECUTE_IF("CompactionAction._handle_run_compaction.submit_cumu_task", {
169
0
            RETURN_IF_ERROR(_engine.submit_compaction_task(
170
0
                    tablet, CompactionType::CUMULATIVE_COMPACTION, false));
171
0
            LOG(INFO) << "Manual debug compaction task is successfully triggered";
172
0
            *json_result =
173
0
                    R"({"status": "Success", "msg": "debug compaction task is successfully triggered. Table id: )" +
174
0
                    std::to_string(table_id) + ". Tablet id: " + std::to_string(tablet_id) + "\"}";
175
0
            return Status::OK();
176
0
        })
177
178
0
        if (compaction_type == PARAM_COMPACTION_FULL) {
179
            // 3. submit full compaction task to thread pool
180
0
            tablet->set_last_full_compaction_schedule_time(UnixMillis());
181
0
            RETURN_IF_ERROR(_engine.submit_compaction_task(tablet, CompactionType::FULL_COMPACTION,
182
0
                                                           force, true, 1));
183
0
        } else {
184
            // 3. execute base/cumulative/binlog compaction task in a detached thread
185
0
            std::packaged_task<Status()> task([this, tablet, compaction_type]() {
186
0
                return _execute_compaction_callback(tablet, compaction_type);
187
0
            });
188
0
            std::future<Status> future_obj = task.get_future();
189
0
            std::thread(std::move(task)).detach();
190
191
0
            if (compaction_type == PARAM_COMPACTION_BASE) {
192
0
                tablet->set_last_base_compaction_schedule_time(UnixMillis());
193
0
            } else if (compaction_type == PARAM_COMPACTION_CUMULATIVE) {
194
0
                tablet->set_last_cumu_compaction_schedule_time(UnixMillis());
195
0
            }
196
197
            // 4. wait for result for 2 seconds by async
198
0
            std::future_status status = future_obj.wait_for(std::chrono::seconds(2));
199
0
            if (status == std::future_status::ready) {
200
0
                Status olap_status = future_obj.get();
201
0
                if (!olap_status.ok()) {
202
0
                    return olap_status;
203
0
                }
204
0
            } else {
205
0
                LOG(INFO) << "Manual compaction task is timeout for waiting "
206
0
                          << (status == std::future_status::timeout);
207
0
            }
208
0
        }
209
0
    }
210
6
    LOG(INFO) << "Manual compaction task is successfully triggered";
211
1
    *json_result =
212
1
            R"({"status": "Success", "msg": "compaction task is successfully triggered. Table id: )" +
213
1
            std::to_string(table_id) + ". Tablet id: " + std::to_string(tablet_id) + "\"}";
214
1
    return Status::OK();
215
6
}
216
217
2
Status CompactionAction::_handle_run_status_compaction(HttpRequest* req, std::string* json_result) {
218
2
    uint64_t tablet_id = 0;
219
    // check & retrieve tablet_id from req if it contains
220
2
    RETURN_NOT_OK_STATUS_WITH_WARN(_check_param(req, &tablet_id, TABLET_ID_KEY),
221
2
                                   "check param failed");
222
223
2
    if (tablet_id == 0) {
224
        // overall compaction status
225
1
        _engine.get_compaction_status_json(json_result);
226
1
        return Status::OK();
227
1
    } else {
228
        // fetch the tablet by tablet_id
229
1
        TabletSharedPtr tablet = _engine.tablet_manager()->get_tablet(tablet_id);
230
1
        if (tablet == nullptr) {
231
1
            LOG(WARNING) << "invalid argument.tablet_id:" << tablet_id;
232
1
            return Status::InternalError("fail to get {}", tablet_id);
233
1
        }
234
235
0
        std::string json_template = R"({
236
0
            "status" : "Success",
237
0
            "run_status" : $0,
238
0
            "msg" : "$1",
239
0
            "tablet_id" : $2,
240
0
            "compact_type" : "$3"
241
0
        })";
242
243
0
        std::string msg = "compaction task for this tablet is not running";
244
0
        std::string compaction_type;
245
0
        bool run_status = false;
246
247
0
        {
248
            // Full compaction holds both base compaction lock and cumu compaction lock.
249
            // So we can not judge if full compaction is running by check these two locks holding.
250
            // Here, we use a variable 'is_full_compaction_running' to check if full compaction is running.
251
0
            if (tablet->is_full_compaction_running()) {
252
0
                msg = "compaction task for this tablet is running";
253
0
                compaction_type = "full";
254
0
                run_status = true;
255
0
                *json_result = absl::Substitute(json_template, run_status, msg, tablet_id,
256
0
                                                compaction_type);
257
0
                return Status::OK();
258
0
            }
259
0
        }
260
261
0
        {
262
            // use try lock to check this tablet is running cumulative compaction
263
0
            std::unique_lock<std::mutex> lock_cumulative(tablet->get_cumulative_compaction_lock(),
264
0
                                                         std::try_to_lock);
265
0
            if (!lock_cumulative.owns_lock()) {
266
0
                msg = "compaction task for this tablet is running";
267
0
                compaction_type = "cumulative";
268
0
                run_status = true;
269
0
                *json_result = absl::Substitute(json_template, run_status, msg, tablet_id,
270
0
                                                compaction_type);
271
0
                return Status::OK();
272
0
            }
273
0
        }
274
275
0
        {
276
            // use try lock to check this tablet is running binlog compaction
277
0
            std::unique_lock<std::mutex> lock_binlog(tablet->get_binlog_compaction_lock(),
278
0
                                                     std::try_to_lock);
279
0
            if (!lock_binlog.owns_lock()) {
280
0
                msg = "compaction task for this tablet is running";
281
0
                compaction_type = "binlog";
282
0
                run_status = true;
283
0
                *json_result = absl::Substitute(json_template, run_status, msg, tablet_id,
284
0
                                                compaction_type);
285
0
                return Status::OK();
286
0
            }
287
0
        }
288
289
0
        {
290
            // use try lock to check this tablet is running base compaction
291
0
            std::unique_lock<std::mutex> lock_base(tablet->get_base_compaction_lock(),
292
0
                                                   std::try_to_lock);
293
0
            if (!lock_base.owns_lock()) {
294
0
                msg = "compaction task for this tablet is running";
295
0
                compaction_type = "base";
296
0
                run_status = true;
297
0
                *json_result = absl::Substitute(json_template, run_status, msg, tablet_id,
298
0
                                                compaction_type);
299
0
                return Status::OK();
300
0
            }
301
0
        }
302
        // not running any compaction
303
0
        *json_result = absl::Substitute(json_template, run_status, msg, tablet_id, compaction_type);
304
0
        return Status::OK();
305
0
    }
306
2
}
307
308
Status CompactionAction::_execute_compaction_callback(TabletSharedPtr tablet,
309
                                                      const std::string& compaction_type,
310
0
                                                      int8_t prefer_compaction_level) {
311
0
    MonotonicStopWatch timer;
312
0
    timer.start();
313
314
0
    std::shared_ptr<CumulativeCompactionPolicy> cumulative_compaction_policy =
315
0
            CumulativeCompactionPolicyFactory::create_cumulative_compaction_policy(
316
0
                    tablet->tablet_meta()->compaction_policy());
317
0
    if (tablet->get_cumulative_compaction_policy() == nullptr) {
318
0
        tablet->set_cumulative_compaction_policy(cumulative_compaction_policy);
319
0
    }
320
0
    Status res = Status::OK();
321
0
    auto* tracker = CompactionTaskTracker::instance();
322
0
    auto do_compact = [&](Compaction& compaction, CompactionProfileType profile_type) {
323
0
        RETURN_IF_ERROR(compaction.prepare_compact());
324
        // Register task as RUNNING with tracker (manual trigger, direct execution path)
325
        // Use compaction.compaction_id() which was allocated in constructor.
326
0
        int64_t compaction_id = compaction.compaction_id();
327
0
        {
328
0
            CompactionTaskInfo info;
329
0
            info.compaction_id = compaction_id;
330
0
            info.tablet_id = tablet->tablet_id();
331
0
            info.table_id = tablet->get_table_id();
332
0
            info.partition_id = tablet->partition_id();
333
0
            info.compaction_type = profile_type;
334
0
            info.status = CompactionTaskStatus::RUNNING;
335
0
            info.trigger_method = TriggerMethod::MANUAL;
336
0
            auto now_ms = std::chrono::duration_cast<std::chrono::milliseconds>(
337
0
                                  std::chrono::system_clock::now().time_since_epoch())
338
0
                                  .count();
339
0
            info.scheduled_time_ms = now_ms;
340
0
            info.start_time_ms = now_ms;
341
0
            info.compaction_score = tablet->get_real_compaction_score();
342
0
            info.input_rowsets_count = compaction.input_rowsets_count();
343
0
            info.input_row_num = compaction.input_row_num_value();
344
0
            info.input_data_size = compaction.input_rowsets_data_size();
345
0
            info.input_index_size = compaction.input_rowsets_index_size();
346
0
            info.input_total_size = compaction.input_rowsets_total_size();
347
0
            info.input_segments_num = compaction.input_segments_num_value();
348
0
            info.input_version_range = compaction.input_version_range_str();
349
0
            info.is_vertical = compaction.is_vertical();
350
0
            info.backend_id = BackendOptions::get_backend_id();
351
0
            tracker->register_task(std::move(info));
352
0
        }
353
0
        auto st = compaction.execute_compact();
354
        // Idempotent cleanup: if execute returned early (e.g. TRY_LOCK_FAILED)
355
        // before submit_profile_record was called, task remains in active_tasks.
356
0
        tracker->remove_task(compaction_id);
357
0
        return st;
358
0
    };
359
0
    if (compaction_type == PARAM_COMPACTION_BASE) {
360
0
        BaseCompaction base_compaction(_engine, tablet);
361
0
        res = do_compact(base_compaction, CompactionProfileType::BASE);
362
0
        if (!res) {
363
0
            if (!res.is<BE_NO_SUITABLE_VERSION>()) {
364
0
                DorisMetrics::instance()->base_compaction_request_failed->increment(1);
365
0
            }
366
0
        }
367
0
    } else if (compaction_type == PARAM_COMPACTION_CUMULATIVE) {
368
0
        {
369
0
            CumulativeCompaction cumulative_compaction(_engine, tablet);
370
0
            res = do_compact(cumulative_compaction, CompactionProfileType::CUMULATIVE);
371
0
            if (!res) {
372
0
                if (res.is<CUMULATIVE_NO_SUITABLE_VERSION>()) {
373
                    // Ignore this error code.
374
0
                    VLOG_NOTICE
375
0
                            << "failed to init cumulative compaction due to no suitable version,"
376
0
                            << "tablet=" << tablet->tablet_id();
377
0
                } else {
378
0
                    DorisMetrics::instance()->cumulative_compaction_request_failed->increment(1);
379
0
                    LOG(WARNING) << "failed to do cumulative compaction. res=" << res
380
0
                                 << ", table=" << tablet->tablet_id();
381
0
                }
382
0
            }
383
0
        }
384
0
    } else if (compaction_type == PARAM_COMPACTION_BINLOG) {
385
0
        if (prefer_compaction_level < 0) {
386
0
            tablet->calc_compaction_score(CompactionType::BINLOG_COMPACTION,
387
0
                                          &prefer_compaction_level);
388
0
        }
389
0
        if (prefer_compaction_level < 0) {
390
0
            res = Status::Error<BINLOG_COMPACTION_NO_SUITABLE_VERSION>(
391
0
                    "failed to init binlog compaction due to no suitable version");
392
0
        } else {
393
0
            BinlogCompaction binlog_compaction(_engine, tablet, prefer_compaction_level);
394
0
            res = do_compact(binlog_compaction, CompactionProfileType::BINLOG);
395
0
            if (!res) {
396
0
                if (res.is<BINLOG_COMPACTION_NO_SUITABLE_VERSION>()) {
397
0
                    VLOG_NOTICE << "failed to init binlog compaction due to no suitable version,"
398
0
                                << "tablet=" << tablet->tablet_id() << ", compaction_level="
399
0
                                << static_cast<int>(prefer_compaction_level);
400
0
                } else {
401
0
                    LOG(WARNING) << "failed to do binlog compaction. res=" << res
402
0
                                 << ", table=" << tablet->tablet_id() << ", compaction_level="
403
0
                                 << static_cast<int>(prefer_compaction_level);
404
0
                }
405
0
            }
406
0
        }
407
0
    }
408
0
    timer.stop();
409
0
    LOG(INFO) << "Manual compaction task finish, status=" << res
410
0
              << ", compaction_use_time=" << timer.elapsed_time() / 1000000 << "ms";
411
0
    return res;
412
0
}
413
414
0
void CompactionAction::handle(HttpRequest* req) {
415
0
    req->add_output_header(HttpHeaders::CONTENT_TYPE, HEADER_JSON.data());
416
417
0
    if (_compaction_type == CompactionActionType::SHOW_INFO) {
418
0
        std::string json_result;
419
0
        Status st = _handle_show_compaction(req, &json_result);
420
0
        if (!st.ok()) {
421
0
            HttpChannel::send_reply(req, HttpStatus::OK, st.to_json());
422
0
        } else {
423
0
            HttpChannel::send_reply(req, HttpStatus::OK, json_result);
424
0
        }
425
0
    } else if (_compaction_type == CompactionActionType::RUN_COMPACTION) {
426
0
        std::string json_result;
427
0
        Status st = _handle_run_compaction(req, &json_result);
428
0
        if (!st.ok()) {
429
0
            HttpChannel::send_reply(req, HttpStatus::OK, st.to_json());
430
0
        } else {
431
0
            HttpChannel::send_reply(req, HttpStatus::OK, json_result);
432
0
        }
433
0
    } else {
434
0
        std::string json_result;
435
0
        Status st = _handle_run_status_compaction(req, &json_result);
436
0
        if (!st.ok()) {
437
0
            HttpChannel::send_reply(req, HttpStatus::OK, st.to_json());
438
0
        } else {
439
0
            HttpChannel::send_reply(req, HttpStatus::OK, json_result);
440
0
        }
441
0
    }
442
0
}
443
444
} // end namespace doris