Coverage Report

Created: 2026-03-19 14:47

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
be/src/cloud/cloud_schema_change_job.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 "cloud/cloud_schema_change_job.h"
19
20
#include <gen_cpp/Types_types.h>
21
#include <gen_cpp/cloud.pb.h>
22
23
#include <algorithm>
24
#include <chrono>
25
#include <memory>
26
#include <mutex>
27
#include <random>
28
#include <thread>
29
30
#include "cloud/cloud_meta_mgr.h"
31
#include "cloud/cloud_tablet_mgr.h"
32
#include "common/status.h"
33
#include "service/backend_options.h"
34
#include "storage/delete/delete_handler.h"
35
#include "storage/index/inverted/inverted_index_desc.h"
36
#include "storage/olap_define.h"
37
#include "storage/rowset/beta_rowset.h"
38
#include "storage/rowset/rowset.h"
39
#include "storage/rowset/rowset_factory.h"
40
#include "storage/storage_engine.h"
41
#include "storage/tablet/tablet.h"
42
#include "storage/tablet/tablet_fwd.h"
43
#include "storage/tablet/tablet_meta.h"
44
#include "util/debug_points.h"
45
46
namespace doris {
47
using namespace ErrorCode;
48
49
static constexpr int ALTER_TABLE_BATCH_SIZE = 4096;
50
static constexpr int SCHEMA_CHANGE_DELETE_BITMAP_LOCK_ID = -2;
51
52
std::unique_ptr<SchemaChange> get_sc_procedure(const BlockChanger& changer, bool sc_sorting,
53
10.8k
                                               int64_t mem_limit) {
54
10.8k
    if (sc_sorting) {
55
8.70k
        return std::make_unique<VBaseSchemaChangeWithSorting>(changer, mem_limit);
56
8.70k
    }
57
    // else sc_directly
58
2.17k
    return std::make_unique<VSchemaChangeDirectly>(changer);
59
10.8k
}
60
61
CloudSchemaChangeJob::CloudSchemaChangeJob(CloudStorageEngine& cloud_storage_engine,
62
                                           std::string job_id, int64_t expiration)
63
11.0k
        : _cloud_storage_engine(cloud_storage_engine),
64
11.0k
          _job_id(std::move(job_id)),
65
11.0k
          _expiration(expiration) {
66
11.0k
    _initiator = boost::uuids::hash_value(UUIDGenerator::instance()->next_uuid()) &
67
11.0k
                 std::numeric_limits<int64_t>::max();
68
11.0k
}
69
70
11.0k
CloudSchemaChangeJob::~CloudSchemaChangeJob() = default;
71
72
11.0k
Status CloudSchemaChangeJob::process_alter_tablet(const TAlterTabletReqV2& request) {
73
11.0k
    DBUG_EXECUTE_IF("CloudSchemaChangeJob::process_alter_tablet.block", DBUG_BLOCK);
74
    // new tablet has to exist
75
11.0k
    _new_tablet = DORIS_TRY(_cloud_storage_engine.tablet_mgr().get_tablet(request.new_tablet_id));
76
11.0k
    if (_new_tablet->tablet_state() == TABLET_RUNNING) {
77
164
        LOG(INFO) << "schema change job has already finished. base_tablet_id="
78
164
                  << request.base_tablet_id << ", new_tablet_id=" << request.new_tablet_id
79
164
                  << ", alter_version=" << request.alter_version << ", job_id=" << _job_id;
80
164
        return Status::OK();
81
164
    }
82
83
10.8k
    _base_tablet = DORIS_TRY(_cloud_storage_engine.tablet_mgr().get_tablet(request.base_tablet_id));
84
85
10.8k
    static constexpr long TRY_LOCK_TIMEOUT = 30;
86
10.8k
    std::unique_lock schema_change_lock(_base_tablet->get_schema_change_lock(), std::defer_lock);
87
10.8k
    bool owns_lock = schema_change_lock.try_lock_for(std::chrono::seconds(TRY_LOCK_TIMEOUT));
88
89
10.8k
    _new_tablet->set_alter_failed(false);
90
10.8k
    Defer defer([this] {
91
        // if tablet state is not TABLET_RUNNING when return, indicates that alter has failed.
92
10.3k
        if (_new_tablet->tablet_state() != TABLET_RUNNING) {
93
76
            _new_tablet->set_alter_failed(true);
94
76
        }
95
10.3k
    });
96
97
10.8k
    if (!owns_lock) {
98
0
        LOG(WARNING) << "Failed to obtain schema change lock, there might be inverted index being "
99
0
                        "built on base_tablet="
100
0
                     << request.base_tablet_id;
101
0
        return Status::Error<TRY_LOCK_FAILED>(
102
0
                "Failed to obtain schema change lock, there might be inverted index being "
103
0
                "built on base_tablet=",
104
0
                request.base_tablet_id);
105
0
    }
106
    // MUST sync rowsets before capturing rowset readers and building DeleteHandler
107
10.8k
    SyncOptions options;
108
10.8k
    options.query_version = request.alter_version;
109
10.8k
    RETURN_IF_ERROR(_base_tablet->sync_rowsets(options));
110
    // ATTN: Only convert rowsets of version larger than 1, MUST let the new tablet cache have rowset [0-1]
111
10.8k
    _output_cumulative_point = _base_tablet->cumulative_layer_point();
112
10.8k
    std::vector<RowSetSplits> rs_splits;
113
10.8k
    int64_t base_max_version = _base_tablet->max_version_unlocked();
114
10.8k
    DBUG_EXECUTE_IF("CloudSchemaChangeJob::process_alter_tablet.override_base_max_version", {
115
10.8k
        auto v = dp->param<int64_t>("version", -1);
116
10.8k
        if (v > 0) {
117
10.8k
            LOG(INFO) << "override base_max_version from " << base_max_version << " to " << v;
118
10.8k
            base_max_version = v;
119
10.8k
        }
120
10.8k
    });
121
10.8k
    cloud::TabletJobInfoPB job;
122
10.8k
    auto* idx = job.mutable_idx();
123
10.8k
    idx->set_tablet_id(_base_tablet->tablet_id());
124
10.8k
    idx->set_table_id(_base_tablet->table_id());
125
10.8k
    idx->set_index_id(_base_tablet->index_id());
126
10.8k
    idx->set_partition_id(_base_tablet->partition_id());
127
10.8k
    auto* sc_job = job.mutable_schema_change();
128
10.8k
    sc_job->set_id(_job_id);
129
10.8k
    sc_job->set_initiator(BackendOptions::get_localhost() + ':' +
130
10.8k
                          std::to_string(config::heartbeat_service_port));
131
10.8k
    sc_job->set_alter_version(base_max_version);
132
10.8k
    auto* new_tablet_idx = sc_job->mutable_new_tablet_idx();
133
10.8k
    new_tablet_idx->set_tablet_id(_new_tablet->tablet_id());
134
10.8k
    new_tablet_idx->set_table_id(_new_tablet->table_id());
135
10.8k
    new_tablet_idx->set_index_id(_new_tablet->index_id());
136
10.8k
    new_tablet_idx->set_partition_id(_new_tablet->partition_id());
137
10.8k
    cloud::StartTabletJobResponse start_resp;
138
10.8k
    auto st = _cloud_storage_engine.meta_mgr().prepare_tablet_job(job, &start_resp);
139
10.8k
    if (!st.ok()) {
140
0
        if (start_resp.status().code() == cloud::JOB_ALREADY_SUCCESS) {
141
0
            st = _new_tablet->sync_rowsets();
142
0
            if (!st.ok()) {
143
0
                LOG_WARNING("failed to sync new tablet")
144
0
                        .tag("tablet_id", _new_tablet->tablet_id())
145
0
                        .error(st);
146
0
            }
147
0
            return Status::OK();
148
0
        }
149
0
        return st;
150
0
    }
151
10.8k
    DBUG_EXECUTE_IF("CloudSchemaChangeJob::process_alter_tablet.alter_fail", {
152
10.8k
        auto res =
153
10.8k
                Status::InternalError("inject alter tablet failed. base_tablet={}, new_tablet={}",
154
10.8k
                                      request.base_tablet_id, request.new_tablet_id);
155
10.8k
        LOG(WARNING) << "inject error. res=" << res;
156
10.8k
        return res;
157
10.8k
    });
158
159
    // Check for cross-V1 compaction rowsets on new tablet.
160
    // During queue wait, compaction may have committed a rowset that crosses the
161
    // alter_version boundary (V1). This happens when compaction commits before
162
    // prepare_tablet_job registers the SC job in meta-service.
163
    // If such a rowset exists, SC commit would create version overlap, so we
164
    // fail early and let FE retry (with a higher V1 next time).
165
10.8k
    {
166
10.8k
        RETURN_IF_ERROR(_new_tablet->sync_rowsets());
167
10.8k
        std::shared_lock rlock(_new_tablet->get_header_lock());
168
10.8k
        for (auto& [v, rs] : _new_tablet->rowset_map()) {
169
10.8k
            if (v.first > 1 && v.first <= start_resp.alter_version() &&
170
10.8k
                v.second > start_resp.alter_version()) {
171
0
                LOG(WARNING) << "cross-V1 compaction detected on new tablet"
172
0
                             << ", tablet_id=" << _new_tablet->tablet_id() << ", rowset=["
173
0
                             << v.first << "-" << v.second << "]"
174
0
                             << ", alter_version=" << start_resp.alter_version()
175
0
                             << ", job_id=" << _job_id << ". Will retry with higher alter_version.";
176
0
                return Status::Error<ErrorCode::INTERNAL_ERROR>(
177
0
                        "cross-V1 compaction detected on new tablet, tablet_id={}, "
178
0
                        "rowset=[{}-{}], alter_version={}",
179
0
                        _new_tablet->tablet_id(), v.first, v.second, start_resp.alter_version());
180
0
            }
181
10.8k
        }
182
10.8k
    }
183
184
10.8k
    if (request.alter_version > 1) {
185
        // [0-1] is a placeholder rowset, no need to convert
186
5.28k
        RETURN_IF_ERROR(_base_tablet->capture_rs_readers({2, start_resp.alter_version()},
187
5.28k
                                                         &rs_splits,
188
5.28k
                                                         {.skip_missing_versions = false,
189
5.28k
                                                          .enable_prefer_cached_rowset = false,
190
5.28k
                                                          .query_freshness_tolerance_ms = -1}));
191
5.28k
    }
192
    // Between prepare_tablet_job (SC job registered in meta-service) and
193
    // set_alter_version (local alter_version update). Used to test cross-V1 race.
194
10.8k
    DBUG_EXECUTE_IF("CloudSchemaChangeJob::process_alter_tablet.after_prepare_job", DBUG_BLOCK);
195
196
10.8k
    Defer defer2 {[&]() {
197
10.5k
        _new_tablet->set_alter_version(-1);
198
10.5k
        _base_tablet->set_alter_version(-1);
199
10.5k
    }};
200
10.8k
    _new_tablet->set_alter_version(start_resp.alter_version());
201
10.8k
    _base_tablet->set_alter_version(start_resp.alter_version());
202
10.8k
    LOG(INFO) << "Begin to alter tablet. base_tablet_id=" << request.base_tablet_id
203
10.8k
              << ", new_tablet_id=" << request.new_tablet_id
204
10.8k
              << ", alter_version=" << start_resp.alter_version() << ", job_id=" << _job_id;
205
10.8k
    sc_job->set_alter_version(start_resp.alter_version());
206
207
    // FIXME(cyx): Should trigger compaction on base_tablet if there are too many rowsets to convert.
208
209
    // Create a new tablet schema, should merge with dropped columns in light weight schema change
210
10.8k
    _base_tablet_schema = std::make_shared<TabletSchema>();
211
10.8k
    _base_tablet_schema->update_tablet_columns(*_base_tablet->tablet_schema(), request.columns);
212
10.8k
    _new_tablet_schema = _new_tablet->tablet_schema();
213
214
10.8k
    std::vector<ColumnId> return_columns;
215
10.8k
    return_columns.resize(_base_tablet_schema->num_columns());
216
10.8k
    std::iota(return_columns.begin(), return_columns.end(), 0);
217
218
    // delete handlers to filter out deleted rows
219
10.8k
    DeleteHandler delete_handler;
220
10.8k
    std::vector<RowsetMetaSharedPtr> delete_predicates;
221
10.8k
    for (auto& split : rs_splits) {
222
9.99k
        auto& rs_meta = split.rs_reader->rowset()->rowset_meta();
223
9.99k
        if (rs_meta->has_delete_predicate()) {
224
54
            _base_tablet_schema->merge_dropped_columns(*rs_meta->tablet_schema());
225
54
            delete_predicates.push_back(rs_meta);
226
54
        }
227
9.99k
    }
228
10.8k
    RETURN_IF_ERROR(delete_handler.init(_base_tablet_schema, delete_predicates,
229
10.8k
                                        start_resp.alter_version()));
230
231
    // reader_context is stack variables, it's lifetime MUST keep the same with rs_readers
232
10.8k
    RowsetReaderContext reader_context;
233
10.8k
    reader_context.reader_type = ReaderType::READER_ALTER_TABLE;
234
10.8k
    reader_context.tablet_schema = _base_tablet_schema;
235
10.8k
    reader_context.need_ordered_result = true;
236
10.8k
    reader_context.delete_handler = &delete_handler;
237
10.8k
    reader_context.return_columns = &return_columns;
238
10.8k
    reader_context.sequence_id_idx = reader_context.tablet_schema->sequence_col_idx();
239
10.8k
    reader_context.is_unique = _base_tablet->keys_type() == UNIQUE_KEYS;
240
10.8k
    reader_context.batch_size = ALTER_TABLE_BATCH_SIZE;
241
10.8k
    reader_context.delete_bitmap = _base_tablet->tablet_meta()->delete_bitmap_ptr();
242
10.8k
    reader_context.version = Version(0, start_resp.alter_version());
243
10.8k
    std::vector<uint32_t> cluster_key_idxes;
244
10.8k
    if (!_base_tablet_schema->cluster_key_uids().empty()) {
245
700
        for (const auto& uid : _base_tablet_schema->cluster_key_uids()) {
246
700
            cluster_key_idxes.emplace_back(_base_tablet_schema->field_index(uid));
247
700
        }
248
132
        reader_context.read_orderby_key_columns = &cluster_key_idxes;
249
132
        reader_context.is_unique = false;
250
132
        reader_context.sequence_id_idx = -1;
251
132
    }
252
253
10.8k
    for (auto& split : rs_splits) {
254
9.99k
        RETURN_IF_ERROR(split.rs_reader->init(&reader_context));
255
9.99k
    }
256
257
10.8k
    SchemaChangeParams sc_params;
258
259
    // cache schema change output to file cache
260
10.8k
    std::vector<RowsetSharedPtr> rowsets;
261
10.8k
    rowsets.resize(rs_splits.size());
262
10.8k
    std::transform(rs_splits.begin(), rs_splits.end(), rowsets.begin(),
263
10.8k
                   [](RowSetSplits& split) { return split.rs_reader->rowset(); });
264
10.8k
    sc_params.output_to_file_cache = _should_cache_sc_output(rowsets);
265
10.8k
    if (request.__isset.query_globals && request.__isset.query_options) {
266
10.8k
        sc_params.runtime_state =
267
10.8k
                std::make_shared<RuntimeState>(request.query_options, request.query_globals);
268
10.8k
    } else {
269
        // for old version request compatibility
270
4
        sc_params.runtime_state = std::make_shared<RuntimeState>();
271
4
    }
272
273
10.8k
    RETURN_IF_ERROR(DescriptorTbl::create(&sc_params.pool, request.desc_tbl, &sc_params.desc_tbl));
274
10.8k
    sc_params.ref_rowset_readers.reserve(rs_splits.size());
275
10.8k
    for (RowSetSplits& split : rs_splits) {
276
9.99k
        sc_params.ref_rowset_readers.emplace_back(std::move(split.rs_reader));
277
9.99k
    }
278
10.8k
    sc_params.delete_handler = &delete_handler;
279
10.8k
    sc_params.be_exec_version = request.be_exec_version;
280
10.8k
    DCHECK(request.__isset.alter_tablet_type);
281
10.8k
    switch (request.alter_tablet_type) {
282
2.25k
    case TAlterTabletType::SCHEMA_CHANGE:
283
2.25k
        sc_params.alter_tablet_type = AlterTabletType::SCHEMA_CHANGE;
284
2.25k
        break;
285
8.51k
    case TAlterTabletType::ROLLUP:
286
8.51k
        sc_params.alter_tablet_type = AlterTabletType::ROLLUP;
287
8.51k
        break;
288
0
    case TAlterTabletType::MIGRATION:
289
0
        sc_params.alter_tablet_type = AlterTabletType::MIGRATION;
290
0
        break;
291
10.8k
    }
292
10.7k
    sc_params.vault_id = request.storage_vault_id;
293
10.7k
    if (!request.__isset.materialized_view_params) {
294
3.53k
        return _convert_historical_rowsets(sc_params, job);
295
3.53k
    }
296
27.7k
    for (auto item : request.materialized_view_params) {
297
27.7k
        AlterMaterializedViewParam mv_param;
298
27.7k
        mv_param.column_name = item.column_name;
299
        /*
300
         * origin_column_name is always be set now,
301
         * but origin_column_name may be not set in some materialized view function. eg:count(1)
302
        */
303
27.7k
        if (item.__isset.origin_column_name) {
304
0
            mv_param.origin_column_name = item.origin_column_name;
305
0
        }
306
307
27.9k
        if (item.__isset.mv_expr) {
308
27.9k
            mv_param.expr = std::make_shared<TExpr>(item.mv_expr);
309
27.9k
        }
310
27.7k
        sc_params.materialized_params_map.insert(
311
27.7k
                std::make_pair(to_lower(item.column_name), mv_param));
312
27.7k
    }
313
7.19k
    sc_params.enable_unique_key_merge_on_write = _new_tablet->enable_unique_key_merge_on_write();
314
7.19k
    return _convert_historical_rowsets(sc_params, job);
315
10.7k
}
316
317
Status CloudSchemaChangeJob::_convert_historical_rowsets(const SchemaChangeParams& sc_params,
318
10.7k
                                                         cloud::TabletJobInfoPB& job) {
319
10.7k
    LOG(INFO) << "Begin to convert historical rowsets for new_tablet from base_tablet. base_tablet="
320
10.7k
              << _base_tablet->tablet_id() << ", new_tablet=" << _new_tablet->tablet_id()
321
10.7k
              << ", job_id=" << _job_id;
322
323
    // Add filter information in change, and filter column information will be set in _parse_request
324
    // And filter some data every time the row block changes
325
10.7k
    BlockChanger changer(_new_tablet->tablet_schema(), *sc_params.desc_tbl,
326
10.7k
                         sc_params.runtime_state);
327
328
10.7k
    bool sc_sorting = false;
329
10.7k
    bool sc_directly = false;
330
331
    // 1. Parse the Alter request and convert it into an internal representation
332
10.7k
    RETURN_IF_ERROR(SchemaChangeJob::parse_request(sc_params, _base_tablet_schema.get(),
333
10.7k
                                                   _new_tablet_schema.get(), &changer, &sc_sorting,
334
10.7k
                                                   &sc_directly));
335
10.7k
    if (!sc_sorting && !sc_directly && sc_params.alter_tablet_type == AlterTabletType::ROLLUP) {
336
0
        LOG(INFO) << "Don't support to add materialized view by linked schema change";
337
0
        return Status::InternalError(
338
0
                "Don't support to add materialized view by linked schema change");
339
0
    }
340
341
10.7k
    LOG(INFO) << "schema change type, sc_sorting: " << sc_sorting
342
10.7k
              << ", sc_directly: " << sc_directly << ", base_tablet=" << _base_tablet->tablet_id()
343
10.7k
              << ", new_tablet=" << _new_tablet->tablet_id();
344
345
    // 2. Generate historical data converter
346
10.7k
    auto sc_procedure = get_sc_procedure(
347
10.7k
            changer, sc_sorting,
348
10.7k
            _cloud_storage_engine.memory_limitation_bytes_per_thread_for_schema_change());
349
350
10.7k
    DBUG_EXECUTE_IF("CloudSchemaChangeJob::_convert_historical_rowsets.block", DBUG_BLOCK);
351
352
    // 3. Convert historical data
353
10.7k
    bool already_exist_any_version = false;
354
10.7k
    for (const auto& rs_reader : sc_params.ref_rowset_readers) {
355
9.75k
        VLOG_TRACE << "Begin to convert a history rowset. version=" << rs_reader->version();
356
357
9.75k
        RowsetWriterContext context;
358
9.75k
        context.txn_id = rs_reader->rowset()->txn_id();
359
9.75k
        context.txn_expiration = _expiration;
360
9.75k
        context.version = rs_reader->version();
361
9.75k
        context.rowset_state = VISIBLE;
362
9.75k
        context.segments_overlap = rs_reader->rowset()->rowset_meta()->segments_overlap();
363
9.75k
        context.tablet_schema = _new_tablet->tablet_schema();
364
9.75k
        context.newest_write_timestamp = rs_reader->newest_write_timestamp();
365
9.75k
        context.storage_resource = _cloud_storage_engine.get_storage_resource(sc_params.vault_id);
366
9.75k
        context.job_id = _job_id;
367
9.75k
        context.write_file_cache = sc_params.output_to_file_cache;
368
9.75k
        context.tablet = _new_tablet;
369
9.75k
        if (!context.storage_resource) {
370
0
            return Status::InternalError("vault id not found, maybe not sync, vault id {}",
371
0
                                         sc_params.vault_id);
372
0
        }
373
374
9.75k
        context.write_type = DataWriteType::TYPE_SCHEMA_CHANGE;
375
        // TODO if support VerticalSegmentWriter, also need to handle cluster key primary key index
376
9.75k
        bool vertical = false;
377
9.75k
        if (sc_sorting && !_new_tablet->tablet_schema()->cluster_key_uids().empty()) {
378
            // see VBaseSchemaChangeWithSorting::_external_sorting
379
0
            vertical = true;
380
0
        }
381
9.75k
        auto rowset_writer = DORIS_TRY(_new_tablet->create_rowset_writer(context, vertical));
382
383
9.75k
        RowsetMetaSharedPtr existed_rs_meta;
384
9.75k
        auto st = _cloud_storage_engine.meta_mgr().prepare_rowset(*rowset_writer->rowset_meta(),
385
9.75k
                                                                  _job_id, &existed_rs_meta);
386
9.75k
        if (!st.ok()) {
387
0
            if (st.is<ALREADY_EXIST>()) {
388
0
                LOG(INFO) << "Rowset " << rs_reader->version() << " has already existed in tablet "
389
0
                          << _new_tablet->tablet_id();
390
                // Add already committed rowset to _output_rowsets.
391
0
                DCHECK(existed_rs_meta != nullptr);
392
0
                RowsetSharedPtr rowset;
393
                // schema is nullptr implies using RowsetMeta.tablet_schema
394
0
                RETURN_IF_ERROR(
395
0
                        RowsetFactory::create_rowset(nullptr, "", existed_rs_meta, &rowset));
396
0
                _output_rowsets.push_back(std::move(rowset));
397
0
                already_exist_any_version = true;
398
0
                continue;
399
0
            } else {
400
0
                return st;
401
0
            }
402
0
        }
403
404
9.75k
        st = sc_procedure->process(rs_reader, rowset_writer.get(), _new_tablet, _base_tablet,
405
9.75k
                                   _base_tablet_schema, _new_tablet_schema);
406
9.75k
        if (!st.ok()) {
407
76
            return Status::InternalError(
408
76
                    "failed to process schema change on rowset, version=[{}-{}], status={}",
409
76
                    rs_reader->version().first, rs_reader->version().second, st.to_string());
410
76
        }
411
412
9.67k
        RowsetSharedPtr new_rowset;
413
9.67k
        st = rowset_writer->build(new_rowset);
414
9.67k
        if (!st.ok()) {
415
0
            return Status::InternalError("failed to build rowset, version=[{}-{}] status={}",
416
0
                                         rs_reader->version().first, rs_reader->version().second,
417
0
                                         st.to_string());
418
0
        }
419
420
9.67k
        st = _cloud_storage_engine.meta_mgr().commit_rowset(*rowset_writer->rowset_meta(), _job_id,
421
9.67k
                                                            &existed_rs_meta);
422
9.67k
        if (!st.ok()) {
423
0
            if (st.is<ALREADY_EXIST>()) {
424
0
                LOG(INFO) << "Rowset " << rs_reader->version() << " has already existed in tablet "
425
0
                          << _new_tablet->tablet_id();
426
                // Add already committed rowset to _output_rowsets.
427
0
                DCHECK(existed_rs_meta != nullptr);
428
0
                RowsetSharedPtr rowset;
429
                // schema is nullptr implies using RowsetMeta.tablet_schema
430
0
                RETURN_IF_ERROR(
431
0
                        RowsetFactory::create_rowset(nullptr, "", existed_rs_meta, &rowset));
432
0
                _output_rowsets.push_back(std::move(rowset));
433
0
                continue;
434
0
            } else {
435
0
                return st;
436
0
            }
437
0
        }
438
9.67k
        _output_rowsets.push_back(std::move(new_rowset));
439
440
9.67k
        VLOG_TRACE << "Successfully convert a history version " << rs_reader->version();
441
9.67k
    }
442
10.6k
    auto* sc_job = job.mutable_schema_change();
443
10.6k
    if (!sc_params.ref_rowset_readers.empty()) {
444
5.20k
        int64_t num_output_rows = 0;
445
5.20k
        int64_t size_output_rowsets = 0;
446
5.20k
        int64_t num_output_segments = 0;
447
5.20k
        int64_t index_size_output_rowsets = 0;
448
5.20k
        int64_t segment_size_output_rowsets = 0;
449
9.62k
        for (auto& rs : _output_rowsets) {
450
9.62k
            sc_job->add_txn_ids(rs->txn_id());
451
9.62k
            sc_job->add_output_versions(rs->end_version());
452
9.62k
            num_output_rows += rs->num_rows();
453
9.62k
            size_output_rowsets += rs->total_disk_size();
454
9.62k
            num_output_segments += rs->num_segments();
455
9.62k
            index_size_output_rowsets += rs->index_disk_size();
456
9.62k
            segment_size_output_rowsets += rs->data_disk_size();
457
9.62k
        }
458
5.20k
        sc_job->set_num_output_rows(num_output_rows);
459
5.20k
        sc_job->set_size_output_rowsets(size_output_rowsets);
460
5.20k
        sc_job->set_num_output_segments(num_output_segments);
461
5.20k
        sc_job->set_num_output_rowsets(_output_rowsets.size());
462
5.20k
        sc_job->set_index_size_output_rowsets(index_size_output_rowsets);
463
5.20k
        sc_job->set_segment_size_output_rowsets(segment_size_output_rowsets);
464
5.20k
    }
465
10.6k
    _output_cumulative_point = std::min(_output_cumulative_point, sc_job->alter_version() + 1);
466
10.6k
    sc_job->set_output_cumulative_point(_output_cumulative_point);
467
468
10.6k
    DBUG_EXECUTE_IF("CloudSchemaChangeJob.process_alter_tablet.sleep", DBUG_BLOCK);
469
    // process delete bitmap if the table is MOW
470
10.6k
    bool has_stop_token {false};
471
10.6k
    bool should_clear_stop_token {true};
472
10.6k
    Defer defer {[&]() {
473
10.5k
        if (has_stop_token) {
474
1.20k
            static_cast<void>(_cloud_storage_engine.unregister_compaction_stop_token(
475
1.20k
                    _new_tablet, should_clear_stop_token));
476
1.20k
        }
477
10.5k
    }};
478
10.6k
    if (_new_tablet->enable_unique_key_merge_on_write()) {
479
1.20k
        has_stop_token = true;
480
        // If there are historical versions of rowsets, we need to recalculate their delete
481
        // bitmaps, otherwise we will miss the delete bitmaps of incremental rowsets
482
1.20k
        int64_t start_calc_delete_bitmap_version =
483
                // [0-1] is a placeholder rowset, start from 2.
484
1.20k
                already_exist_any_version ? 2 : sc_job->alter_version() + 1;
485
1.20k
        RETURN_IF_ERROR(_process_delete_bitmap(sc_job->alter_version(),
486
1.20k
                                               start_calc_delete_bitmap_version, _initiator,
487
1.20k
                                               sc_params.vault_id));
488
1.20k
        sc_job->set_delete_bitmap_lock_initiator(_initiator);
489
1.20k
    }
490
491
10.6k
    cloud::FinishTabletJobResponse finish_resp;
492
10.6k
    DBUG_EXECUTE_IF("CloudSchemaChangeJob::_convert_historical_rowsets.test_conflict", {
493
10.6k
        std::srand(static_cast<unsigned int>(std::time(nullptr)));
494
10.6k
        int random_value = std::rand() % 100;
495
10.6k
        if (random_value < 20) {
496
10.6k
            return Status::Error<ErrorCode::DELETE_BITMAP_LOCK_ERROR>("test txn conflict");
497
10.6k
        }
498
10.6k
    });
499
10.6k
    DBUG_EXECUTE_IF("CloudSchemaChangeJob::_convert_historical_rowsets.fail.before.commit_job", {
500
10.6k
        LOG_INFO("inject retryable error before commit sc job, tablet={}",
501
10.6k
                 _new_tablet->tablet_id());
502
10.6k
        return Status::Error<ErrorCode::DELETE_BITMAP_LOCK_ERROR>("injected retryable error");
503
10.6k
    });
504
10.6k
    DBUG_EXECUTE_IF("CloudSchemaChangeJob::_convert_historical_rowsets.before.commit_job",
505
10.6k
                    DBUG_BLOCK);
506
10.6k
    auto st = _cloud_storage_engine.meta_mgr().commit_tablet_job(job, &finish_resp);
507
10.6k
    if (!st.ok()) {
508
0
        if (finish_resp.status().code() == cloud::JOB_ALREADY_SUCCESS) {
509
0
            st = _new_tablet->sync_rowsets();
510
0
            if (!st.ok()) {
511
0
                LOG_WARNING("failed to sync new tablet")
512
0
                        .tag("tablet_id", _new_tablet->tablet_id())
513
0
                        .error(st);
514
0
            }
515
0
            return Status::OK();
516
0
        }
517
0
        return st;
518
10.6k
    } else {
519
10.6k
        should_clear_stop_token = false;
520
10.6k
    }
521
10.6k
    const auto& stats = finish_resp.stats();
522
10.6k
    {
523
        // to prevent the converted historical rowsets be replaced by rowsets written on new tablet
524
        // during double write phase by `CloudMetaMgr::sync_tablet_rowsets` in another thread
525
10.6k
        std::unique_lock lock {_new_tablet->get_sync_meta_lock()};
526
10.6k
        std::unique_lock wlock(_new_tablet->get_header_lock());
527
10.6k
        _new_tablet->add_rowsets(std::move(_output_rowsets), true, wlock, false);
528
10.6k
        _new_tablet->set_cumulative_layer_point(_output_cumulative_point);
529
10.6k
        _new_tablet->reset_approximate_stats(stats.num_rowsets(), stats.num_segments(),
530
10.6k
                                             stats.num_rows(), stats.data_size());
531
10.6k
        RETURN_IF_ERROR(_new_tablet->set_tablet_state(TABLET_RUNNING));
532
10.6k
    }
533
10.6k
    return Status::OK();
534
10.6k
}
535
536
Status CloudSchemaChangeJob::_process_delete_bitmap(int64_t alter_version,
537
                                                    int64_t start_calc_delete_bitmap_version,
538
                                                    int64_t initiator,
539
1.20k
                                                    const std::string& vault_id) {
540
1.20k
    LOG_INFO("process mow table")
541
1.20k
            .tag("new_tablet_id", _new_tablet->tablet_id())
542
1.20k
            .tag("out_rowset_size", _output_rowsets.size())
543
1.20k
            .tag("start_calc_delete_bitmap_version", start_calc_delete_bitmap_version)
544
1.20k
            .tag("alter_version", alter_version);
545
1.20k
    RETURN_IF_ERROR(_cloud_storage_engine.register_compaction_stop_token(_new_tablet, initiator));
546
1.20k
    TabletMetaSharedPtr tmp_meta = std::make_shared<TabletMeta>(*(_new_tablet->tablet_meta()));
547
1.20k
    tmp_meta->delete_bitmap().delete_bitmap.clear();
548
    // Keep only version [0-1] rowset, other rowsets will be added in _output_rowsets
549
1.20k
    auto& rs_metas = tmp_meta->all_mutable_rs_metas();
550
2.41k
    for (auto it = rs_metas.begin(); it != rs_metas.end();) {
551
1.21k
        const auto& rs_meta = it->second;
552
1.21k
        if (rs_meta->version().first == 0 && rs_meta->version().second == 1) {
553
1.20k
            ++it;
554
1.20k
        } else {
555
9
            it = rs_metas.erase(it);
556
9
        }
557
1.21k
    }
558
559
1.20k
    std::shared_ptr<CloudTablet> tmp_tablet =
560
1.20k
            std::make_shared<CloudTablet>(_cloud_storage_engine, tmp_meta);
561
1.20k
    {
562
1.20k
        std::unique_lock wlock(tmp_tablet->get_header_lock());
563
1.20k
        tmp_tablet->add_rowsets(_output_rowsets, true, wlock, false);
564
        // Set alter version to let the tmp_tablet can fill hole rowset greater than alter_version
565
1.20k
        tmp_tablet->set_alter_version(alter_version);
566
1.20k
    }
567
568
    // step 1, process incremental rowset without delete bitmap update lock
569
1.20k
    RETURN_IF_ERROR(_cloud_storage_engine.meta_mgr().sync_tablet_rowsets(tmp_tablet.get()));
570
1.20k
    int64_t max_version = tmp_tablet->max_version().second;
571
1.20k
    LOG(INFO) << "alter table for mow table, calculate delete bitmap of "
572
1.20k
              << "incremental rowsets without lock, version: " << start_calc_delete_bitmap_version
573
1.20k
              << "-" << max_version << " new_table_id: " << _new_tablet->tablet_id();
574
1.20k
    if (max_version >= start_calc_delete_bitmap_version) {
575
5
        auto ret = DORIS_TRY(tmp_tablet->capture_consistent_rowsets_unlocked(
576
5
                {start_calc_delete_bitmap_version, max_version}, CaptureRowsetOps {}));
577
5
        DBUG_EXECUTE_IF("CloudSchemaChangeJob::_process_delete_bitmap.after.capture_without_lock",
578
5
                        DBUG_BLOCK);
579
5
        {
580
5
            std::unique_lock wlock(tmp_tablet->get_header_lock());
581
5
            tmp_tablet->add_rowsets(_output_rowsets, true, wlock, false);
582
5
        }
583
11
        for (auto rowset : ret.rowsets) {
584
11
            RETURN_IF_ERROR(CloudTablet::update_delete_bitmap_without_lock(tmp_tablet, rowset));
585
11
        }
586
5
    }
587
588
1.20k
    DBUG_EXECUTE_IF("CloudSchemaChangeJob::_process_delete_bitmap.before_new_inc.block",
589
1.20k
                    DBUG_BLOCK);
590
591
    // step 2, process incremental rowset with delete bitmap update lock
592
1.20k
    RETURN_IF_ERROR(_cloud_storage_engine.meta_mgr().get_delete_bitmap_update_lock(
593
1.20k
            *_new_tablet, SCHEMA_CHANGE_DELETE_BITMAP_LOCK_ID, initiator));
594
1.20k
    RETURN_IF_ERROR(_cloud_storage_engine.meta_mgr().sync_tablet_rowsets(tmp_tablet.get()));
595
1.20k
    int64_t new_max_version = tmp_tablet->max_version().second;
596
1.20k
    LOG(INFO) << "alter table for mow table, calculate delete bitmap of "
597
1.20k
              << "incremental rowsets with lock, version: " << max_version + 1 << "-"
598
1.20k
              << new_max_version << " new_tablet_id: " << _new_tablet->tablet_id();
599
1.20k
    if (new_max_version > max_version) {
600
0
        auto ret = DORIS_TRY(tmp_tablet->capture_consistent_rowsets_unlocked(
601
0
                {max_version + 1, new_max_version}, CaptureRowsetOps {}));
602
0
        {
603
0
            std::unique_lock wlock(tmp_tablet->get_header_lock());
604
0
            tmp_tablet->add_rowsets(_output_rowsets, true, wlock, false);
605
0
        }
606
0
        for (auto rowset : ret.rowsets) {
607
0
            RETURN_IF_ERROR(CloudTablet::update_delete_bitmap_without_lock(tmp_tablet, rowset));
608
0
        }
609
0
    }
610
611
1.20k
    DBUG_EXECUTE_IF("CloudSchemaChangeJob::_process_delete_bitmap.inject_sleep", {
612
1.20k
        auto p = dp->param("percent", 0.01);
613
1.20k
        auto sleep_time = dp->param("sleep", 100);
614
1.20k
        std::mt19937 gen {std::random_device {}()};
615
1.20k
        std::bernoulli_distribution inject_fault {p};
616
1.20k
        if (inject_fault(gen)) {
617
1.20k
            LOG_INFO("injection sleep for {} seconds, tablet_id={}, sc job_id={}", sleep_time,
618
1.20k
                     _new_tablet->tablet_id(), _job_id);
619
1.20k
            std::this_thread::sleep_for(std::chrono::seconds(sleep_time));
620
1.20k
        }
621
1.20k
    });
622
623
1.20k
    auto& delete_bitmap = tmp_tablet->tablet_meta()->delete_bitmap();
624
1.20k
    auto storage_resource = _cloud_storage_engine.get_storage_resource(vault_id);
625
    // step4, store delete bitmap
626
1.20k
    RETURN_IF_ERROR(_cloud_storage_engine.meta_mgr().update_delete_bitmap(
627
1.20k
            *_new_tablet, SCHEMA_CHANGE_DELETE_BITMAP_LOCK_ID, initiator, &delete_bitmap,
628
1.20k
            &delete_bitmap, "", storage_resource, config::delete_bitmap_store_write_version));
629
630
1.20k
    _new_tablet->tablet_meta()->delete_bitmap() = delete_bitmap;
631
1.20k
    return Status::OK();
632
1.20k
}
633
634
76
void CloudSchemaChangeJob::clean_up_on_failure() {
635
76
    if (_new_tablet == nullptr) {
636
0
        return;
637
0
    }
638
76
    if (_new_tablet->keys_type() == KeysType::UNIQUE_KEYS &&
639
76
        _new_tablet->enable_unique_key_merge_on_write()) {
640
19
        _cloud_storage_engine.meta_mgr().remove_delete_bitmap_update_lock(
641
19
                _new_tablet->table_id(), SCHEMA_CHANGE_DELETE_BITMAP_LOCK_ID, _initiator,
642
19
                _new_tablet->tablet_id());
643
19
    }
644
76
    for (const auto& output_rs : _output_rowsets) {
645
37
        if (output_rs.use_count() > 2) {
646
0
            LOG(WARNING) << "Rowset " << output_rs->rowset_id().to_string() << " has "
647
0
                         << output_rs.use_count()
648
0
                         << " references. File Cache won't be recycled when query is using it.";
649
0
            return;
650
0
        }
651
37
        output_rs->clear_cache();
652
37
    }
653
76
}
654
655
bool CloudSchemaChangeJob::_should_cache_sc_output(
656
10.5k
        const std::vector<RowsetSharedPtr>& input_rowsets) {
657
10.5k
    int64_t total_size = 0;
658
10.5k
    int64_t cached_index_size = 0;
659
10.5k
    int64_t cached_data_size = 0;
660
661
10.5k
    for (const auto& rs : input_rowsets) {
662
9.99k
        const RowsetMetaSharedPtr& rs_meta = rs->rowset_meta();
663
9.99k
        total_size += rs_meta->total_disk_size();
664
9.99k
        cached_index_size += rs->approximate_cache_index_size();
665
9.99k
        cached_data_size += rs->approximate_cached_data_size();
666
9.99k
    }
667
668
10.5k
    double input_hit_rate = static_cast<double>(cached_index_size + cached_data_size) / total_size;
669
670
10.5k
    LOG(INFO) << "CloudSchemaChangeJob check cache sc output strategy. "
671
10.5k
              << "job_id=" << _job_id << ", input_rowsets_count=" << input_rowsets.size()
672
10.5k
              << ", total_size=" << total_size << ", cached_index_size=" << cached_index_size
673
10.5k
              << ", cached_data_size=" << cached_data_size << ", input_hit_rate=" << input_hit_rate
674
10.5k
              << ", min_hit_ratio_threshold="
675
10.5k
              << config::file_cache_keep_schema_change_output_min_hit_ratio << ", should_cache="
676
10.5k
              << (input_hit_rate > config::file_cache_keep_schema_change_output_min_hit_ratio);
677
678
10.5k
    if (input_hit_rate > config::file_cache_keep_schema_change_output_min_hit_ratio) {
679
1.59k
        return true;
680
1.59k
    }
681
682
8.97k
    return false;
683
10.5k
}
684
685
} // namespace doris