Coverage Report

Created: 2026-04-15 17:34

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
be/src/exec/exchange/vdata_stream_sender.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 "exec/exchange/vdata_stream_sender.h"
19
20
#include <fmt/format.h>
21
#include <fmt/ranges.h> // IWYU pragma: keep
22
#include <gen_cpp/DataSinks_types.h>
23
#include <gen_cpp/Metrics_types.h>
24
#include <gen_cpp/Types_types.h>
25
#include <gen_cpp/data.pb.h>
26
#include <gen_cpp/internal_service.pb.h>
27
#include <glog/logging.h>
28
#include <stddef.h>
29
30
#include <algorithm>
31
#include <cstdint>
32
#include <functional>
33
#include <map>
34
#include <memory>
35
#include <random>
36
37
#include "common/object_pool.h"
38
#include "common/status.h"
39
#include "core/column/column_const.h"
40
#include "exec/common/sip_hash.h"
41
#include "exec/exchange/vdata_stream_mgr.h"
42
#include "exec/exchange/vdata_stream_recvr.h"
43
#include "exec/operator/exchange_sink_operator.h"
44
#include "exec/operator/result_file_sink_operator.h"
45
#include "exec/sink/vrow_distribution.h"
46
#include "exec/sink/writer/vtablet_writer_v2.h"
47
#include "exprs/vexpr.h"
48
#include "runtime/descriptors.h"
49
#include "runtime/runtime_state.h"
50
#include "runtime/thread_context.h"
51
#include "storage/tablet_info.h"
52
#include "util/proto_util.h"
53
54
namespace doris {
55
56
4.54M
Status Channel::init(RuntimeState* state) {
57
    // only enable_local_exchange() is true and the destination address is localhost, then the channel is local
58
4.54M
    _is_local &= state->enable_local_exchange();
59
60
4.54M
    if (_is_local) {
61
2.02M
        return Status::OK();
62
2.02M
    }
63
64
2.51M
    RETURN_IF_ERROR(_init_brpc_stub(state));
65
66
2.51M
    return Status::OK();
67
2.51M
}
68
69
2.52M
Status Channel::_init_brpc_stub(RuntimeState* state) {
70
2.52M
    if (_brpc_dest_addr.hostname.empty()) {
71
0
        LOG(WARNING) << "there is no brpc destination address's hostname"
72
0
                        ", maybe version is not compatible.";
73
0
        return Status::InternalError("no brpc destination");
74
0
    }
75
76
2.52M
    auto network_address = _brpc_dest_addr;
77
2.53M
    if (_brpc_dest_addr.hostname == BackendOptions::get_localhost()) {
78
2.53M
        _brpc_stub = state->exec_env()->brpc_internal_client_cache()->get_client(
79
2.53M
                "127.0.0.1", _brpc_dest_addr.port);
80
2.53M
        network_address.hostname = "127.0.0.1";
81
18.4E
    } else {
82
18.4E
        _brpc_stub = state->exec_env()->brpc_internal_client_cache()->get_client(_brpc_dest_addr);
83
18.4E
    }
84
85
2.52M
    if (!_brpc_stub) {
86
0
        std::string msg = fmt::format("Get rpc stub failed, dest_addr={}:{}",
87
0
                                      _brpc_dest_addr.hostname, _brpc_dest_addr.port);
88
0
        LOG(WARNING) << msg;
89
0
        return Status::InternalError(msg);
90
0
    }
91
92
2.54M
    if (config::enable_brpc_connection_check) {
93
2.54M
        state->get_query_ctx()->add_using_brpc_stub(_brpc_dest_addr, _brpc_stub);
94
2.54M
    }
95
2.52M
    return Status::OK();
96
2.52M
}
97
98
4.38M
Status Channel::open(RuntimeState* state) {
99
4.38M
    if (_is_local) {
100
2.06M
        RETURN_IF_ERROR(_find_local_recvr(state));
101
2.06M
    }
102
4.38M
    _be_number = state->be_number();
103
4.38M
    _brpc_timeout_ms = get_execution_rpc_timeout_ms(state->execution_timeout());
104
4.38M
    _serializer.set_is_local(_is_local);
105
106
    // In bucket shuffle join will set fragment_instance_id (-1, -1)
107
    // to build a camouflaged empty channel. the ip and port is '0.0.0.0:0"
108
    // so the empty channel not need call function close_internal()
109
4.38M
    _need_close = (_fragment_instance_id.hi != -1 && _fragment_instance_id.lo != -1);
110
111
4.38M
    return Status::OK();
112
4.38M
}
113
114
2.05M
Status Channel::_find_local_recvr(RuntimeState* state) {
115
2.05M
    auto st = _parent->state()->exec_env()->vstream_mgr()->find_recvr(_fragment_instance_id,
116
2.05M
                                                                      _dest_node_id, &_local_recvr);
117
2.05M
    if (!st.ok()) {
118
        // If could not find local receiver, then it means the channel is EOF.
119
        // Maybe downstream task is finished already.
120
        //if (_receiver_status.ok()) {
121
        //    _receiver_status = Status::EndOfFile("local data stream receiver is deconstructed");
122
        //}
123
4.85k
        LOG(INFO) << "Query: " << print_id(state->query_id())
124
4.85k
                  << " recvr is not found, maybe downstream task is finished. error st is: "
125
4.85k
                  << st.to_string();
126
4.85k
    }
127
2.05M
    return Status::OK();
128
2.05M
}
129
Status Channel::add_rows(Block* block, const uint32_t* data, const uint32_t offset,
130
4.05M
                         const uint32_t size, bool eos) {
131
4.05M
    if (_fragment_instance_id.lo == -1) {
132
1.49k
        return Status::OK();
133
1.49k
    }
134
135
4.04M
    bool serialized = false;
136
4.04M
    if (_pblock == nullptr) {
137
3.99M
        _pblock = std::make_unique<PBlock>();
138
3.99M
    }
139
4.04M
    RETURN_IF_ERROR(_serializer.next_serialized_block(block, _pblock.get(), 1, &serialized, eos,
140
4.04M
                                                      data, offset, size));
141
4.04M
    if (serialized) {
142
3.97M
        RETURN_IF_ERROR(_send_current_block(eos));
143
3.97M
    }
144
145
4.03M
    return Status::OK();
146
4.04M
}
147
148
2.06M
std::shared_ptr<Dependency> Channel::get_local_channel_dependency() {
149
2.06M
    if (!_local_recvr) {
150
4.85k
        return nullptr;
151
4.85k
    }
152
2.05M
    return _local_recvr->get_local_channel_dependency(_parent->sender_id());
153
2.06M
}
154
155
9.75M
int64_t Channel::mem_usage() const {
156
9.75M
    return _serializer.mem_usage();
157
9.75M
}
158
159
4.76M
Status Channel::send_remote_block(std::unique_ptr<PBlock>&& block, bool eos) {
160
4.76M
    COUNTER_UPDATE(_parent->blocks_sent_counter(), 1);
161
162
4.78M
    if (eos) {
163
4.78M
        if (_eos_send) {
164
2.40M
            return Status::OK();
165
2.40M
        } else {
166
2.38M
            _eos_send = true;
167
2.38M
        }
168
4.78M
    }
169
2.40M
    if (eos || block->column_metas_size()) {
170
2.40M
        RETURN_IF_ERROR(_buffer->add_block(this, {std::move(block), eos}));
171
2.40M
    }
172
2.35M
    return Status::OK();
173
2.36M
}
174
175
147k
Status Channel::send_broadcast_block(std::shared_ptr<BroadcastPBlockHolder>& block, bool eos) {
176
147k
    COUNTER_UPDATE(_parent->blocks_sent_counter(), 1);
177
148k
    if (eos) {
178
148k
        if (_eos_send) {
179
0
            return Status::OK();
180
0
        }
181
148k
        _eos_send = true;
182
148k
    }
183
148k
    if (eos || block->get_block()->column_metas_size()) {
184
148k
        RETURN_IF_ERROR(_buffer->add_block(this, {block, eos}));
185
148k
    }
186
147k
    return Status::OK();
187
147k
}
188
189
8.50M
Status Channel::_send_current_block(bool eos) {
190
8.50M
    if (is_local()) {
191
3.78M
        return _send_local_block(eos);
192
3.78M
    }
193
    // here _pblock maybe nullptr , but we must send the eos to the receiver
194
4.72M
    return send_remote_block(std::move(_pblock), eos);
195
8.50M
}
196
197
3.77M
Status Channel::_send_local_block(bool eos) {
198
3.77M
    Block block;
199
3.77M
    if (_serializer.get_block() != nullptr) {
200
3.45M
        block = _serializer.get_block()->to_block();
201
3.45M
        _serializer.get_block()->set_mutable_columns(block.clone_empty_columns());
202
3.45M
    }
203
204
3.78M
    if (!block.empty() || eos) { // if eos is true, we MUST to send an empty block
205
3.78M
        RETURN_IF_ERROR(send_local_block(&block, eos, true));
206
3.78M
    }
207
3.77M
    return Status::OK();
208
3.77M
}
209
210
4.17M
Status Channel::send_local_block(Block* block, bool eos, bool can_be_moved) {
211
4.17M
    SCOPED_TIMER(_parent->local_send_timer());
212
213
4.17M
    if (eos) {
214
4.09M
        if (_eos_send) {
215
2.02M
            return Status::OK();
216
2.06M
        } else {
217
2.06M
            _eos_send = true;
218
2.06M
        }
219
4.09M
    }
220
221
2.14M
    if (is_receiver_eof()) {
222
0
        return _receiver_status;
223
0
    }
224
2.14M
    auto receiver_status = _recvr_status();
225
    // _local_recvr depdend on ExchangeLocalState* _parent to do some memory counter settings
226
    // but it only owns a raw pointer, so that the ExchangeLocalState object may be deconstructed.
227
    // Lock the fragment context to ensure the runtime state and other objects are not deconstructed
228
2.14M
    TaskExecutionContextSPtr ctx_lock = nullptr;
229
2.15M
    if (receiver_status.ok() && _local_recvr != nullptr) {
230
2.15M
        ctx_lock = _local_recvr->task_exec_ctx();
231
        // Do not return internal error, because when query finished, the downstream node
232
        // may finish before upstream node. And the object maybe deconstructed. If return error
233
        // then the upstream node may report error status to FE, the query is failed.
234
2.15M
        if (ctx_lock == nullptr) {
235
0
            receiver_status = Status::EndOfFile("local data stream receiver is deconstructed");
236
0
        }
237
2.15M
    }
238
2.15M
    if (receiver_status.ok()) {
239
2.15M
        COUNTER_UPDATE(_parent->local_bytes_send_counter(), block->bytes());
240
2.15M
        COUNTER_UPDATE(_parent->local_sent_rows(), block->rows());
241
2.15M
        COUNTER_UPDATE(_parent->blocks_sent_counter(), 1);
242
243
2.15M
        const auto sender_id = _parent->sender_id();
244
2.15M
        if (!block->empty()) [[likely]] {
245
159k
            _local_recvr->add_block(block, sender_id, can_be_moved);
246
159k
        }
247
248
2.15M
        if (eos) [[unlikely]] {
249
2.06M
            _local_recvr->remove_sender(sender_id, _be_number, Status::OK());
250
2.06M
            _parent->on_channel_finished(_fragment_instance_id.lo);
251
2.06M
        }
252
2.15M
        return Status::OK();
253
18.4E
    } else {
254
18.4E
        _receiver_status = std::move(receiver_status);
255
18.4E
        _parent->on_channel_finished(_fragment_instance_id.lo);
256
18.4E
        return _receiver_status;
257
18.4E
    }
258
2.14M
}
259
260
0
std::string Channel::debug_string() const {
261
0
    fmt::memory_buffer debug_string_buffer;
262
0
    fmt::format_to(debug_string_buffer,
263
0
                   "fragment_instance_id: {}, _dest_node_id: {}, _is_local: {}, _receiver_status: "
264
0
                   "{}, _closed: {}, _need_close: {}, _be_number: {}, _eos_send: {}",
265
0
                   print_id(_fragment_instance_id), _dest_node_id, _is_local,
266
0
                   _receiver_status.to_string(), _closed, _need_close, _be_number, _eos_send);
267
0
    if (_is_local) {
268
0
        fmt::format_to(debug_string_buffer, "_local_recvr: {}", _local_recvr->debug_string());
269
0
    }
270
0
    return fmt::to_string(debug_string_buffer);
271
0
}
272
273
4.59M
Status Channel::close(RuntimeState* state) {
274
4.59M
    if (_closed) {
275
12.3k
        return Status::OK();
276
12.3k
    }
277
4.58M
    _closed = true;
278
4.58M
    if (!_need_close) {
279
23
        return Status::OK();
280
23
    }
281
282
4.58M
    if (is_receiver_eof()) {
283
10.0k
        _serializer.reset_block();
284
10.0k
        return Status::OK();
285
4.57M
    } else {
286
4.57M
        return _send_current_block(true);
287
4.57M
    }
288
4.58M
}
289
290
BlockSerializer::BlockSerializer(ExchangeSinkLocalState* parent, bool is_local)
291
5.20M
        : _parent(parent), _is_local(is_local), _batch_size(parent->state()->batch_size()) {}
292
293
Status BlockSerializer::next_serialized_block(Block* block, PBlock* dest, size_t num_receivers,
294
                                              bool* serialized, bool eos, const uint32_t* data,
295
4.19M
                                              const uint32_t offset, const uint32_t size) {
296
4.19M
    if (_mutable_block == nullptr) {
297
4.09M
        _mutable_block = MutableBlock::create_unique(block->clone_empty());
298
4.09M
    }
299
300
4.19M
    {
301
4.19M
        SCOPED_TIMER(_parent->merge_block_timer());
302
4.19M
        if (data) {
303
4.05M
            if (size > 0) {
304
67.9k
                RETURN_IF_ERROR(
305
67.9k
                        _mutable_block->add_rows(block, data + offset, data + offset + size));
306
67.9k
            }
307
4.05M
        } else if (!block->empty()) {
308
49.9k
            RETURN_IF_ERROR(_mutable_block->merge(*block));
309
49.9k
        }
310
4.19M
    }
311
312
4.21M
    if (_mutable_block->rows() >= _batch_size || eos ||
313
4.19M
        (_mutable_block->rows() > 0 && _mutable_block->allocated_bytes() > _buffer_mem_limit)) {
314
4.12M
        if (!_is_local) {
315
2.26M
            RETURN_IF_ERROR(_serialize_block(dest, num_receivers));
316
2.26M
        }
317
4.12M
        *serialized = true;
318
4.12M
    } else {
319
69.6k
        *serialized = false;
320
69.6k
    }
321
4.19M
    return Status::OK();
322
4.19M
}
323
324
2.25M
Status BlockSerializer::_serialize_block(PBlock* dest, size_t num_receivers) {
325
2.25M
    if (_mutable_block && _mutable_block->rows() > 0) {
326
23.5k
        auto block = _mutable_block->to_block();
327
23.5k
        RETURN_IF_ERROR(serialize_block(&block, dest, num_receivers));
328
23.5k
        if (_parent->state()->low_memory_mode()) {
329
0
            reset_block();
330
23.5k
        } else {
331
23.5k
            block.clear_column_data();
332
23.5k
            _mutable_block->set_mutable_columns(block.mutate_columns());
333
23.5k
        }
334
23.5k
    }
335
336
2.25M
    return Status::OK();
337
2.25M
}
338
339
75.5k
Status BlockSerializer::serialize_block(const Block* src, PBlock* dest, size_t num_receivers) {
340
75.5k
    SCOPED_TIMER(_parent->_serialize_batch_timer);
341
75.5k
    dest->Clear();
342
75.5k
    size_t uncompressed_bytes = 0, compressed_bytes = 0;
343
75.5k
    int64_t compress_time = 0;
344
75.5k
    RETURN_IF_ERROR(src->serialize(_parent->_state->be_exec_version(), dest, &uncompressed_bytes,
345
75.5k
                                   &compressed_bytes, &compress_time, _parent->compression_type(),
346
75.5k
                                   _parent->transfer_large_data_by_brpc()));
347
75.5k
    COUNTER_UPDATE(_parent->_bytes_sent_counter, compressed_bytes * num_receivers);
348
75.5k
    COUNTER_UPDATE(_parent->_uncompressed_bytes_counter, uncompressed_bytes * num_receivers);
349
75.5k
    COUNTER_UPDATE(_parent->_compress_timer, compress_time);
350
75.5k
#ifndef BE_TEST
351
75.5k
    _parent->state()->get_query_ctx()->resource_ctx()->io_context()->update_shuffle_send_bytes(
352
75.5k
            compressed_bytes * num_receivers);
353
75.5k
    _parent->state()->get_query_ctx()->resource_ctx()->io_context()->update_shuffle_send_rows(
354
75.5k
            src->rows() * num_receivers);
355
75.5k
#endif
356
357
75.5k
    return Status::OK();
358
75.5k
}
359
360
} // namespace doris