risingwave_batch/execution/
grpc_exchange.rs

1// Copyright 2025 RisingWave Labs
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15use std::fmt::{Debug, Formatter};
16
17use futures::StreamExt;
18use risingwave_common::array::DataChunk;
19use risingwave_expr::expr_context::capture_expr_context;
20use risingwave_pb::batch_plan::TaskOutputId;
21use risingwave_pb::batch_plan::exchange_source::LocalExecutePlan::{self, Plan};
22use risingwave_pb::task_service::{ExecuteRequest, GetDataResponse};
23use risingwave_rpc_client::ComputeClient;
24use risingwave_rpc_client::error::RpcError;
25use tonic::Streaming;
26
27use crate::error::Result;
28use crate::exchange_source::ExchangeSource;
29use crate::task::TaskId;
30
31/// Use grpc client as the source.
32pub struct GrpcExchangeSource {
33    stream: Streaming<GetDataResponse>,
34
35    task_output_id: TaskOutputId,
36}
37
38impl GrpcExchangeSource {
39    pub async fn create(
40        client: ComputeClient,
41        task_output_id: TaskOutputId,
42        local_execute_plan: Option<LocalExecutePlan>,
43    ) -> Result<Self> {
44        let task_id = task_output_id.get_task_id()?.clone();
45        let stream = match local_execute_plan {
46            // When in the local execution mode, `GrpcExchangeSource` would send out
47            // `ExecuteRequest` and get the data chunks back in a single RPC.
48            Some(local_execute_plan) => {
49                let plan = try_match_expand!(local_execute_plan, Plan)?;
50                let execute_request = ExecuteRequest {
51                    task_id: Some(task_id),
52                    plan: plan.plan,
53                    tracing_context: plan.tracing_context,
54                    expr_context: Some(capture_expr_context()?),
55                };
56                client.execute(execute_request).await?
57            }
58            None => client.get_data(task_output_id.clone()).await?,
59        };
60        let source = Self {
61            stream,
62            task_output_id,
63        };
64        Ok(source)
65    }
66}
67
68impl Debug for GrpcExchangeSource {
69    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
70        f.debug_struct("GrpcExchangeSource")
71            .field("task_output_id", &self.task_output_id)
72            .finish()
73    }
74}
75
76impl ExchangeSource for GrpcExchangeSource {
77    async fn take_data(&mut self) -> Result<Option<DataChunk>> {
78        let res = match self.stream.next().await {
79            None => {
80                return Ok(None);
81            }
82            Some(r) => r,
83        };
84        let task_data = res.map_err(RpcError::from_batch_status)?;
85        let data = DataChunk::from_protobuf(task_data.get_record_batch()?)?.compact_vis();
86        trace!(
87            "Receiver taskOutput = {:?}, data = {:?}",
88            self.task_output_id, data
89        );
90
91        Ok(Some(data))
92    }
93
94    fn get_task_id(&self) -> TaskId {
95        TaskId::from(self.task_output_id.get_task_id().unwrap())
96    }
97}
risingwave_batch/execution/grpc_exchange.rs

risingwave_batch/execution/
grpc_exchange.rs
