zhuqi-lucas commented on code in PR #16196: URL: https://github.com/apache/datafusion/pull/16196#discussion_r2128845907
########## datafusion/physical-plan/src/execution_plan.rs: ########## @@ -75,7 +75,19 @@ use futures::stream::{StreamExt, TryStreamExt}; /// [`execute`]: ExecutionPlan::execute /// [`required_input_distribution`]: ExecutionPlan::required_input_distribution /// [`required_input_ordering`]: ExecutionPlan::required_input_ordering -pub trait ExecutionPlan: Debug + DisplayAs + Send + Sync { +/// The core trait for a physical execution plan node. Every operator +/// implements this trait. We have extended it by adding two new methods +/// for “cooperative yielding” support: +/// +/// 1. `yields_cooperatively()` indicates whether this operator already +/// supports async/yield behavior internally (default: false). +/// +/// 2. `with_cooperative_yields(self: Arc<Self>)` returns an alternate +/// plan node that has built-in yielding; if not available, returns None. +/// +/// Because `with_cooperative_yields` moves `Arc<Self>` into `Arc<dyn ExecutionPlan>`, +/// we must ensure `Self: 'static`. Therefore, we add `+ 'static` here. Review Comment: Addressed in latest RP, thanks! ########## datafusion/physical-plan/src/memory.rs: ########## @@ -139,13 +140,18 @@ pub trait LazyBatchGenerator: Send + Sync + fmt::Debug + fmt::Display { /// /// This plan generates output batches lazily, it doesn't have to buffer all batches /// in memory up front (compared to `MemorySourceConfig`), thus consuming constant memory. +/// We now add a `cooperative` flag to +/// let it optionally yield back to the runtime periodically. +/// Default is `true`, meaning it will yield back to the runtime for cooperative scheduling. Review Comment: Addressed in latest RP, thanks! -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: github-unsubscr...@datafusion.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: github-unsubscr...@datafusion.apache.org For additional commands, e-mail: github-h...@datafusion.apache.org