Coverage Report

Created: 2026-07-29 14:27

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
be/src/format/parquet/vparquet_group_reader.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 "format/parquet/vparquet_group_reader.h"
19
20
#include <gen_cpp/Exprs_types.h>
21
#include <gen_cpp/Opcodes_types.h>
22
#include <gen_cpp/Types_types.h>
23
#include <gen_cpp/parquet_types.h>
24
#include <string.h>
25
26
#include <algorithm>
27
#include <boost/iterator/iterator_facade.hpp>
28
#include <memory>
29
#include <numeric>
30
#include <ostream>
31
32
#include "common/check.h"
33
#include "common/config.h"
34
#include "common/logging.h"
35
#include "common/object_pool.h"
36
#include "common/status.h"
37
#include "core/assert_cast.h"
38
#include "core/block/block.h"
39
#include "core/block/column_with_type_and_name.h"
40
#include "core/column/column.h"
41
#include "core/column/column_const.h"
42
#include "core/column/column_nullable.h"
43
#include "core/column/column_string.h"
44
#include "core/column/column_vector.h"
45
#include "core/custom_allocator.h"
46
#include "core/data_type/data_type.h"
47
#include "core/data_type/data_type_string.h"
48
#include "core/data_type/define_primitive_type.h"
49
#include "core/pod_array.h"
50
#include "core/types.h"
51
#include "exprs/create_predicate_function.h"
52
#include "exprs/hybrid_set.h"
53
#include "exprs/vdirect_in_predicate.h"
54
#include "exprs/vectorized_fn_call.h"
55
#include "exprs/vexpr.h"
56
#include "exprs/vexpr_context.h"
57
#include "exprs/vliteral.h"
58
#include "exprs/vslot_ref.h"
59
#include "format/parquet/schema_desc.h"
60
#include "format/parquet/vparquet_column_reader.h"
61
#include "format/table/iceberg_reader.h"
62
#include "runtime/descriptors.h"
63
#include "runtime/runtime_state.h"
64
#include "runtime/thread_context.h"
65
#include "storage/segment/column_reader.h"
66
67
namespace cctz {
68
class time_zone;
69
} // namespace cctz
70
namespace doris {
71
class RuntimeState;
72
73
namespace io {
74
struct IOContext;
75
} // namespace io
76
} // namespace doris
77
78
namespace doris {
79
80
const std::vector<int64_t> RowGroupReader::NO_DELETE = {};
81
static constexpr uint32_t MAX_DICT_CODE_PREDICATE_TO_REWRITE = std::numeric_limits<uint32_t>::max();
82
83
RowGroupReader::RowGroupReader(io::FileReaderSPtr file_reader,
84
                               const std::vector<std::string>& read_columns,
85
                               const int32_t row_group_id, const tparquet::RowGroup& row_group,
86
                               const cctz::time_zone* ctz, io::IOContext* io_ctx,
87
                               const PositionDeleteContext& position_delete_ctx,
88
                               const LazyReadContext& lazy_read_ctx, RuntimeState* state,
89
                               const std::set<uint64_t>& column_ids,
90
                               const std::set<uint64_t>& filter_column_ids)
91
46
        : _file_reader(file_reader),
92
46
          _read_table_columns(read_columns),
93
46
          _row_group_id(row_group_id),
94
46
          _row_group_meta(row_group),
95
46
          _remaining_rows(row_group.num_rows),
96
46
          _ctz(ctz),
97
46
          _io_ctx(io_ctx),
98
46
          _position_delete_ctx(position_delete_ctx),
99
46
          _lazy_read_ctx(lazy_read_ctx),
100
46
          _state(state),
101
46
          _obj_pool(new ObjectPool()),
102
46
          _column_ids(column_ids),
103
46
          _filter_column_ids(filter_column_ids) {}
104
105
46
RowGroupReader::~RowGroupReader() {
106
46
    if (_obj_pool != nullptr) {
107
46
        _obj_pool->clear();
108
46
    }
109
46
}
110
111
Status RowGroupReader::init(
112
        const FieldDescriptor& schema, RowRanges& row_ranges,
113
        std::unordered_map<int, tparquet::OffsetIndex>& col_offsets,
114
        const TupleDescriptor* tuple_descriptor, const RowDescriptor* row_descriptor,
115
        const std::unordered_map<std::string, int>* colname_to_slot_id,
116
        const VExprContextSPtrs* not_single_slot_filter_conjuncts,
117
45
        const std::unordered_map<int, VExprContextSPtrs>* slot_id_to_filter_conjuncts) {
118
45
    _tuple_descriptor = tuple_descriptor;
119
45
    _row_descriptor = row_descriptor;
120
45
    _col_name_to_slot_id = colname_to_slot_id;
121
45
    _slot_id_to_filter_conjuncts = slot_id_to_filter_conjuncts;
122
45
    _read_ranges = row_ranges;
123
45
    _filter_read_ranges_by_condition_cache();
124
45
    _remaining_rows = _read_ranges.count();
125
126
45
    if (_read_table_columns.empty()) {
127
        // Query task that only select columns in path.
128
1
        return Status::OK();
129
1
    }
130
44
    const size_t MAX_GROUP_BUF_SIZE = config::parquet_rowgroup_max_buffer_mb << 20;
131
44
    const size_t MAX_COLUMN_BUF_SIZE = config::parquet_column_max_buffer_mb << 20;
132
44
    size_t max_buf_size =
133
44
            std::min(MAX_COLUMN_BUF_SIZE, MAX_GROUP_BUF_SIZE / _read_table_columns.size());
134
119
    for (const auto& read_table_col : _read_table_columns) {
135
119
        auto read_file_col = _table_info_node_ptr->children_file_column_name(read_table_col);
136
119
        auto* field = schema.get_column(read_file_col);
137
119
        std::unique_ptr<ParquetColumnReader> reader;
138
119
        RETURN_IF_ERROR(ParquetColumnReader::create(
139
119
                _file_reader, field, _row_group_meta, _read_ranges, _ctz, _io_ctx, reader,
140
119
                max_buf_size, col_offsets, _state, false, _column_ids, _filter_column_ids));
141
119
        if (reader == nullptr) {
142
0
            VLOG_DEBUG << "Init row group(" << _row_group_id << ") reader failed";
143
0
            return Status::Corruption("Init row group reader failed");
144
0
        }
145
119
        _column_readers[read_table_col] = std::move(reader);
146
119
    }
147
148
44
    if (not_single_slot_filter_conjuncts != nullptr && !not_single_slot_filter_conjuncts->empty()) {
149
1
        for (const auto& conjunct : *not_single_slot_filter_conjuncts) {
150
1
            _block_dict_filter_for_slots(conjunct->root());
151
1
        }
152
1
        _filter_conjuncts.insert(_filter_conjuncts.end(), not_single_slot_filter_conjuncts->begin(),
153
1
                                 not_single_slot_filter_conjuncts->end());
154
1
    }
155
156
    // Check if single slot can be filtered by dict.
157
44
    if (_slot_id_to_filter_conjuncts && !_slot_id_to_filter_conjuncts->empty()) {
158
4
        const std::vector<std::string>& predicate_col_names =
159
4
                _lazy_read_ctx.predicate_columns.first;
160
4
        const std::vector<int>& predicate_col_slot_ids = _lazy_read_ctx.predicate_columns.second;
161
10
        for (size_t i = 0; i < predicate_col_names.size(); ++i) {
162
6
            const std::string& predicate_col_name = predicate_col_names[i];
163
6
            int slot_id = predicate_col_slot_ids[i];
164
165
6
            if (!_table_format_reader->has_column_optimization(
166
6
                        predicate_col_name,
167
6
                        TableFormatReader::ColumnOptimizationTypes::DICT_FILTER)) {
168
                // Row-lineage style generated columns cannot participate in dict filtering.
169
0
                if (_slot_id_to_filter_conjuncts->find(slot_id) !=
170
0
                    _slot_id_to_filter_conjuncts->end()) {
171
0
                    for (auto& ctx : _slot_id_to_filter_conjuncts->at(slot_id)) {
172
0
                        _filter_conjuncts.push_back(ctx);
173
0
                    }
174
0
                }
175
0
                continue;
176
0
            }
177
178
6
            auto predicate_file_col_name =
179
6
                    _table_info_node_ptr->children_file_column_name(predicate_col_name);
180
6
            auto field = schema.get_column(predicate_file_col_name);
181
6
            if (!_lazy_read_ctx.has_complex_type &&
182
6
                _can_filter_by_dict(
183
6
                        slot_id, _row_group_meta.columns[field->physical_column_index].meta_data)) {
184
1
                _dict_filter_cols.emplace_back(std::make_pair(predicate_col_name, slot_id));
185
5
            } else {
186
5
                if (_slot_id_to_filter_conjuncts->find(slot_id) !=
187
5
                    _slot_id_to_filter_conjuncts->end()) {
188
5
                    for (auto& ctx : _slot_id_to_filter_conjuncts->at(slot_id)) {
189
5
                        _filter_conjuncts.push_back(ctx);
190
5
                    }
191
5
                }
192
5
            }
193
6
        }
194
        // Add predicate_partition_columns in _slot_id_to_filter_conjuncts(single slot conjuncts)
195
        // to _filter_conjuncts, others should be added from not_single_slot_filter_conjuncts.
196
4
        for (auto& kv : _lazy_read_ctx.predicate_partition_columns) {
197
3
            auto& [value, slot_desc] = kv.second;
198
3
            auto iter = _slot_id_to_filter_conjuncts->find(slot_desc->id());
199
3
            if (iter != _slot_id_to_filter_conjuncts->end()) {
200
3
                for (auto& ctx : iter->second) {
201
3
                    _filter_conjuncts.push_back(ctx);
202
3
                }
203
3
            }
204
3
        }
205
        //For check missing column :   missing column == xx, missing column is null,missing column is not null.
206
4
        _filter_conjuncts.insert(_filter_conjuncts.end(),
207
4
                                 _lazy_read_ctx.missing_columns_conjuncts.begin(),
208
4
                                 _lazy_read_ctx.missing_columns_conjuncts.end());
209
4
        RETURN_IF_ERROR(_rewrite_dict_predicates());
210
4
    }
211
    // _state is nullptr in some ut.
212
44
    if (_state && _state->enable_adjust_conjunct_order_by_cost()) {
213
5
        std::ranges::stable_sort(_filter_conjuncts, [](const auto& a, const auto& b) {
214
3
            return a->execute_cost() < b->execute_cost();
215
3
        });
216
5
    }
217
44
    return Status::OK();
218
44
}
219
220
3
void RowGroupReader::_block_dict_filter_for_slots(const VExprSPtr& expr) {
221
3
    DORIS_CHECK(expr != nullptr);
222
3
    if (auto impl = expr->get_impl()) {
223
0
        _block_dict_filter_for_slots(impl);
224
0
        return;
225
0
    }
226
3
    if (expr->is_slot_ref()) {
227
2
        _dict_filter_blocked_slot_ids.insert(static_cast<const VSlotRef*>(expr.get())->slot_id());
228
2
        return;
229
2
    }
230
2
    for (const auto& child : expr->children()) {
231
2
        _block_dict_filter_for_slots(child);
232
2
    }
233
1
}
234
235
bool RowGroupReader::_can_filter_by_dict(int slot_id,
236
6
                                         const tparquet::ColumnMetaData& column_metadata) {
237
6
    if (_dict_filter_blocked_slot_ids.contains(slot_id)) {
238
2
        return false;
239
2
    }
240
4
    SlotDescriptor* slot = nullptr;
241
4
    const std::vector<SlotDescriptor*>& slots = _tuple_descriptor->slots();
242
9
    for (auto each : slots) {
243
9
        if (each->id() == slot_id) {
244
4
            slot = each;
245
4
            break;
246
4
        }
247
9
    }
248
4
    if (!is_string_type(slot->type()->get_primitive_type()) &&
249
4
        !is_var_len_object(slot->type()->get_primitive_type())) {
250
3
        return false;
251
3
    }
252
1
    if (column_metadata.type != tparquet::Type::BYTE_ARRAY) {
253
0
        return false;
254
0
    }
255
256
1
    if (!is_dictionary_encoded(column_metadata)) {
257
0
        return false;
258
0
    }
259
260
1
    if (_slot_id_to_filter_conjuncts->find(slot_id) == _slot_id_to_filter_conjuncts->end()) {
261
0
        return false;
262
0
    }
263
264
    // TODO: The current implementation of dictionary filtering does not take into account
265
    //  the implementation of NULL values because the dictionary itself does not contain
266
    //  NULL value encoding. As a result, many NULL-related functions or expressions
267
    //  cannot work properly, such as is null, is not null, coalesce, etc.
268
    //  Here we check if the predicate expr is IN or BINARY_PRED.
269
    //  Implementation of NULL value dictionary filtering will be carried out later.
270
1
    return std::ranges::all_of(_slot_id_to_filter_conjuncts->at(slot_id), [&](const auto& ctx) {
271
1
        return (ctx->root()->node_type() == TExprNodeType::IN_PRED ||
272
1
                ctx->root()->node_type() == TExprNodeType::BINARY_PRED) &&
273
1
               ctx->root()->children()[0]->node_type() == TExprNodeType::SLOT_REF;
274
1
    });
275
1
}
276
277
// This function is copied from
278
// https://github.com/apache/impala/blob/master/be/src/exec/parquet/hdfs-parquet-scanner.cc#L1717
279
2
bool RowGroupReader::is_dictionary_encoded(const tparquet::ColumnMetaData& column_metadata) {
280
    // The Parquet spec allows for column chunks to have mixed encodings
281
    // where some data pages are dictionary-encoded and others are plain
282
    // encoded. For example, a Parquet file writer might start writing
283
    // a column chunk as dictionary encoded, but it will switch to plain
284
    // encoding if the dictionary grows too large.
285
    //
286
    // In order for dictionary filters to skip the entire row group,
287
    // the conjuncts must be evaluated on column chunks that are entirely
288
    // encoded with the dictionary encoding. There are two checks
289
    // available to verify this:
290
    // 1. The encoding_stats field on the column chunk metadata provides
291
    //    information about the number of data pages written in each
292
    //    format. This allows for a specific check of whether all the
293
    //    data pages are dictionary encoded.
294
    // 2. The encodings field on the column chunk metadata lists the
295
    //    encodings used. If this list contains the dictionary encoding
296
    //    and does not include unexpected encodings (i.e. encodings not
297
    //    associated with definition/repetition levels), then it is entirely
298
    //    dictionary encoded.
299
2
    if (column_metadata.__isset.encoding_stats) {
300
        // Condition #1 above
301
4
        for (const tparquet::PageEncodingStats& enc_stat : column_metadata.encoding_stats) {
302
4
            if ((enc_stat.page_type == tparquet::PageType::DATA_PAGE ||
303
4
                 enc_stat.page_type == tparquet::PageType::DATA_PAGE_V2) &&
304
4
                (enc_stat.encoding != tparquet::Encoding::PLAIN_DICTIONARY &&
305
3
                 enc_stat.encoding != tparquet::Encoding::RLE_DICTIONARY) &&
306
4
                enc_stat.count > 0) {
307
1
                return false;
308
1
            }
309
4
        }
310
2
    } else {
311
        // Condition #2 above
312
0
        bool has_dict_encoding = false;
313
0
        bool has_nondict_encoding = false;
314
0
        for (const tparquet::Encoding::type& encoding : column_metadata.encodings) {
315
0
            if (encoding == tparquet::Encoding::PLAIN_DICTIONARY ||
316
0
                encoding == tparquet::Encoding::RLE_DICTIONARY) {
317
0
                has_dict_encoding = true;
318
0
            }
319
320
            // RLE and BIT_PACKED are used for repetition/definition levels
321
0
            if (encoding != tparquet::Encoding::PLAIN_DICTIONARY &&
322
0
                encoding != tparquet::Encoding::RLE_DICTIONARY &&
323
0
                encoding != tparquet::Encoding::RLE && encoding != tparquet::Encoding::BIT_PACKED) {
324
0
                has_nondict_encoding = true;
325
0
                break;
326
0
            }
327
0
        }
328
        // Not entirely dictionary encoded if:
329
        // 1. No dictionary encoding listed
330
        // OR
331
        // 2. Some non-dictionary encoding is listed
332
0
        if (!has_dict_encoding || has_nondict_encoding) {
333
0
            return false;
334
0
        }
335
0
    }
336
337
1
    return true;
338
2
}
339
340
Status RowGroupReader::next_batch(Block* block, size_t batch_size, size_t* read_rows,
341
95
                                  bool* batch_eof) {
342
95
    if (_is_row_group_filtered) {
343
0
        *read_rows = 0;
344
0
        *batch_eof = true;
345
0
        return Status::OK();
346
0
    }
347
348
    // Process external table query task that select columns are all from path.
349
95
    if (_read_table_columns.empty()) {
350
11
        int64_t batch_base_row = _total_read_rows;
351
11
        RETURN_IF_ERROR(_read_empty_batch(batch_size, read_rows, batch_eof));
352
353
11
        DCHECK(_table_format_reader);
354
11
        RETURN_IF_ERROR(_table_format_reader->on_fill_partition_columns(
355
11
                block, *read_rows, _lazy_read_ctx.partition_col_names));
356
11
        RETURN_IF_ERROR(_table_format_reader->on_fill_missing_columns(
357
11
                block, *read_rows, _lazy_read_ctx.missing_col_names));
358
11
        RETURN_IF_ERROR(_table_format_reader->fill_synthesized_columns(block, *read_rows));
359
11
        RETURN_IF_ERROR(_table_format_reader->fill_generated_columns(block, *read_rows));
360
11
        std::vector<uint32_t> columns_to_filter(block->columns());
361
22
        for (uint32_t i = 0; i < columns_to_filter.size(); ++i) {
362
11
            columns_to_filter[i] = i;
363
11
        }
364
11
        IColumn::Filter result_filter;
365
11
        RETURN_IF_ERROR(VExprContext::execute_conjuncts_and_filter_block(
366
11
                _lazy_read_ctx.conjuncts, block, columns_to_filter, block->columns(),
367
11
                result_filter));
368
11
        _mark_condition_cache_granules(result_filter.data(), *read_rows, batch_base_row);
369
11
        *read_rows = block->rows();
370
11
        return Status::OK();
371
11
    }
372
84
    if (_lazy_read_ctx.can_lazy_read) {
373
        // call _do_lazy_read recursively when current batch is skipped
374
12
        return _do_lazy_read(block, batch_size, read_rows, batch_eof);
375
72
    } else {
376
72
        FilterMap filter_map;
377
72
        int64_t batch_base_row = _total_read_rows;
378
72
        RETURN_IF_ERROR((_read_column_data(block, _lazy_read_ctx.all_read_columns, batch_size,
379
72
                                           read_rows, batch_eof, filter_map)));
380
72
        DCHECK(_table_format_reader);
381
72
        RETURN_IF_ERROR(_table_format_reader->on_fill_partition_columns(
382
72
                block, *read_rows, _lazy_read_ctx.partition_col_names));
383
72
        RETURN_IF_ERROR(_table_format_reader->on_fill_missing_columns(
384
72
                block, *read_rows, _lazy_read_ctx.missing_col_names));
385
386
72
        if (_need_current_batch_row_positions()) {
387
5
            RETURN_IF_ERROR(_get_current_batch_row_id(*read_rows));
388
5
        }
389
72
        RETURN_IF_ERROR(_table_format_reader->fill_synthesized_columns(block, *read_rows));
390
72
        RETURN_IF_ERROR(_table_format_reader->fill_generated_columns(block, *read_rows));
391
392
72
#ifndef NDEBUG
393
191
        for (auto col : *block) {
394
191
            col.column->sanity_check();
395
191
            DCHECK(block->rows() == col.column->size())
396
0
                    << absl::Substitute("block rows = $0 , column rows = $1, col name = $2",
397
0
                                        block->rows(), col.column->size(), col.name);
398
191
        }
399
72
#endif
400
401
72
        if (block->rows() == 0) {
402
0
            RETURN_IF_ERROR(_convert_dict_cols_to_string_cols(block));
403
0
            *read_rows = block->rows();
404
0
#ifndef NDEBUG
405
0
            for (auto col : *block) {
406
0
                col.column->sanity_check();
407
0
                DCHECK(block->rows() == col.column->size())
408
0
                        << absl::Substitute("block rows = $0 , column rows = $1, col name = $2",
409
0
                                            block->rows(), col.column->size(), col.name);
410
0
            }
411
0
#endif
412
0
            return Status::OK();
413
0
        }
414
72
        {
415
72
            SCOPED_RAW_TIMER(&_predicate_filter_time);
416
72
            RETURN_IF_ERROR(_build_pos_delete_filter(*read_rows));
417
418
72
            std::vector<uint32_t> columns_to_filter;
419
72
            int column_to_keep = block->columns();
420
72
            columns_to_filter.resize(column_to_keep);
421
263
            for (uint32_t i = 0; i < column_to_keep; ++i) {
422
191
                columns_to_filter[i] = i;
423
191
            }
424
72
            if (!_lazy_read_ctx.conjuncts.empty()) {
425
12
                std::vector<IColumn::Filter*> filters;
426
12
                if (_position_delete_ctx.has_filter) {
427
0
                    filters.push_back(_pos_delete_filter_ptr.get());
428
0
                }
429
12
                IColumn::Filter result_filter(block->rows(), 1);
430
12
                bool can_filter_all = false;
431
432
12
                {
433
12
                    RETURN_IF_ERROR_OR_CATCH_EXCEPTION(VExprContext::execute_conjuncts(
434
12
                            _filter_conjuncts, &filters, block, &result_filter, &can_filter_all));
435
12
                }
436
437
                // Condition cache MISS: mark granules with surviving rows (non-lazy path)
438
12
                if (!can_filter_all) {
439
12
                    _mark_condition_cache_granules(result_filter.data(), block->rows(),
440
12
                                                   batch_base_row);
441
12
                }
442
443
12
                if (can_filter_all) {
444
0
                    block->clear_column_data(columns_to_filter);
445
0
                    Block::erase_useless_column(block, column_to_keep);
446
0
                    RETURN_IF_ERROR(_convert_dict_cols_to_string_cols(block));
447
0
                    return Status::OK();
448
0
                }
449
450
12
                RETURN_IF_CATCH_EXCEPTION(
451
12
                        Block::filter_block_internal(block, columns_to_filter, result_filter));
452
12
                Block::erase_useless_column(block, column_to_keep);
453
60
            } else {
454
60
                RETURN_IF_CATCH_EXCEPTION(
455
60
                        RETURN_IF_ERROR(_filter_block(block, column_to_keep, columns_to_filter)));
456
60
            }
457
72
            RETURN_IF_ERROR(_convert_dict_cols_to_string_cols(block));
458
72
        }
459
72
#ifndef NDEBUG
460
191
        for (auto col : *block) {
461
191
            col.column->sanity_check();
462
191
            DCHECK(block->rows() == col.column->size())
463
0
                    << absl::Substitute("block rows = $0 , column rows = $1, col name = $2",
464
0
                                        block->rows(), col.column->size(), col.name);
465
191
        }
466
72
#endif
467
72
        *read_rows = block->rows();
468
72
        return Status::OK();
469
72
    }
470
84
}
471
472
// Maps each batch row to its global parquet file position via _read_ranges, then marks
473
// the corresponding condition cache granule as true if the filter indicates the row survived.
474
// batch_seq_start is the number of rows already read sequentially before this batch
475
// (i.e., _total_read_rows before the batch started).
476
void RowGroupReader::_mark_condition_cache_granules(const uint8_t* filter_data, size_t num_rows,
477
34
                                                    int64_t batch_seq_start) {
478
34
    if (!_condition_cache_ctx || _condition_cache_ctx->is_hit) {
479
34
        return;
480
34
    }
481
0
    auto& cache = *_condition_cache_ctx->filter_result;
482
0
    for (size_t i = 0; i < num_rows; i++) {
483
0
        if (filter_data[i]) {
484
            // row-group-relative position of this row
485
0
            int64_t rg_pos = _read_ranges.get_row_index_by_pos(batch_seq_start + i);
486
            // global row number in the parquet file
487
0
            size_t granule = (_current_row_group_idx.first_row + rg_pos) /
488
0
                             ConditionCacheContext::GRANULE_SIZE;
489
0
            size_t cache_idx = granule - _condition_cache_ctx->base_granule;
490
0
            if (cache_idx < cache.size()) {
491
0
                cache[cache_idx] = true;
492
0
            }
493
0
        }
494
0
    }
495
0
}
496
497
// On condition cache HIT, removes row ranges whose granules have no surviving rows from
498
// _read_ranges BEFORE column readers are created. This makes ParquetColumnReader skip I/O
499
// entirely for false-granule rows — both predicate and lazy columns — via its existing
500
// page/row-skipping infrastructure.
501
45
void RowGroupReader::_filter_read_ranges_by_condition_cache() {
502
45
    if (!_condition_cache_ctx || !_condition_cache_ctx->is_hit) {
503
45
        return;
504
45
    }
505
0
    auto& filter_result = *_condition_cache_ctx->filter_result;
506
0
    if (filter_result.empty()) {
507
0
        return;
508
0
    }
509
510
0
    auto old_row_count = _read_ranges.count();
511
0
    _read_ranges =
512
0
            filter_ranges_by_cache(_read_ranges, filter_result, _current_row_group_idx.first_row,
513
0
                                   _condition_cache_ctx->base_granule);
514
0
    _is_row_group_filtered = _read_ranges.is_empty();
515
0
    _condition_cache_filtered_rows += old_row_count - _read_ranges.count();
516
0
}
517
518
// Filters read_ranges by removing rows whose cache granule is false.
519
//
520
// Cache index i maps to global granule (base_granule + i), which covers global file
521
// rows [(base_granule+i)*GS, (base_granule+i+1)*GS). Since read_ranges uses
522
// row-group-relative indices and first_row is the global position of the row group's
523
// first row, global granule g maps to row-group-relative range:
524
//   [max(0, g*GS - first_row), max(0, (g+1)*GS - first_row))
525
//
526
// We build a RowRanges of all false-granule regions (in row-group-relative coordinates),
527
// then subtract from read_ranges via ranges_exception.
528
//
529
// Granules beyond cache.size() are kept conservatively (assumed true).
530
//
531
// When base_granule > 0, the cache only covers granules starting from base_granule.
532
// This happens when a Parquet file is split across multiple scan ranges and this reader
533
// only processes row groups starting at a non-zero offset in the file.
534
RowRanges RowGroupReader::filter_ranges_by_cache(const RowRanges& read_ranges,
535
                                                 const std::vector<bool>& cache, int64_t first_row,
536
21
                                                 int64_t base_granule) {
537
21
    constexpr int64_t GS = ConditionCacheContext::GRANULE_SIZE;
538
21
    RowRanges filtered_ranges;
539
540
138
    for (size_t i = 0; i < cache.size(); i++) {
541
117
        if (!cache[i]) {
542
64
            int64_t global_granule = base_granule + static_cast<int64_t>(i);
543
64
            int64_t rg_from = std::max(static_cast<int64_t>(0), global_granule * GS - first_row);
544
64
            int64_t rg_to =
545
64
                    std::max(static_cast<int64_t>(0), (global_granule + 1) * GS - first_row);
546
64
            if (rg_from < rg_to) {
547
16
                filtered_ranges.add(RowRange(rg_from, rg_to));
548
16
            }
549
64
        }
550
117
    }
551
552
21
    RowRanges result;
553
21
    RowRanges::ranges_exception(read_ranges, filtered_ranges, &result);
554
21
    return result;
555
21
}
556
557
Status RowGroupReader::_read_column_data(Block* block,
558
                                         const std::vector<std::string>& table_columns,
559
                                         size_t batch_size, size_t* read_rows, bool* batch_eof,
560
105
                                         FilterMap& filter_map) {
561
105
    size_t batch_read_rows = 0;
562
105
    bool has_eof = false;
563
208
    for (auto& read_col_name : table_columns) {
564
208
        uint32_t block_pos = 0;
565
208
        RETURN_IF_ERROR(_get_block_column_pos(*block, read_col_name, &block_pos));
566
208
        auto reader_iter = _column_readers.find(read_col_name);
567
208
        if (reader_iter == _column_readers.end() || reader_iter->second == nullptr) {
568
0
            return Status::InternalError("Column reader for '{}' not found in parquet row group",
569
0
                                         read_col_name);
570
0
        }
571
572
208
        auto& column_with_type_and_name = block->safe_get_by_position(block_pos);
573
208
        auto& column_ptr = column_with_type_and_name.column;
574
208
        auto& column_type = column_with_type_and_name.type;
575
208
        bool is_dict_filter = false;
576
208
        for (auto& _dict_filter_col : _dict_filter_cols) {
577
3
            if (_dict_filter_col.first == read_col_name) {
578
1
                MutableColumnPtr dict_column = ColumnInt32::create();
579
1
                if (column_type->is_nullable()) {
580
0
                    block->get_by_position(block_pos).type =
581
0
                            std::make_shared<DataTypeNullable>(std::make_shared<DataTypeInt32>());
582
0
                    block->replace_by_position(
583
0
                            block_pos,
584
0
                            ColumnNullable::create(std::move(dict_column),
585
0
                                                   ColumnUInt8::create(dict_column->size(), 0)));
586
1
                } else {
587
1
                    block->get_by_position(block_pos).type = std::make_shared<DataTypeInt32>();
588
1
                    block->replace_by_position(block_pos, std::move(dict_column));
589
1
                }
590
1
                is_dict_filter = true;
591
1
                break;
592
1
            }
593
3
        }
594
595
208
        size_t col_read_rows = 0;
596
208
        bool col_eof = false;
597
        // Should reset _filter_map_index to 0 when reading next column.
598
        //        select_vector.reset();
599
208
        reader_iter->second->reset_filter_map_index();
600
479
        while (!col_eof && col_read_rows < batch_size) {
601
271
            size_t loop_rows = 0;
602
271
            RETURN_IF_ERROR(reader_iter->second->read_column_data(
603
271
                    column_ptr, column_type, _table_info_node_ptr->get_children_node(read_col_name),
604
271
                    filter_map, batch_size - col_read_rows, &loop_rows, &col_eof, is_dict_filter));
605
271
            VLOG_DEBUG << "[RowGroupReader] column '" << read_col_name
606
0
                       << "' loop_rows=" << loop_rows << " col_read_rows_so_far=" << col_read_rows
607
0
                       << std::endl;
608
271
            col_read_rows += loop_rows;
609
271
        }
610
208
        VLOG_DEBUG << "[RowGroupReader] column '" << read_col_name
611
0
                   << "' read_rows=" << col_read_rows << std::endl;
612
208
        if (batch_read_rows > 0 && batch_read_rows != col_read_rows) {
613
0
            LOG(WARNING) << "[RowGroupReader] Mismatched read rows among parquet columns. "
614
0
                            "previous_batch_read_rows="
615
0
                         << batch_read_rows << ", current_column='" << read_col_name
616
0
                         << "', current_col_read_rows=" << col_read_rows;
617
0
            return Status::Corruption("Can't read the same number of rows among parquet columns");
618
0
        }
619
208
        batch_read_rows = col_read_rows;
620
621
208
#ifndef NDEBUG
622
208
        column_ptr->sanity_check();
623
208
#endif
624
208
        if (col_eof) {
625
118
            has_eof = true;
626
118
        }
627
208
    }
628
629
105
    *read_rows = batch_read_rows;
630
105
    *batch_eof = has_eof;
631
632
105
    return Status::OK();
633
105
}
634
635
Status RowGroupReader::_do_lazy_read(Block* block, size_t batch_size, size_t* read_rows,
636
12
                                     bool* batch_eof) {
637
12
    std::unique_ptr<FilterMap> filter_map_ptr = nullptr;
638
12
    size_t pre_read_rows;
639
12
    bool pre_eof;
640
12
    std::vector<uint32_t> columns_to_filter;
641
12
    uint32_t origin_column_num = block->columns();
642
12
    columns_to_filter.resize(origin_column_num);
643
48
    for (uint32_t i = 0; i < origin_column_num; ++i) {
644
36
        columns_to_filter[i] = i;
645
36
    }
646
12
    IColumn::Filter result_filter;
647
12
    size_t pre_raw_read_rows = 0;
648
22
    while (!_state->is_cancelled()) {
649
        // read predicate columns
650
22
        pre_read_rows = 0;
651
22
        pre_eof = false;
652
22
        FilterMap filter_map;
653
22
        int64_t batch_base_row = _total_read_rows;
654
22
        RETURN_IF_ERROR(_read_column_data(block, _lazy_read_ctx.predicate_columns.first, batch_size,
655
22
                                          &pre_read_rows, &pre_eof, filter_map));
656
22
        if (pre_read_rows == 0) {
657
0
            DCHECK_EQ(pre_eof, true);
658
0
            break;
659
0
        }
660
22
        pre_raw_read_rows += pre_read_rows;
661
662
22
        DCHECK(_table_format_reader);
663
22
        RETURN_IF_ERROR(_table_format_reader->on_fill_partition_columns(
664
22
                block, pre_read_rows, _lazy_read_ctx.predicate_partition_col_names));
665
22
        RETURN_IF_ERROR(_table_format_reader->on_fill_missing_columns(
666
22
                block, pre_read_rows, _lazy_read_ctx.predicate_missing_col_names));
667
22
        if (_need_current_batch_row_positions()) {
668
0
            RETURN_IF_ERROR(_get_current_batch_row_id(pre_read_rows));
669
0
        }
670
22
        RETURN_IF_ERROR(_table_format_reader->fill_synthesized_columns(block, pre_read_rows));
671
22
        RETURN_IF_ERROR(_table_format_reader->fill_generated_columns(block, pre_read_rows));
672
22
        RETURN_IF_ERROR(_build_pos_delete_filter(pre_read_rows));
673
674
22
#ifndef NDEBUG
675
66
        for (auto col : *block) {
676
66
            if (col.column->size() == 0) { // lazy read column.
677
22
                continue;
678
22
            }
679
44
            col.column->sanity_check();
680
44
            DCHECK(pre_read_rows == col.column->size())
681
0
                    << absl::Substitute("pre_read_rows = $0 , column rows = $1, col name = $2",
682
0
                                        pre_read_rows, col.column->size(), col.name);
683
44
        }
684
22
#endif
685
686
22
        bool can_filter_all = false;
687
22
        {
688
22
            SCOPED_RAW_TIMER(&_predicate_filter_time);
689
690
            // generate filter vector
691
22
            if (_lazy_read_ctx.resize_first_column) {
692
                // VExprContext.execute has an optimization, the filtering is executed when block->rows() > 0
693
                // The following process may be tricky and time-consuming, but we have no other way.
694
22
                auto column_guard = block->mutate_column_scoped(0);
695
22
                column_guard.mutable_column()->resize(pre_read_rows);
696
22
            }
697
22
            result_filter.assign(pre_read_rows, static_cast<unsigned char>(1));
698
22
            std::vector<IColumn::Filter*> filters;
699
22
            if (_position_delete_ctx.has_filter) {
700
0
                filters.push_back(_pos_delete_filter_ptr.get());
701
0
            }
702
703
22
            VExprContextSPtrs filter_contexts;
704
44
            for (auto& conjunct : _filter_conjuncts) {
705
44
                filter_contexts.emplace_back(conjunct);
706
44
            }
707
708
22
            {
709
22
                RETURN_IF_ERROR(VExprContext::execute_conjuncts(filter_contexts, &filters, block,
710
22
                                                                &result_filter, &can_filter_all));
711
22
            }
712
713
            // Condition cache MISS: mark granules with surviving rows
714
22
            if (!can_filter_all) {
715
11
                _mark_condition_cache_granules(result_filter.data(), pre_read_rows, batch_base_row);
716
11
            }
717
718
22
            if (_lazy_read_ctx.resize_first_column) {
719
                // We have to clean the first column to insert right data.
720
22
                block->clear_column_data(std::vector<uint32_t> {0});
721
22
            }
722
22
        }
723
724
0
        const uint8_t* __restrict filter_map_data = result_filter.data();
725
22
        filter_map_ptr = std::make_unique<FilterMap>();
726
22
        RETURN_IF_ERROR(filter_map_ptr->init(filter_map_data, pre_read_rows, can_filter_all));
727
22
        if (filter_map_ptr->filter_all()) {
728
11
            {
729
11
                SCOPED_RAW_TIMER(&_predicate_filter_time);
730
11
                std::vector<uint32_t> columns_to_clear;
731
11
                columns_to_clear.reserve(_lazy_read_ctx.predicate_columns.first.size() +
732
11
                                         _lazy_read_ctx.predicate_partition_columns.size() +
733
11
                                         _lazy_read_ctx.predicate_missing_columns.size());
734
11
                for (const auto& col : _lazy_read_ctx.predicate_columns.first) {
735
                    // clean block to read predicate columns
736
11
                    uint32_t block_pos = 0;
737
11
                    RETURN_IF_ERROR(_get_block_column_pos(*block, col, &block_pos));
738
11
                    columns_to_clear.emplace_back(block_pos);
739
11
                }
740
11
                for (const auto& col : _lazy_read_ctx.predicate_partition_columns) {
741
11
                    uint32_t block_pos = 0;
742
11
                    RETURN_IF_ERROR(_get_block_column_pos(*block, col.first, &block_pos));
743
11
                    columns_to_clear.emplace_back(block_pos);
744
11
                }
745
11
                for (const auto& col : _lazy_read_ctx.predicate_missing_columns) {
746
0
                    uint32_t block_pos = 0;
747
0
                    RETURN_IF_ERROR(_get_block_column_pos(*block, col.first, &block_pos));
748
0
                    columns_to_clear.emplace_back(block_pos);
749
0
                }
750
11
                block->clear_column_data(columns_to_clear);
751
11
                RETURN_IF_ERROR(_table_format_reader->clear_synthesized_columns(block));
752
11
                RETURN_IF_ERROR(_table_format_reader->clear_generated_columns(block));
753
11
                Block::erase_useless_column(block, origin_column_num);
754
11
            }
755
756
11
            if (!pre_eof) {
757
                // If continuous batches are skipped, we can cache them to skip a whole page
758
10
                _cached_filtered_rows += pre_read_rows;
759
10
                if (pre_raw_read_rows >= config::doris_scanner_row_num) {
760
0
                    *read_rows = 0;
761
0
                    RETURN_IF_ERROR(_convert_dict_cols_to_string_cols(block));
762
0
                    return Status::OK();
763
0
                }
764
10
            } else { // pre_eof
765
                // If filter_map_ptr->filter_all() and pre_eof, we can skip whole row group.
766
1
                *read_rows = 0;
767
1
                *batch_eof = true;
768
1
                _lazy_read_filtered_rows += (pre_read_rows + _cached_filtered_rows);
769
1
                RETURN_IF_ERROR(_convert_dict_cols_to_string_cols(block));
770
1
                return Status::OK();
771
1
            }
772
11
        } else {
773
11
            break;
774
11
        }
775
22
    }
776
11
    if (_state->is_cancelled()) {
777
0
        return Status::Cancelled("cancelled");
778
0
    }
779
780
11
    if (filter_map_ptr == nullptr) {
781
0
        DCHECK_EQ(pre_read_rows + _cached_filtered_rows, 0);
782
0
        *read_rows = 0;
783
0
        *batch_eof = true;
784
0
        RETURN_IF_ERROR(_convert_dict_cols_to_string_cols(block));
785
0
        return Status::OK();
786
0
    }
787
788
11
    FilterMap& filter_map = *filter_map_ptr;
789
11
    DorisUniqueBufferPtr<uint8_t> rebuild_filter_map = nullptr;
790
11
    if (_cached_filtered_rows != 0) {
791
0
        RETURN_IF_ERROR(_rebuild_filter_map(filter_map, rebuild_filter_map, pre_read_rows));
792
0
        pre_read_rows += _cached_filtered_rows;
793
0
        _cached_filtered_rows = 0;
794
0
    }
795
796
    // lazy read columns
797
11
    size_t lazy_read_rows;
798
11
    bool lazy_eof;
799
11
    RETURN_IF_ERROR(_read_column_data(block, _lazy_read_ctx.lazy_read_columns, pre_read_rows,
800
11
                                      &lazy_read_rows, &lazy_eof, filter_map));
801
802
11
    if (pre_read_rows != lazy_read_rows) {
803
0
        return Status::Corruption("Can't read the same number of rows when doing lazy read");
804
0
    }
805
    // pre_eof ^ lazy_eof
806
    // we set pre_read_rows as batch_size for lazy read columns, so pre_eof != lazy_eof
807
808
    // filter data in predicate columns, and remove filter column
809
11
    {
810
11
        SCOPED_RAW_TIMER(&_predicate_filter_time);
811
11
        if (filter_map.has_filter()) {
812
0
            RETURN_IF_CATCH_EXCEPTION(Block::filter_block_internal(
813
0
                    block, _lazy_read_ctx.all_predicate_col_ids, result_filter));
814
0
            Block::erase_useless_column(block, origin_column_num);
815
816
11
        } else {
817
11
            Block::erase_useless_column(block, origin_column_num);
818
11
        }
819
11
    }
820
821
11
    RETURN_IF_ERROR(_convert_dict_cols_to_string_cols(block));
822
823
11
    size_t column_num = block->columns();
824
11
    size_t column_size = 0;
825
44
    for (int i = 0; i < column_num; ++i) {
826
33
        size_t cz = block->get_by_position(i).column->size();
827
33
        if (column_size != 0 && cz != 0) {
828
22
            DCHECK_EQ(column_size, cz);
829
22
        }
830
33
        if (cz != 0) {
831
33
            column_size = cz;
832
33
        }
833
33
    }
834
11
    _lazy_read_filtered_rows += pre_read_rows - column_size;
835
11
    *read_rows = column_size;
836
837
11
    *batch_eof = pre_eof;
838
11
    DCHECK(_table_format_reader);
839
11
    RETURN_IF_ERROR(_table_format_reader->on_fill_partition_columns(
840
11
            block, column_size, _lazy_read_ctx.partition_col_names));
841
11
    RETURN_IF_ERROR(_table_format_reader->on_fill_missing_columns(
842
11
            block, column_size, _lazy_read_ctx.missing_col_names));
843
11
#ifndef NDEBUG
844
33
    for (auto col : *block) {
845
33
        col.column->sanity_check();
846
33
        DCHECK(block->rows() == col.column->size())
847
0
                << absl::Substitute("block rows = $0 , column rows = $1, col name = $2",
848
0
                                    block->rows(), col.column->size(), col.name);
849
33
    }
850
11
#endif
851
11
    return Status::OK();
852
11
}
853
854
Status RowGroupReader::_rebuild_filter_map(FilterMap& filter_map,
855
                                           DorisUniqueBufferPtr<uint8_t>& filter_map_data,
856
0
                                           size_t pre_read_rows) const {
857
0
    if (_cached_filtered_rows == 0) {
858
0
        return Status::OK();
859
0
    }
860
0
    size_t total_rows = _cached_filtered_rows + pre_read_rows;
861
0
    if (filter_map.filter_all()) {
862
0
        RETURN_IF_ERROR(filter_map.init(nullptr, total_rows, true));
863
0
        return Status::OK();
864
0
    }
865
866
0
    filter_map_data = make_unique_buffer<uint8_t>(total_rows);
867
0
    auto* map = filter_map_data.get();
868
0
    for (size_t i = 0; i < _cached_filtered_rows; ++i) {
869
0
        map[i] = 0;
870
0
    }
871
0
    const uint8_t* old_map = filter_map.filter_map_data();
872
0
    if (old_map == nullptr) {
873
        // select_vector.filter_all() == true is already built.
874
0
        for (size_t i = _cached_filtered_rows; i < total_rows; ++i) {
875
0
            map[i] = 1;
876
0
        }
877
0
    } else {
878
0
        memcpy(map + _cached_filtered_rows, old_map, pre_read_rows);
879
0
    }
880
0
    RETURN_IF_ERROR(filter_map.init(map, total_rows, false));
881
0
    return Status::OK();
882
0
}
883
884
Status RowGroupReader::_fill_partition_columns(
885
        Block* block, size_t rows,
886
        const std::unordered_map<std::string, std::tuple<std::string, const SlotDescriptor*>>&
887
0
                partition_columns) {
888
0
    DataTypeSerDe::FormatOptions _text_formatOptions;
889
0
    for (const auto& kv : partition_columns) {
890
0
        uint32_t block_pos = 0;
891
0
        RETURN_IF_ERROR(_get_block_column_pos(*block, kv.first, &block_pos));
892
0
        auto doris_column = block->get_by_position(block_pos).column;
893
        // obtained from block*, it is a mutable object.
894
0
        auto* col_ptr = const_cast<IColumn*>(doris_column.get());
895
0
        const auto& [value, slot_desc] = kv.second;
896
0
        auto _text_serde = slot_desc->get_data_type_ptr()->get_serde();
897
0
        Slice slice(value.data(), value.size());
898
0
        uint64_t num_deserialized = 0;
899
        // Be careful when reading empty rows from parquet row groups.
900
0
        if (_text_serde->deserialize_column_from_fixed_json(*col_ptr, slice, rows,
901
0
                                                            &num_deserialized,
902
0
                                                            _text_formatOptions) != Status::OK()) {
903
0
            return Status::InternalError("Failed to fill partition column: {}={}",
904
0
                                         slot_desc->col_name(), value);
905
0
        }
906
0
        if (num_deserialized != rows) {
907
0
            return Status::InternalError(
908
0
                    "Failed to fill partition column: {}={} ."
909
0
                    "Number of rows expected to be written : {}, number of rows actually written : "
910
0
                    "{}",
911
0
                    slot_desc->col_name(), value, num_deserialized, rows);
912
0
        }
913
0
    }
914
0
    return Status::OK();
915
0
}
916
917
Status RowGroupReader::_fill_missing_columns(
918
        Block* block, size_t rows,
919
0
        const std::unordered_map<std::string, VExprContextSPtr>& missing_columns) {
920
0
    for (const auto& kv : missing_columns) {
921
0
        uint32_t block_pos = 0;
922
0
        RETURN_IF_ERROR(_get_block_column_pos(*block, kv.first, &block_pos));
923
0
        if (kv.second == nullptr) {
924
            // no default column, fill with null
925
0
            auto column_guard = block->mutate_column_scoped(block_pos);
926
0
            auto& mutable_column = column_guard.mutable_column();
927
0
            auto* nullable_column = assert_cast<ColumnNullable*>(mutable_column.get());
928
0
            nullable_column->insert_many_defaults(rows);
929
0
        } else {
930
            // fill with default value
931
0
            const auto& ctx = kv.second;
932
0
            ColumnPtr result_column_ptr;
933
            // PT1 => dest primitive type
934
0
            RETURN_IF_ERROR(ctx->execute(block, result_column_ptr));
935
0
            if (result_column_ptr->use_count() == 1) {
936
                // call resize because the first column of _src_block_ptr may not be filled by reader,
937
                // so _src_block_ptr->rows() may return wrong result, cause the column created by `ctx->execute()`
938
                // has only one row.
939
0
                auto mutable_column = result_column_ptr->assert_mutable();
940
0
                mutable_column->resize(rows);
941
                // result_column_ptr maybe a ColumnConst, convert it to a normal column
942
0
                result_column_ptr = result_column_ptr->convert_to_full_column_if_const();
943
0
                auto origin_column_type = block->get_by_position(block_pos).type;
944
0
                bool is_nullable = origin_column_type->is_nullable();
945
0
                block->replace_by_position(block_pos, is_nullable ? make_nullable(result_column_ptr)
946
0
                                                                  : result_column_ptr);
947
0
            }
948
0
        }
949
0
    }
950
0
    return Status::OK();
951
0
}
952
953
Status RowGroupReader::_get_block_column_pos(const Block& block, const std::string& column_name,
954
231
                                             uint32_t* position) const {
955
231
    if (_col_name_to_block_idx == nullptr) {
956
0
        return Status::InternalError(
957
0
                "Column name to block index map is not set when reading parquet column '{}', "
958
0
                "block: "
959
0
                "{}",
960
0
                column_name, block.dump_structure());
961
0
    }
962
231
    auto iter = _col_name_to_block_idx->find(column_name);
963
231
    if (iter == _col_name_to_block_idx->end()) {
964
0
        return Status::InternalError("Column '{}' not found in block index map, block: {}",
965
0
                                     column_name, block.dump_structure());
966
0
    }
967
231
    if (iter->second >= block.columns()) {
968
0
        return Status::InternalError(
969
0
                "Column '{}' maps to invalid block position {}, block columns: {}, block: {}",
970
0
                column_name, iter->second, block.columns(), block.dump_structure());
971
0
    }
972
231
    *position = iter->second;
973
231
    return Status::OK();
974
231
}
975
976
105
bool RowGroupReader::_need_current_batch_row_positions() const {
977
105
    DCHECK(_table_format_reader);
978
105
    return _table_format_reader->has_synthesized_column_handlers() ||
979
105
           _table_format_reader->has_generated_column_handlers();
980
105
}
981
982
11
Status RowGroupReader::_read_empty_batch(size_t batch_size, size_t* read_rows, bool* batch_eof) {
983
11
    if (_position_delete_ctx.has_filter) {
984
0
        int64_t start_row_id = _position_delete_ctx.current_row_id;
985
0
        int64_t end_row_id = std::min(_position_delete_ctx.current_row_id + (int64_t)batch_size,
986
0
                                      _position_delete_ctx.last_row_id);
987
0
        int64_t num_delete_rows = 0;
988
0
        auto before_index = _position_delete_ctx.index;
989
0
        while (_position_delete_ctx.index < _position_delete_ctx.end_index) {
990
0
            const int64_t& delete_row_id =
991
0
                    _position_delete_ctx.delete_rows[_position_delete_ctx.index];
992
0
            if (delete_row_id < start_row_id) {
993
0
                _position_delete_ctx.index++;
994
0
                before_index = _position_delete_ctx.index;
995
0
            } else if (delete_row_id < end_row_id) {
996
0
                num_delete_rows++;
997
0
                _position_delete_ctx.index++;
998
0
            } else { // delete_row_id >= end_row_id
999
0
                break;
1000
0
            }
1001
0
        }
1002
0
        *read_rows = end_row_id - start_row_id - num_delete_rows;
1003
0
        _position_delete_ctx.current_row_id = end_row_id;
1004
0
        *batch_eof = _position_delete_ctx.current_row_id == _position_delete_ctx.last_row_id;
1005
1006
0
        if (_need_current_batch_row_positions()) {
1007
0
            _current_batch_row_ids.clear();
1008
0
            _current_batch_row_ids.resize(*read_rows);
1009
0
            size_t idx = 0;
1010
0
            for (auto id = start_row_id; id < end_row_id; id++) {
1011
0
                if (before_index < _position_delete_ctx.index &&
1012
0
                    id == _position_delete_ctx.delete_rows[before_index]) {
1013
0
                    before_index++;
1014
0
                    continue;
1015
0
                }
1016
0
                _current_batch_row_ids[idx++] = (rowid_t)id;
1017
0
            }
1018
0
        }
1019
11
    } else {
1020
11
        if (batch_size < _remaining_rows) {
1021
10
            *read_rows = batch_size;
1022
10
            _remaining_rows -= batch_size;
1023
10
            *batch_eof = false;
1024
10
        } else {
1025
1
            *read_rows = _remaining_rows;
1026
1
            _remaining_rows = 0;
1027
1
            *batch_eof = true;
1028
1
        }
1029
11
        if (_need_current_batch_row_positions()) {
1030
0
            RETURN_IF_ERROR(_get_current_batch_row_id(*read_rows));
1031
0
        }
1032
11
    }
1033
11
    _total_read_rows += *read_rows;
1034
11
    return Status::OK();
1035
11
}
1036
1037
5
Status RowGroupReader::_get_current_batch_row_id(size_t read_rows) {
1038
5
    _current_batch_row_ids.clear();
1039
5
    _current_batch_row_ids.resize(read_rows);
1040
1041
5
    int64_t idx = 0;
1042
5
    int64_t read_range_rows = 0;
1043
19
    for (size_t range_idx = 0; range_idx < _read_ranges.range_size(); range_idx++) {
1044
14
        auto range = _read_ranges.get_range(range_idx);
1045
14
        if (read_rows == 0) {
1046
0
            break;
1047
0
        }
1048
14
        if (read_range_rows + (range.to() - range.from()) > _total_read_rows) {
1049
14
            int64_t fi =
1050
14
                    std::max(_total_read_rows, read_range_rows) - read_range_rows + range.from();
1051
14
            size_t len = std::min(read_rows, (size_t)(std::max(range.to(), fi) - fi));
1052
1053
14
            read_rows -= len;
1054
1055
28
            for (auto i = 0; i < len; i++) {
1056
14
                _current_batch_row_ids[idx++] =
1057
14
                        (rowid_t)(fi + i + _current_row_group_idx.first_row);
1058
14
            }
1059
14
        }
1060
14
        read_range_rows += range.to() - range.from();
1061
14
    }
1062
5
    return Status::OK();
1063
5
}
1064
1065
94
Status RowGroupReader::_build_pos_delete_filter(size_t read_rows) {
1066
94
    if (!_position_delete_ctx.has_filter) {
1067
94
        _pos_delete_filter_ptr.reset(nullptr);
1068
94
        _total_read_rows += read_rows;
1069
94
        return Status::OK();
1070
94
    }
1071
0
    _pos_delete_filter_ptr.reset(new IColumn::Filter(read_rows, 1));
1072
0
    auto* __restrict _pos_delete_filter_data = _pos_delete_filter_ptr->data();
1073
0
    while (_position_delete_ctx.index < _position_delete_ctx.end_index) {
1074
0
        const int64_t delete_row_index_in_row_group =
1075
0
                _position_delete_ctx.delete_rows[_position_delete_ctx.index] -
1076
0
                _position_delete_ctx.first_row_id;
1077
0
        int64_t read_range_rows = 0;
1078
0
        size_t remaining_read_rows = _total_read_rows + read_rows;
1079
0
        for (size_t range_idx = 0; range_idx < _read_ranges.range_size(); range_idx++) {
1080
0
            auto range = _read_ranges.get_range(range_idx);
1081
0
            if (delete_row_index_in_row_group < range.from()) {
1082
0
                ++_position_delete_ctx.index;
1083
0
                break;
1084
0
            } else if (delete_row_index_in_row_group < range.to()) {
1085
0
                int64_t index = (delete_row_index_in_row_group - range.from()) + read_range_rows -
1086
0
                                _total_read_rows;
1087
0
                if (index > read_rows - 1) {
1088
0
                    _total_read_rows += read_rows;
1089
0
                    return Status::OK();
1090
0
                }
1091
0
                _pos_delete_filter_data[index] = 0;
1092
0
                ++_position_delete_ctx.index;
1093
0
                break;
1094
0
            } else { // delete_row >= range.last_row
1095
0
            }
1096
1097
0
            int64_t range_size = range.to() - range.from();
1098
            // Don't search next range when there is no remaining_read_rows.
1099
0
            if (remaining_read_rows <= range_size) {
1100
0
                _total_read_rows += read_rows;
1101
0
                return Status::OK();
1102
0
            } else {
1103
0
                remaining_read_rows -= range_size;
1104
0
                read_range_rows += range_size;
1105
0
            }
1106
0
        }
1107
0
    }
1108
0
    _total_read_rows += read_rows;
1109
0
    return Status::OK();
1110
0
}
1111
1112
// need exception safety
1113
Status RowGroupReader::_filter_block(Block* block, int column_to_keep,
1114
60
                                     const std::vector<uint32_t>& columns_to_filter) {
1115
60
    if (_pos_delete_filter_ptr) {
1116
0
        RETURN_IF_CATCH_EXCEPTION(
1117
0
                Block::filter_block_internal(block, columns_to_filter, (*_pos_delete_filter_ptr)));
1118
0
    }
1119
60
    Block::erase_useless_column(block, column_to_keep);
1120
1121
60
    return Status::OK();
1122
60
}
1123
1124
4
Status RowGroupReader::_rewrite_dict_predicates() {
1125
4
    SCOPED_RAW_TIMER(&_dict_filter_rewrite_time);
1126
5
    for (auto it = _dict_filter_cols.begin(); it != _dict_filter_cols.end();) {
1127
1
        std::string& dict_filter_col_name = it->first;
1128
1
        int slot_id = it->second;
1129
        // 1. Get dictionary values to a string column.
1130
1
        MutableColumnPtr dict_value_column = ColumnString::create();
1131
1
        bool has_dict = false;
1132
1
        RETURN_IF_ERROR(_column_readers[dict_filter_col_name]->read_dict_values_to_column(
1133
1
                dict_value_column, &has_dict));
1134
1
#ifndef NDEBUG
1135
1
        dict_value_column->sanity_check();
1136
1
#endif
1137
1
        size_t dict_value_column_size = dict_value_column->size();
1138
1
        DCHECK(has_dict);
1139
        // 2. Build a temp block from the dict string column, then execute conjuncts and filter block.
1140
        // 2.1 Build a temp block from the dict string column to match the conjuncts executing.
1141
1
        Block temp_block;
1142
1
        int dict_pos = -1;
1143
1
        int index = 0;
1144
3
        for (const auto slot_desc : _tuple_descriptor->slots()) {
1145
3
            if (slot_desc->id() == slot_id) {
1146
1
                auto data_type = slot_desc->get_data_type_ptr();
1147
1
                if (data_type->is_nullable()) {
1148
0
                    temp_block.insert(
1149
0
                            {ColumnNullable::create(
1150
0
                                     std::move(
1151
0
                                             dict_value_column), // NOLINT(bugprone-use-after-move)
1152
0
                                     ColumnUInt8::create(dict_value_column_size, 0)),
1153
0
                             std::make_shared<DataTypeNullable>(std::make_shared<DataTypeString>()),
1154
0
                             ""});
1155
1
                } else {
1156
1
                    temp_block.insert(
1157
1
                            {std::move(dict_value_column), std::make_shared<DataTypeString>(), ""});
1158
1
                }
1159
1
                dict_pos = index;
1160
1161
2
            } else {
1162
2
                temp_block.insert(ColumnWithTypeAndName(slot_desc->get_empty_mutable_column(),
1163
2
                                                        slot_desc->get_data_type_ptr(),
1164
2
                                                        slot_desc->col_name()));
1165
2
            }
1166
3
            ++index;
1167
3
        }
1168
1169
        // 2.2 Execute conjuncts.
1170
1
        VExprContextSPtrs ctxs;
1171
1
        auto iter = _slot_id_to_filter_conjuncts->find(slot_id);
1172
1
        if (iter != _slot_id_to_filter_conjuncts->end()) {
1173
1
            for (auto& ctx : iter->second) {
1174
1
                ctxs.push_back(ctx);
1175
1
            }
1176
1
        } else {
1177
0
            std::stringstream msg;
1178
0
            msg << "_slot_id_to_filter_conjuncts: slot_id [" << slot_id << "] not found";
1179
0
            return Status::NotFound(msg.str());
1180
0
        }
1181
1182
1
        if (dict_pos != 0) {
1183
            // VExprContext.execute has an optimization, the filtering is executed when block->rows() > 0
1184
            // The following process may be tricky and time-consuming, but we have no other way.
1185
1
            temp_block.get_by_position(0).column->assert_mutable()->resize(dict_value_column_size);
1186
1
        }
1187
1
        IColumn::Filter result_filter(temp_block.rows(), 1);
1188
1
        bool can_filter_all;
1189
1
        {
1190
1
            RETURN_IF_ERROR(VExprContext::execute_conjuncts(ctxs, nullptr, &temp_block,
1191
1
                                                            &result_filter, &can_filter_all));
1192
1
        }
1193
1
        if (dict_pos != 0) {
1194
            // We have to clean the first column to insert right data.
1195
1
            temp_block.get_by_position(0).column->assert_mutable()->clear();
1196
1
        }
1197
1198
        // If can_filter_all = true, can filter this row group.
1199
1
        if (can_filter_all) {
1200
0
            _is_row_group_filtered = true;
1201
0
            return Status::OK();
1202
0
        }
1203
1204
        // 3. Get dict codes.
1205
1
        std::vector<int32_t> dict_codes;
1206
3
        for (size_t i = 0; i < result_filter.size(); ++i) {
1207
2
            if (result_filter[i]) {
1208
1
                dict_codes.emplace_back(i);
1209
1
            }
1210
2
        }
1211
1212
        // About Performance: if dict_column size is too large, it will generate a large IN filter.
1213
1
        if (dict_codes.size() > MAX_DICT_CODE_PREDICATE_TO_REWRITE) {
1214
0
            it = _dict_filter_cols.erase(it);
1215
0
            for (auto& ctx : ctxs) {
1216
0
                _filter_conjuncts.push_back(ctx);
1217
0
            }
1218
0
            continue;
1219
0
        }
1220
1221
        // 4. Rewrite conjuncts.
1222
1
        RETURN_IF_ERROR(_rewrite_dict_conjuncts(
1223
1
                dict_codes, slot_id, temp_block.get_by_position(dict_pos).column->is_nullable()));
1224
1
        ++it;
1225
1
    }
1226
4
    return Status::OK();
1227
4
}
1228
1229
Status RowGroupReader::_rewrite_dict_conjuncts(std::vector<int32_t>& dict_codes, int slot_id,
1230
1
                                               bool is_nullable) {
1231
1
    VExprSPtr root;
1232
1
    if (dict_codes.size() == 1) {
1233
1
        {
1234
1
            TFunction fn;
1235
1
            TFunctionName fn_name;
1236
1
            fn_name.__set_db_name("");
1237
1
            fn_name.__set_function_name("eq");
1238
1
            fn.__set_name(fn_name);
1239
1
            fn.__set_binary_type(TFunctionBinaryType::BUILTIN);
1240
1
            std::vector<TTypeDesc> arg_types;
1241
1
            arg_types.push_back(create_type_desc(PrimitiveType::TYPE_INT));
1242
1
            arg_types.push_back(create_type_desc(PrimitiveType::TYPE_INT));
1243
1
            fn.__set_arg_types(arg_types);
1244
1
            fn.__set_ret_type(create_type_desc(PrimitiveType::TYPE_BOOLEAN));
1245
1
            fn.__set_has_var_args(false);
1246
1247
1
            TExprNode texpr_node;
1248
1
            texpr_node.__set_type(create_type_desc(PrimitiveType::TYPE_BOOLEAN));
1249
1
            texpr_node.__set_node_type(TExprNodeType::BINARY_PRED);
1250
1
            texpr_node.__set_opcode(TExprOpcode::EQ);
1251
1
            texpr_node.__set_fn(fn);
1252
1
            texpr_node.__set_num_children(2);
1253
1
            texpr_node.__set_is_nullable(is_nullable);
1254
1
            root = VectorizedFnCall::create_shared(texpr_node);
1255
1
        }
1256
1
        {
1257
1
            SlotDescriptor* slot = nullptr;
1258
1
            const std::vector<SlotDescriptor*>& slots = _tuple_descriptor->slots();
1259
3
            for (auto each : slots) {
1260
3
                if (each->id() == slot_id) {
1261
1
                    slot = each;
1262
1
                    break;
1263
1
                }
1264
3
            }
1265
1
            root->add_child(VSlotRef::create_shared(slot));
1266
1
        }
1267
1
        {
1268
1
            TExprNode texpr_node;
1269
1
            texpr_node.__set_node_type(TExprNodeType::INT_LITERAL);
1270
1
            texpr_node.__set_type(create_type_desc(TYPE_INT));
1271
1
            TIntLiteral int_literal;
1272
1
            int_literal.__set_value(dict_codes[0]);
1273
1
            texpr_node.__set_int_literal(int_literal);
1274
1
            texpr_node.__set_is_nullable(is_nullable);
1275
1
            root->add_child(VLiteral::create_shared(texpr_node));
1276
1
        }
1277
1
    } else {
1278
0
        {
1279
0
            TTypeDesc type_desc = create_type_desc(PrimitiveType::TYPE_BOOLEAN);
1280
0
            TExprNode node;
1281
0
            node.__set_type(type_desc);
1282
0
            node.__set_node_type(TExprNodeType::IN_PRED);
1283
0
            node.in_predicate.__set_is_not_in(false);
1284
0
            node.__set_opcode(TExprOpcode::FILTER_IN);
1285
            // VdirectInPredicate assume is_nullable = false.
1286
0
            node.__set_is_nullable(false);
1287
1288
0
            std::shared_ptr<HybridSetBase> hybrid_set(
1289
0
                    create_set(PrimitiveType::TYPE_INT, dict_codes.size(), false));
1290
0
            for (int j = 0; j < dict_codes.size(); ++j) {
1291
0
                hybrid_set->insert(&dict_codes[j]);
1292
0
            }
1293
0
            root = VDirectInPredicate::create_shared(node, hybrid_set, false);
1294
0
        }
1295
0
        {
1296
0
            SlotDescriptor* slot = nullptr;
1297
0
            const std::vector<SlotDescriptor*>& slots = _tuple_descriptor->slots();
1298
0
            for (auto each : slots) {
1299
0
                if (each->id() == slot_id) {
1300
0
                    slot = each;
1301
0
                    break;
1302
0
                }
1303
0
            }
1304
0
            root->add_child(VSlotRef::create_shared(slot));
1305
0
        }
1306
0
    }
1307
1
    VExprContextSPtr rewritten_conjunct_ctx = VExprContext::create_shared(root);
1308
1
    RETURN_IF_ERROR(rewritten_conjunct_ctx->prepare(_state, *_row_descriptor));
1309
1
    RETURN_IF_ERROR(rewritten_conjunct_ctx->open(_state));
1310
1
    _dict_filter_conjuncts.push_back(rewritten_conjunct_ctx);
1311
1
    _filter_conjuncts.push_back(rewritten_conjunct_ctx);
1312
1
    return Status::OK();
1313
1
}
1314
1315
84
Status RowGroupReader::_convert_dict_cols_to_string_cols(Block* block) {
1316
84
    for (auto& dict_filter_cols : _dict_filter_cols) {
1317
1
        uint32_t block_pos = 0;
1318
1
        RETURN_IF_ERROR(_get_block_column_pos(*block, dict_filter_cols.first, &block_pos));
1319
1
        auto reader_iter = _column_readers.find(dict_filter_cols.first);
1320
1
        if (reader_iter == _column_readers.end() || reader_iter->second == nullptr) {
1321
0
            return Status::InternalError("Column reader for '{}' not found in parquet row group",
1322
0
                                         dict_filter_cols.first);
1323
0
        }
1324
1
        ColumnWithTypeAndName& column_with_type_and_name = block->get_by_position(block_pos);
1325
1
        const ColumnPtr& column = column_with_type_and_name.column;
1326
1
        if (const auto* nullable_column = check_and_get_column<ColumnNullable>(*column)) {
1327
0
            const ColumnPtr& nested_column = nullable_column->get_nested_column_ptr();
1328
0
            const auto* dict_column = assert_cast<const ColumnInt32*>(nested_column.get());
1329
0
            DCHECK(dict_column);
1330
1331
0
            auto string_column = DORIS_TRY(
1332
0
                    reader_iter->second->convert_dict_column_to_string_column(dict_column));
1333
1334
0
            column_with_type_and_name.type =
1335
0
                    std::make_shared<DataTypeNullable>(std::make_shared<DataTypeString>());
1336
0
            block->replace_by_position(
1337
0
                    block_pos, ColumnNullable::create(std::move(string_column),
1338
0
                                                      nullable_column->get_null_map_column_ptr()));
1339
1
        } else {
1340
1
            const auto* dict_column = assert_cast<const ColumnInt32*>(column.get());
1341
1
            auto string_column = DORIS_TRY(
1342
1
                    reader_iter->second->convert_dict_column_to_string_column(dict_column));
1343
1344
1
            column_with_type_and_name.type = std::make_shared<DataTypeString>();
1345
1
            block->replace_by_position(block_pos, std::move(string_column));
1346
1
        }
1347
1
    }
1348
84
    return Status::OK();
1349
84
}
1350
1351
45
ParquetColumnReader::ColumnStatistics RowGroupReader::merged_column_statistics() {
1352
45
    ParquetColumnReader::ColumnStatistics st;
1353
119
    for (auto& reader : _column_readers) {
1354
119
        auto ost = reader.second->column_statistics();
1355
119
        st.merge(ost);
1356
119
    }
1357
45
    return st;
1358
45
}
1359
1360
} // namespace doris