Coverage Report

Created: 2025-06-13 18:17

/root/doris/be/src/runtime/runtime_state.h
Line
Count
Source (jump to first uncovered line)
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
// This file is copied from
18
// https://github.com/apache/impala/blob/branch-2.9.0/be/src/runtime/runtime-state.h
19
// and modified by Doris
20
21
#pragma once
22
23
#include <gen_cpp/PaloInternalService_types.h>
24
#include <gen_cpp/Types_types.h>
25
#include <gen_cpp/segment_v2.pb.h>
26
#include <stdint.h>
27
28
#include <atomic>
29
#include <cstdint>
30
#include <fstream>
31
#include <functional>
32
#include <memory>
33
#include <mutex>
34
#include <shared_mutex>
35
#include <string>
36
#include <utility>
37
#include <vector>
38
39
#include "agent/be_exec_version_manager.h"
40
#include "cctz/time_zone.h"
41
#include "common/be_mock_util.h"
42
#include "common/compiler_util.h" // IWYU pragma: keep
43
#include "common/config.h"
44
#include "common/factory_creator.h"
45
#include "common/status.h"
46
#include "io/fs/file_system.h"
47
#include "io/fs/s3_file_system.h"
48
#include "runtime/task_execution_context.h"
49
#include "runtime/workload_group/workload_group.h"
50
#include "util/debug_util.h"
51
#include "util/runtime_profile.h"
52
53
namespace doris {
54
class RuntimeFilter;
55
56
23
inline int32_t get_execution_rpc_timeout_ms(int32_t execution_timeout_sec) {
57
23
    return std::min(config::execution_max_rpc_timeout_sec, execution_timeout_sec) * 1000;
58
23
}
59
60
namespace pipeline {
61
class PipelineXLocalStateBase;
62
class PipelineXSinkLocalStateBase;
63
class PipelineFragmentContext;
64
class PipelineTask;
65
class Dependency;
66
} // namespace pipeline
67
68
class DescriptorTbl;
69
class ObjectPool;
70
class ExecEnv;
71
class IdFileMap;
72
class RuntimeFilterMgr;
73
class MemTrackerLimiter;
74
class QueryContext;
75
class RuntimeFilterConsumer;
76
class RuntimeFilterProducer;
77
78
// A collection of items that are part of the global state of a
79
// query and shared across all execution nodes of that query.
80
class RuntimeState {
81
    ENABLE_FACTORY_CREATOR(RuntimeState);
82
83
public:
84
    RuntimeState(const TPlanFragmentExecParams& fragment_exec_params,
85
                 const TQueryOptions& query_options, const TQueryGlobals& query_globals,
86
                 ExecEnv* exec_env, QueryContext* ctx,
87
                 const std::shared_ptr<MemTrackerLimiter>& query_mem_tracker = nullptr);
88
89
    RuntimeState(const TUniqueId& instance_id, const TUniqueId& query_id, int32 fragment_id,
90
                 const TQueryOptions& query_options, const TQueryGlobals& query_globals,
91
                 ExecEnv* exec_env, QueryContext* ctx);
92
93
    // Used by pipeline. This runtime state is only used for setup.
94
    RuntimeState(const TUniqueId& query_id, int32 fragment_id, const TQueryOptions& query_options,
95
                 const TQueryGlobals& query_globals, ExecEnv* exec_env, QueryContext* ctx);
96
97
    // Only used in the materialization phase of delayed materialization,
98
    // when there may be no corresponding QueryContext.
99
    RuntimeState(const TUniqueId& query_id, int32 fragment_id, const TQueryOptions& query_options,
100
                 const TQueryGlobals& query_globals, ExecEnv* exec_env);
101
102
    // RuntimeState for executing expr in fe-support.
103
    RuntimeState(const TQueryGlobals& query_globals);
104
105
    // for job task only
106
    RuntimeState();
107
108
    // Empty d'tor to avoid issues with unique_ptr.
109
    MOCK_DEFINE(virtual) ~RuntimeState();
110
111
    // Set per-query state.
112
    Status init(const TUniqueId& fragment_instance_id, const TQueryOptions& query_options,
113
                const TQueryGlobals& query_globals, ExecEnv* exec_env);
114
115
    // for ut and non-query.
116
0
    void set_exec_env(ExecEnv* exec_env) { _exec_env = exec_env; }
117
118
    // for ut and non-query.
119
    void init_mem_trackers(const std::string& name = "ut", const TUniqueId& id = TUniqueId());
120
121
280k
    const TQueryOptions& query_options() const { return _query_options; }
122
8
    int64_t scan_queue_mem_limit() const {
123
8
        return _query_options.__isset.scan_queue_mem_limit ? _query_options.scan_queue_mem_limit
124
8
                                                           : _query_options.mem_limit / 20;
125
8
    }
126
127
6
    int32_t max_column_reader_num() const {
128
6
        return _query_options.__isset.max_column_reader_num ? _query_options.max_column_reader_num
129
6
                                                            : 20000;
130
6
    }
131
132
82.3k
    ObjectPool* obj_pool() const { return _obj_pool.get(); }
133
134
592k
    const DescriptorTbl& desc_tbl() const { return *_desc_tbl; }
135
160k
    void set_desc_tbl(const DescriptorTbl* desc_tbl) { _desc_tbl = desc_tbl; }
136
54
    MOCK_FUNCTION int batch_size() const { return _query_options.batch_size; }
137
8
    int query_parallel_instance_num() const { return _query_options.parallel_instance; }
138
0
    int max_errors() const { return _query_options.max_errors; }
139
28
    int execution_timeout() const {
140
28
        return _query_options.__isset.execution_timeout ? _query_options.execution_timeout
141
28
                                                        : _query_options.query_timeout;
142
28
    }
143
6
    int num_scanner_threads() const {
144
6
        return _query_options.__isset.num_scanner_threads ? _query_options.num_scanner_threads : 0;
145
6
    }
146
14
    int min_scan_concurrency_of_scan_scheduler() const {
147
14
        return _query_options.__isset.min_scan_scheduler_concurrency
148
14
                       ? _query_options.min_scan_scheduler_concurrency
149
14
                       : 0;
150
14
    }
151
152
14
    int min_scan_concurrency_of_scanner() const {
153
14
        return _query_options.__isset.min_scanner_concurrency
154
14
                       ? _query_options.min_scanner_concurrency
155
14
                       : 1;
156
14
    }
157
158
0
    TQueryType::type query_type() const { return _query_options.query_type; }
159
22
    int64_t timestamp_ms() const { return _timestamp_ms; }
160
0
    int32_t nano_seconds() const { return _nano_seconds; }
161
    // if possible, use timezone_obj() rather than timezone()
162
23
    const std::string& timezone() const { return _timezone; }
163
210
    const cctz::time_zone& timezone_obj() const { return _timezone_obj; }
164
0
    const std::string& user() const { return _user; }
165
545
    const TUniqueId& query_id() const { return _query_id; }
166
36.6k
    const TUniqueId& fragment_instance_id() const { return _fragment_instance_id; }
167
    // should only be called in pipeline engine
168
42
    int32_t fragment_id() const { return _fragment_id; }
169
67
    ExecEnv* exec_env() { return _exec_env; }
170
    std::shared_ptr<MemTrackerLimiter> query_mem_tracker() const;
171
172
    // Returns runtime state profile
173
4
    RuntimeProfile* runtime_profile() { return &_profile; }
174
0
    RuntimeProfile* load_channel_profile() { return &_load_channel_profile; }
175
176
1
    bool enable_function_pushdown() const {
177
1
        return _query_options.__isset.enable_function_pushdown &&
178
1
               _query_options.enable_function_pushdown;
179
1
    }
180
181
67
    bool check_overflow_for_decimal() const {
182
67
        return _query_options.__isset.check_overflow_for_decimal &&
183
67
               _query_options.check_overflow_for_decimal;
184
67
    }
185
186
89
    bool enable_decimal256() const {
187
89
        return _query_options.__isset.enable_decimal256 && _query_options.enable_decimal256;
188
89
    }
189
190
0
    bool enable_common_expr_pushdown() const {
191
0
        return _query_options.__isset.enable_common_expr_pushdown &&
192
0
               _query_options.enable_common_expr_pushdown;
193
0
    }
194
195
0
    bool enable_common_expr_pushdown_for_inverted_index() const {
196
0
        return enable_common_expr_pushdown() &&
197
0
               _query_options.__isset.enable_common_expr_pushdown_for_inverted_index &&
198
0
               _query_options.enable_common_expr_pushdown_for_inverted_index;
199
0
    };
200
201
0
    bool mysql_row_binary_format() const {
202
0
        return _query_options.__isset.mysql_row_binary_format &&
203
0
               _query_options.mysql_row_binary_format;
204
0
    }
205
206
0
    bool enable_short_circuit_query_access_column_store() const {
207
0
        return _query_options.__isset.enable_short_circuit_query_access_column_store &&
208
0
               _query_options.enable_short_circuit_query_access_column_store;
209
0
    }
210
211
    // Appends error to the _error_log if there is space
212
    bool log_error(const std::string& error);
213
214
    // Returns true if the error log has not reached _max_errors.
215
0
    bool log_has_space() {
216
0
        std::lock_guard<std::mutex> l(_error_log_lock);
217
0
        return _error_log.size() < _query_options.max_errors;
218
0
    }
219
220
    // Append all _error_log[_unreported_error_idx+] to new_errors and set
221
    // _unreported_error_idx to _errors_log.size()
222
    void get_unreported_errors(std::vector<std::string>* new_errors);
223
224
    [[nodiscard]] MOCK_FUNCTION bool is_cancelled() const;
225
    MOCK_FUNCTION Status cancel_reason() const;
226
0
    void cancel(const Status& reason) {
227
0
        if (_exec_status.update(reason)) {
228
            // Create a error status, so that we could print error stack, and
229
            // we could know which path call cancel.
230
0
            LOG(WARNING) << "Task is cancelled, instance: "
231
0
                         << PrintInstanceStandardInfo(_query_id, _fragment_instance_id)
232
0
                         << ", st = " << reason;
233
0
        } else {
234
0
            LOG(WARNING) << "Task is already cancelled, instance: "
235
0
                         << PrintInstanceStandardInfo(_query_id, _fragment_instance_id)
236
0
                         << ", original cancel msg: " << _exec_status.status()
237
0
                         << ", new cancel msg: " << reason;
238
0
        }
239
0
    }
240
241
0
    void set_backend_id(int64_t backend_id) { _backend_id = backend_id; }
242
0
    int64_t backend_id() const { return _backend_id; }
243
244
46
    void set_be_number(int be_number) { _be_number = be_number; }
245
93
    int be_number(void) const { return _be_number; }
246
247
0
    std::vector<std::string>& output_files() { return _output_files; }
248
249
0
    void set_import_label(const std::string& import_label) { _import_label = import_label; }
250
251
0
    const std::vector<std::string>& export_output_files() const { return _export_output_files; }
252
253
0
    void add_export_output_file(const std::string& file) { _export_output_files.push_back(file); }
254
255
0
    void set_db_name(const std::string& db_name) { _db_name = db_name; }
256
257
0
    const std::string& db_name() { return _db_name; }
258
259
0
    void set_wal_id(int64_t wal_id) { _wal_id = wal_id; }
260
261
3
    int64_t wal_id() const { return _wal_id; }
262
263
0
    void set_content_length(size_t content_length) { _content_length = content_length; }
264
265
0
    size_t content_length() const { return _content_length; }
266
267
0
    const std::string& import_label() { return _import_label; }
268
269
0
    const std::string& load_dir() const { return _load_dir; }
270
271
0
    void set_load_job_id(int64_t job_id) { _load_job_id = job_id; }
272
273
0
    int64_t load_job_id() const { return _load_job_id; }
274
275
    std::string get_error_log_file_path();
276
277
    // append error msg and error line to file when loading data.
278
    // is_summary is true, means we are going to write the summary line
279
    // If we need to stop the processing, set stop_processing to true
280
    Status append_error_msg_to_file(std::function<std::string()> line,
281
                                    std::function<std::string()> error_msg,
282
                                    bool is_summary = false);
283
284
0
    int64_t num_bytes_load_total() { return _num_bytes_load_total.load(); }
285
286
0
    int64_t num_finished_range() { return _num_finished_scan_range.load(); }
287
288
0
    int64_t num_rows_load_total() { return _num_rows_load_total.load(); }
289
290
0
    int64_t num_rows_load_filtered() { return _num_rows_load_filtered.load(); }
291
292
0
    int64_t num_rows_load_unselected() { return _num_rows_load_unselected.load(); }
293
294
0
    int64_t num_rows_filtered_in_strict_mode_partial_update() {
295
0
        return _num_rows_filtered_in_strict_mode_partial_update;
296
0
    }
297
298
0
    int64_t num_rows_load_success() {
299
0
        return num_rows_load_total() - num_rows_load_filtered() - num_rows_load_unselected();
300
0
    }
301
302
0
    void update_num_rows_load_total(int64_t num_rows) { _num_rows_load_total.fetch_add(num_rows); }
303
304
0
    void set_num_rows_load_total(int64_t num_rows) { _num_rows_load_total.store(num_rows); }
305
306
0
    void update_num_bytes_load_total(int64_t bytes_load) {
307
0
        _num_bytes_load_total.fetch_add(bytes_load);
308
0
    }
309
310
2
    void update_num_finished_scan_range(int64_t finished_range) {
311
2
        _num_finished_scan_range.fetch_add(finished_range);
312
2
    }
313
314
0
    void update_num_rows_load_filtered(int64_t num_rows) {
315
0
        _num_rows_load_filtered.fetch_add(num_rows);
316
0
    }
317
318
0
    void update_num_rows_load_unselected(int64_t num_rows) {
319
0
        _num_rows_load_unselected.fetch_add(num_rows);
320
0
    }
321
322
0
    void set_num_rows_filtered_in_strict_mode_partial_update(int64_t num_rows) {
323
0
        _num_rows_filtered_in_strict_mode_partial_update = num_rows;
324
0
    }
325
326
5
    void set_per_fragment_instance_idx(int idx) { _per_fragment_instance_idx = idx; }
327
328
15
    int per_fragment_instance_idx() const { return _per_fragment_instance_idx; }
329
330
5
    void set_num_per_fragment_instances(int num_instances) {
331
5
        _num_per_fragment_instances = num_instances;
332
5
    }
333
334
0
    int num_per_fragment_instances() const { return _num_per_fragment_instances; }
335
336
5
    void set_load_stream_per_node(int load_stream_per_node) {
337
5
        _load_stream_per_node = load_stream_per_node;
338
5
    }
339
340
0
    int load_stream_per_node() const { return _load_stream_per_node; }
341
342
5
    void set_total_load_streams(int total_load_streams) {
343
5
        _total_load_streams = total_load_streams;
344
5
    }
345
346
0
    int total_load_streams() const { return _total_load_streams; }
347
348
5
    void set_num_local_sink(int num_local_sink) { _num_local_sink = num_local_sink; }
349
350
0
    int num_local_sink() const { return _num_local_sink; }
351
352
0
    bool disable_stream_preaggregations() const {
353
0
        return _query_options.disable_stream_preaggregations;
354
0
    }
355
356
0
    int32_t runtime_filter_wait_time_ms() const {
357
0
        return _query_options.runtime_filter_wait_time_ms;
358
0
    }
359
360
0
    int32_t runtime_filter_max_in_num() const { return _query_options.runtime_filter_max_in_num; }
361
362
108
    int be_exec_version() const {
363
108
        DCHECK(_query_options.__isset.be_exec_version &&
364
108
               BeExecVersionManager::check_be_exec_version(_query_options.be_exec_version));
365
108
        return _query_options.be_exec_version;
366
108
    }
367
2
    bool enable_local_shuffle() const {
368
2
        return _query_options.__isset.enable_local_shuffle && _query_options.enable_local_shuffle;
369
2
    }
370
371
3
    MOCK_FUNCTION bool enable_local_exchange() const {
372
3
        return _query_options.__isset.enable_local_exchange && _query_options.enable_local_exchange;
373
3
    }
374
375
0
    bool trim_tailing_spaces_for_external_table_query() const {
376
0
        return _query_options.trim_tailing_spaces_for_external_table_query;
377
0
    }
378
379
0
    bool return_object_data_as_binary() const {
380
0
        return _query_options.return_object_data_as_binary;
381
0
    }
382
383
19
    segment_v2::CompressionTypePB fragement_transmission_compression_type() const {
384
19
        if (_query_options.__isset.fragment_transmission_compression_codec) {
385
0
            if (_query_options.fragment_transmission_compression_codec == "lz4") {
386
0
                return segment_v2::CompressionTypePB::LZ4;
387
0
            } else if (_query_options.fragment_transmission_compression_codec == "snappy") {
388
0
                return segment_v2::CompressionTypePB::SNAPPY;
389
0
            } else {
390
0
                return segment_v2::CompressionTypePB::NO_COMPRESSION;
391
0
            }
392
0
        }
393
19
        return segment_v2::CompressionTypePB::NO_COMPRESSION;
394
19
    }
395
396
0
    bool skip_storage_engine_merge() const {
397
0
        return _query_options.__isset.skip_storage_engine_merge &&
398
0
               _query_options.skip_storage_engine_merge;
399
0
    }
400
401
0
    bool skip_delete_predicate() const {
402
0
        return _query_options.__isset.skip_delete_predicate && _query_options.skip_delete_predicate;
403
0
    }
404
405
0
    bool skip_delete_bitmap() const {
406
0
        return _query_options.__isset.skip_delete_bitmap && _query_options.skip_delete_bitmap;
407
0
    }
408
409
0
    bool skip_missing_version() const {
410
0
        return _query_options.__isset.skip_missing_version && _query_options.skip_missing_version;
411
0
    }
412
413
6
    int64_t data_queue_max_blocks() const {
414
6
        return _query_options.__isset.data_queue_max_blocks ? _query_options.data_queue_max_blocks
415
6
                                                            : 1;
416
6
    }
417
418
    bool enable_page_cache() const;
419
420
0
    std::vector<TTabletCommitInfo> tablet_commit_infos() const {
421
0
        std::lock_guard<std::mutex> lock(_tablet_infos_mutex);
422
0
        return _tablet_commit_infos;
423
0
    }
424
425
0
    void add_tablet_commit_infos(std::vector<TTabletCommitInfo>& commit_infos) {
426
0
        std::lock_guard<std::mutex> lock(_tablet_infos_mutex);
427
0
        _tablet_commit_infos.insert(_tablet_commit_infos.end(),
428
0
                                    std::make_move_iterator(commit_infos.begin()),
429
0
                                    std::make_move_iterator(commit_infos.end()));
430
0
    }
431
432
0
    std::vector<TErrorTabletInfo> error_tablet_infos() const {
433
0
        std::lock_guard<std::mutex> lock(_tablet_infos_mutex);
434
0
        return _error_tablet_infos;
435
0
    }
436
437
0
    void add_error_tablet_infos(std::vector<TErrorTabletInfo>& tablet_infos) {
438
0
        std::lock_guard<std::mutex> lock(_tablet_infos_mutex);
439
0
        _error_tablet_infos.insert(_error_tablet_infos.end(),
440
0
                                   std::make_move_iterator(tablet_infos.begin()),
441
0
                                   std::make_move_iterator(tablet_infos.end()));
442
0
    }
443
444
0
    std::vector<THivePartitionUpdate> hive_partition_updates() const {
445
0
        std::lock_guard<std::mutex> lock(_hive_partition_updates_mutex);
446
0
        return _hive_partition_updates;
447
0
    }
448
449
0
    void add_hive_partition_updates(const THivePartitionUpdate& hive_partition_update) {
450
0
        std::lock_guard<std::mutex> lock(_hive_partition_updates_mutex);
451
0
        _hive_partition_updates.emplace_back(hive_partition_update);
452
0
    }
453
454
0
    std::vector<TIcebergCommitData> iceberg_commit_datas() const {
455
0
        std::lock_guard<std::mutex> lock(_iceberg_commit_datas_mutex);
456
0
        return _iceberg_commit_datas;
457
0
    }
458
459
0
    void add_iceberg_commit_datas(const TIcebergCommitData& iceberg_commit_data) {
460
0
        std::lock_guard<std::mutex> lock(_iceberg_commit_datas_mutex);
461
0
        _iceberg_commit_datas.emplace_back(iceberg_commit_data);
462
0
    }
463
464
    // local runtime filter mgr, the runtime filter do not have remote target or
465
    // not need local merge should regist here. the instance exec finish, the local
466
    // runtime filter mgr can release the memory of local runtime filter
467
83
    RuntimeFilterMgr* local_runtime_filter_mgr() { return _runtime_filter_mgr; }
468
469
    RuntimeFilterMgr* global_runtime_filter_mgr();
470
471
122
    void set_runtime_filter_mgr(RuntimeFilterMgr* runtime_filter_mgr) {
472
122
        _runtime_filter_mgr = runtime_filter_mgr;
473
122
    }
474
475
162k
    QueryContext* get_query_ctx() { return _query_ctx; }
476
477
    [[nodiscard]] bool low_memory_mode() const;
478
479
    std::weak_ptr<QueryContext> get_query_ctx_weak();
480
    MOCK_FUNCTION WorkloadGroupPtr workload_group();
481
482
0
    void set_query_mem_tracker(const std::shared_ptr<MemTrackerLimiter>& tracker) {
483
0
        _query_mem_tracker = tracker;
484
0
    }
485
486
4.08k
    void set_query_options(const TQueryOptions& query_options) { _query_options = query_options; }
487
488
0
    bool enable_profile() const {
489
0
        return _query_options.__isset.enable_profile && _query_options.enable_profile;
490
0
    }
491
492
0
    int rpc_verbose_profile_max_instance_count() const {
493
0
        return _query_options.__isset.rpc_verbose_profile_max_instance_count
494
0
                       ? _query_options.rpc_verbose_profile_max_instance_count
495
0
                       : 0;
496
0
    }
497
498
0
    MOCK_FUNCTION bool enable_share_hash_table_for_broadcast_join() const {
499
0
        return _query_options.__isset.enable_share_hash_table_for_broadcast_join &&
500
0
               _query_options.enable_share_hash_table_for_broadcast_join;
501
0
    }
502
503
0
    bool enable_parallel_scan() const {
504
0
        return _query_options.__isset.enable_parallel_scan && _query_options.enable_parallel_scan;
505
0
    }
506
507
0
    bool is_read_csv_empty_line_as_null() const {
508
0
        return _query_options.__isset.read_csv_empty_line_as_null &&
509
0
               _query_options.read_csv_empty_line_as_null;
510
0
    }
511
512
0
    int parallel_scan_max_scanners_count() const {
513
0
        return _query_options.__isset.parallel_scan_max_scanners_count
514
0
                       ? _query_options.parallel_scan_max_scanners_count
515
0
                       : 0;
516
0
    }
517
518
431
    int partition_topn_max_partitions() const {
519
431
        return _query_options.__isset.partition_topn_max_partitions
520
431
                       ? _query_options.partition_topn_max_partitions
521
431
                       : 1024;
522
431
    }
523
524
0
    int partition_topn_per_partition_rows() const {
525
0
        return _query_options.__isset.partition_topn_pre_partition_rows
526
0
                       ? _query_options.partition_topn_pre_partition_rows
527
0
                       : 1000;
528
0
    }
529
530
0
    int64_t parallel_scan_min_rows_per_scanner() const {
531
0
        return _query_options.__isset.parallel_scan_min_rows_per_scanner
532
0
                       ? _query_options.parallel_scan_min_rows_per_scanner
533
0
                       : 0;
534
0
    }
535
536
0
    void set_be_exec_version(int32_t version) noexcept { _query_options.be_exec_version = version; }
537
538
    using LocalState = doris::pipeline::PipelineXLocalStateBase;
539
    using SinkLocalState = doris::pipeline::PipelineXSinkLocalStateBase;
540
    // get result can return an error message, and we will only call it during the prepare.
541
    void emplace_local_state(int id, std::unique_ptr<LocalState> state);
542
543
    LocalState* get_local_state(int id);
544
    Result<LocalState*> get_local_state_result(int id);
545
546
    void emplace_sink_local_state(int id, std::unique_ptr<SinkLocalState> state);
547
548
    SinkLocalState* get_sink_local_state();
549
550
    Result<SinkLocalState*> get_sink_local_state_result();
551
552
    void resize_op_id_to_local_state(int operator_size);
553
554
    std::vector<std::shared_ptr<RuntimeProfile>> pipeline_id_to_profile();
555
556
    std::vector<std::shared_ptr<RuntimeProfile>> build_pipeline_profile(std::size_t pipeline_size);
557
558
78.5k
    void set_task_execution_context(std::shared_ptr<TaskExecutionContext> context) {
559
78.5k
        _task_execution_context_inited = true;
560
78.5k
        _task_execution_context = context;
561
78.5k
    }
562
563
159
    std::weak_ptr<TaskExecutionContext> get_task_execution_context() {
564
159
        CHECK(_task_execution_context_inited)
565
0
                << "_task_execution_context_inited == false, the ctx is not inited";
566
159
        return _task_execution_context;
567
159
    }
568
569
    Status register_producer_runtime_filter(
570
            const doris::TRuntimeFilterDesc& desc,
571
            std::shared_ptr<RuntimeFilterProducer>* producer_filter);
572
573
    Status register_consumer_runtime_filter(
574
            const doris::TRuntimeFilterDesc& desc, bool need_local_merge, int node_id,
575
            std::shared_ptr<RuntimeFilterConsumer>* consumer_filter);
576
577
    bool is_nereids() const;
578
579
188
    bool enable_spill() const {
580
188
        return (_query_options.__isset.enable_force_spill && _query_options.enable_force_spill) ||
581
188
               (_query_options.__isset.enable_spill && _query_options.enable_spill);
582
188
    }
583
584
0
    bool enable_force_spill() const {
585
0
        return _query_options.__isset.enable_force_spill && _query_options.enable_force_spill;
586
0
    }
587
588
0
    int64_t spill_min_revocable_mem() const {
589
0
        if (_query_options.__isset.min_revocable_mem) {
590
0
            return std::max(_query_options.min_revocable_mem, (int64_t)1);
591
0
        }
592
0
        return 1;
593
0
    }
594
595
5
    int64_t spill_sort_mem_limit() const {
596
5
        if (_query_options.__isset.spill_sort_mem_limit) {
597
5
            return std::max(_query_options.spill_sort_mem_limit, (int64_t)16777216);
598
5
        }
599
0
        return 134217728;
600
5
    }
601
602
15
    int64_t spill_sort_batch_bytes() const {
603
15
        if (_query_options.__isset.spill_sort_batch_bytes) {
604
15
            return std::max(_query_options.spill_sort_batch_bytes, (int64_t)8388608);
605
15
        }
606
0
        return 8388608;
607
15
    }
608
609
11
    int spill_aggregation_partition_count() const {
610
11
        if (_query_options.__isset.spill_aggregation_partition_count) {
611
11
            return std::min(std::max(_query_options.spill_aggregation_partition_count, 16), 8192);
612
11
        }
613
0
        return 32;
614
11
    }
615
616
0
    int spill_hash_join_partition_count() const {
617
0
        if (_query_options.__isset.spill_hash_join_partition_count) {
618
0
            return std::min(std::max(_query_options.spill_hash_join_partition_count, 16), 8192);
619
0
        }
620
0
        return 32;
621
0
    }
622
623
0
    int64_t low_memory_mode_buffer_limit() const {
624
0
        if (_query_options.__isset.low_memory_mode_buffer_limit) {
625
0
            return std::max(_query_options.low_memory_mode_buffer_limit, (int64_t)1);
626
0
        }
627
0
        return 32L * 1024 * 1024;
628
0
    }
629
630
1
    int spill_revocable_memory_high_watermark_percent() const {
631
1
        if (_query_options.__isset.revocable_memory_high_watermark_percent) {
632
1
            return _query_options.revocable_memory_high_watermark_percent;
633
1
        }
634
0
        return -1;
635
1
    }
636
637
0
    MOCK_FUNCTION bool enable_shared_exchange_sink_buffer() const {
638
0
        return _query_options.__isset.enable_shared_exchange_sink_buffer &&
639
0
               _query_options.enable_shared_exchange_sink_buffer;
640
0
    }
641
642
2.25M
    size_t minimum_operator_memory_required_bytes() const {
643
2.25M
        if (_query_options.__isset.minimum_operator_memory_required_kb) {
644
2.25M
            return _query_options.minimum_operator_memory_required_kb * 1024;
645
2.25M
        } else {
646
            // refer other database
647
0
            return 100 * 1024;
648
0
        }
649
2.25M
    }
650
651
78.0k
    void set_max_operator_id(int max_operator_id) { _max_operator_id = max_operator_id; }
652
653
10
    int max_operator_id() const { return _max_operator_id; }
654
655
16
    void set_task_id(int id) { _task_id = id; }
656
657
4.60k
    int task_id() const { return _task_id; }
658
659
5
    void set_task_num(int task_num) { _task_num = task_num; }
660
661
0
    int task_num() const { return _task_num; }
662
663
0
    int profile_level() const { return _profile_level; }
664
665
0
    std::shared_ptr<IdFileMap>& get_id_file_map() { return _id_file_map; }
666
667
    void set_id_file_map();
668
669
private:
670
    Status create_error_log_file();
671
672
    static const int DEFAULT_BATCH_SIZE = 4062;
673
674
    std::shared_ptr<MemTrackerLimiter> _query_mem_tracker = nullptr;
675
676
    // Could not find a better way to record if the weak ptr is inited, use a bool to record
677
    // it. In some unit test cases, the runtime state's task ctx is not inited, then the test
678
    // hang, it is very hard to debug.
679
    bool _task_execution_context_inited = false;
680
    // Hold execution context for other threads
681
    std::weak_ptr<TaskExecutionContext> _task_execution_context;
682
683
    // put runtime state before _obj_pool, so that it will be deconstructed after
684
    // _obj_pool. Because some of object in _obj_pool will use profile when deconstructing.
685
    RuntimeProfile _profile;
686
    RuntimeProfile _load_channel_profile;
687
    // Why 2?
688
    // During cluster upgrade, fe will not pass profile_level to be, so we need to set it to 2
689
    // to make sure user can see all profile counters like before.
690
    int _profile_level = 2;
691
692
    const DescriptorTbl* _desc_tbl = nullptr;
693
    std::shared_ptr<ObjectPool> _obj_pool;
694
695
    // owned by PipelineFragmentContext
696
    RuntimeFilterMgr* _runtime_filter_mgr = nullptr;
697
698
    // Lock protecting _error_log and _unreported_error_idx
699
    std::mutex _error_log_lock;
700
701
    // Logs error messages.
702
    std::vector<std::string> _error_log;
703
704
    // _error_log[_unreported_error_idx+] has been not reported to the coordinator.
705
    int _unreported_error_idx;
706
707
    // Username of user that is executing the query to which this RuntimeState belongs.
708
    std::string _user;
709
710
    //Query-global timestamp_ms
711
    int64_t _timestamp_ms;
712
    int32_t _nano_seconds;
713
    std::string _timezone;
714
    cctz::time_zone _timezone_obj;
715
716
    TUniqueId _query_id;
717
    // fragment id for each TPipelineFragmentParams
718
    int32_t _fragment_id;
719
    TUniqueId _fragment_instance_id;
720
    TQueryOptions _query_options;
721
    ExecEnv* _exec_env = nullptr;
722
723
    AtomicStatus _exec_status;
724
725
    int _per_fragment_instance_idx;
726
    int _num_per_fragment_instances = 0;
727
    int _load_stream_per_node = 0;
728
    int _total_load_streams = 0;
729
    int _num_local_sink = 0;
730
731
    // The backend id on which this fragment instance runs
732
    int64_t _backend_id = -1;
733
734
    // used as send id
735
    int _be_number;
736
737
    // put here to collect files??
738
    std::vector<std::string> _output_files;
739
    std::atomic<int64_t> _num_rows_load_total;      // total rows read from source
740
    std::atomic<int64_t> _num_rows_load_filtered;   // unqualified rows
741
    std::atomic<int64_t> _num_rows_load_unselected; // rows filtered by predicates
742
    std::atomic<int64_t> _num_rows_filtered_in_strict_mode_partial_update;
743
    std::atomic<int64_t> _num_print_error_rows;
744
745
    std::atomic<int64_t> _num_bytes_load_total; // total bytes read from source
746
    std::atomic<int64_t> _num_finished_scan_range;
747
748
    std::vector<std::string> _export_output_files;
749
    std::string _import_label;
750
    std::string _db_name;
751
    std::string _load_dir;
752
    int64_t _load_job_id;
753
    int64_t _wal_id = -1;
754
    size_t _content_length = 0;
755
756
    // mini load
757
    int64_t _error_row_number;
758
    std::string _error_log_file_path;
759
    std::unique_ptr<std::ofstream> _error_log_file; // error file path, absolute path
760
    mutable std::mutex _tablet_infos_mutex;
761
    std::vector<TTabletCommitInfo> _tablet_commit_infos;
762
    std::vector<TErrorTabletInfo> _error_tablet_infos;
763
    int _max_operator_id = 0;
764
    pipeline::PipelineTask* _task = nullptr;
765
    int _task_id = -1;
766
    int _task_num = 0;
767
768
    mutable std::mutex _hive_partition_updates_mutex;
769
    std::vector<THivePartitionUpdate> _hive_partition_updates;
770
771
    mutable std::mutex _iceberg_commit_datas_mutex;
772
    std::vector<TIcebergCommitData> _iceberg_commit_datas;
773
774
    std::vector<std::unique_ptr<doris::pipeline::PipelineXLocalStateBase>> _op_id_to_local_state;
775
776
    std::unique_ptr<doris::pipeline::PipelineXSinkLocalStateBase> _sink_local_state;
777
778
    QueryContext* _query_ctx = nullptr;
779
780
    // true if max_filter_ratio is 0
781
    bool _load_zero_tolerance = false;
782
783
    // only to lock _pipeline_id_to_profile
784
    std::shared_mutex _pipeline_profile_lock;
785
    std::vector<std::shared_ptr<RuntimeProfile>> _pipeline_id_to_profile;
786
787
    // prohibit copies
788
    RuntimeState(const RuntimeState&);
789
790
    // save error log to s3
791
    std::shared_ptr<io::S3FileSystem> _s3_error_fs;
792
    // error file path on s3, ${bucket}/${prefix}/error_log/${label}_${fragment_instance_id}
793
    std::string _s3_error_log_file_path;
794
    std::mutex _s3_error_log_file_lock;
795
796
    // used for encoding the global lazy materialize
797
    std::shared_ptr<IdFileMap> _id_file_map = nullptr;
798
};
799
800
#define RETURN_IF_CANCELLED(state)               \
801
666
    do {                                         \
802
666
        if (UNLIKELY((state)->is_cancelled())) { \
803
0
            return (state)->cancel_reason();     \
804
0
        }                                        \
805
666
    } while (false)
806
807
} // namespace doris