You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@datafusion.apache.org by gi...@apache.org on 2026/07/27 16:40:51 UTC

(datafusion-ballista) branch asf-site updated: Publish built docs triggered by dc6b380979f85ab99f442b75e08f7499df0c6b65

This is an automated email from the ASF dual-hosted git repository.

github-actions[bot] pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/datafusion-ballista.git


The following commit(s) were added to refs/heads/asf-site by this push:
     new b06903501 Publish built docs triggered by dc6b380979f85ab99f442b75e08f7499df0c6b65
b06903501 is described below

commit b069035010900cf4b9d9d67c50e142ed2bd8ce8c
Author: github-actions[bot] <gi...@users.noreply.github.com>
AuthorDate: Mon Jul 27 16:40:45 2026 +0000

    Publish built docs triggered by dc6b380979f85ab99f442b75e08f7499df0c6b65
---
 _sources/upgrading/55.0.0.md.txt | 44 ++++++++++++++++++++++++++++++++++++++++
 searchindex.js                   |  2 +-
 upgrading/55.0.0.html            | 44 ++++++++++++++++++++++++++++++++++++++++
 3 files changed, 89 insertions(+), 1 deletion(-)

diff --git a/_sources/upgrading/55.0.0.md.txt b/_sources/upgrading/55.0.0.md.txt
index ccbabfe89..8c2432bd7 100644
--- a/_sources/upgrading/55.0.0.md.txt
+++ b/_sources/upgrading/55.0.0.md.txt
@@ -71,3 +71,47 @@ behavior. If you relied on it being `true` and want small joins to broadcast, se
 `HashJoinExec`, which remains eligible for broadcast promotion. Note this opts you
 into the non-spilling hash join for _all_ joins in the session, not only the small
 ones.
+
+### API changes
+
+#### `ballista_executor::as_task_status` signature reshaped
+
+`as_task_status` now takes a `TaskCompletionExtras` struct in place of the
+`operator_metrics: Option<Vec<OperatorMetricsSet>>` positional parameter. The
+struct also carries a new `runtime_stats: Vec<RuntimeStatsReport>` field used to
+transport `RuntimeStatsExec` reports back to the scheduler. It is marked
+`#[non_exhaustive]` with a `Default` impl, so future additions to the struct
+are non-breaking for callers that construct via `..Default::default()`.
+
+The parameter order also changed: `execution_times` now precedes the extras
+struct.
+
+**Action required:** external callers building a `TaskStatus` via
+`as_task_status` should migrate from:
+
+```rust
+as_task_status(
+    execution_result,
+    executor_id,
+    stage_attempt_num,
+    key,
+    operator_metrics,
+    execution_times,
+)
+```
+
+to:
+
+```rust
+as_task_status(
+    execution_result,
+    executor_id,
+    stage_attempt_num,
+    key,
+    execution_times,
+    TaskCompletionExtras {
+        operator_metrics,
+        ..Default::default()
+    },
+)
+```
diff --git a/searchindex.js b/searchindex.js
index 482c3e251..f78afe3c8 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"AQE join behavior (opt-in)":[[28,"aqe-join-behavior-opt-in"]],"Adaptive Query Execution (AQE)":[[22,"adaptive-query-execution-aqe"]],"Adaptive Query Execution (Experimental)":[[51,"adaptive-query-execution-experimental"]],"Adding a persona":[[26,"adding-a-persona"]],"Aggregate Functions":[[50,"aggregate-functions"]],"Apache DataFusion Ballista":[[27,null]],"Apache DataFusion Ballista 0.10.0 Changelog":[[0,null]],"Apache DataFusion Ballista 0.11.0 Changelog" [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"API changes":[[29,"api-changes"]],"AQE join behavior (opt-in)":[[28,"aqe-join-behavior-opt-in"]],"Adaptive Query Execution (AQE)":[[22,"adaptive-query-execution-aqe"]],"Adaptive Query Execution (Experimental)":[[51,"adaptive-query-execution-experimental"]],"Adding a persona":[[26,"adding-a-persona"]],"Aggregate Functions":[[50,"aggregate-functions"]],"Apache DataFusion Ballista":[[27,null]],"Apache DataFusion Ballista 0.10.0 Changelog":[[0,null]],"Apache Da [...]
\ No newline at end of file
diff --git a/upgrading/55.0.0.html b/upgrading/55.0.0.html
index 17c95267e..f936339f7 100644
--- a/upgrading/55.0.0.html
+++ b/upgrading/55.0.0.html
@@ -441,6 +441,46 @@ into the non-spilling hash join for <em>all</em> joins in the session, not only
 ones.</p>
 </section>
 </section>
+<section id="api-changes">
+<h3>API changes<a class="headerlink" href="#api-changes" title="Link to this heading">#</a></h3>
+<section id="ballista-executor-as-task-status-signature-reshaped">
+<h4><code class="docutils literal notranslate"><span class="pre">ballista_executor::as_task_status</span></code> signature reshaped<a class="headerlink" href="#ballista-executor-as-task-status-signature-reshaped" title="Link to this heading">#</a></h4>
+<p><code class="docutils literal notranslate"><span class="pre">as_task_status</span></code> now takes a <code class="docutils literal notranslate"><span class="pre">TaskCompletionExtras</span></code> struct in place of the
+<code class="docutils literal notranslate"><span class="pre">operator_metrics:</span> <span class="pre">Option&lt;Vec&lt;OperatorMetricsSet&gt;&gt;</span></code> positional parameter. The
+struct also carries a new <code class="docutils literal notranslate"><span class="pre">runtime_stats:</span> <span class="pre">Vec&lt;RuntimeStatsReport&gt;</span></code> field used to
+transport <code class="docutils literal notranslate"><span class="pre">RuntimeStatsExec</span></code> reports back to the scheduler. It is marked
+<code class="docutils literal notranslate"><span class="pre">#[non_exhaustive]</span></code> with a <code class="docutils literal notranslate"><span class="pre">Default</span></code> impl, so future additions to the struct
+are non-breaking for callers that construct via <code class="docutils literal notranslate"><span class="pre">..Default::default()</span></code>.</p>
+<p>The parameter order also changed: <code class="docutils literal notranslate"><span class="pre">execution_times</span></code> now precedes the extras
+struct.</p>
+<p><strong>Action required:</strong> external callers building a <code class="docutils literal notranslate"><span class="pre">TaskStatus</span></code> via
+<code class="docutils literal notranslate"><span class="pre">as_task_status</span></code> should migrate from:</p>
+<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="n">as_task_status</span><span class="p">(</span>
+<span class="w">    </span><span class="n">execution_result</span><span class="p">,</span>
+<span class="w">    </span><span class="n">executor_id</span><span class="p">,</span>
+<span class="w">    </span><span class="n">stage_attempt_num</span><span class="p">,</span>
+<span class="w">    </span><span class="n">key</span><span class="p">,</span>
+<span class="w">    </span><span class="n">operator_metrics</span><span class="p">,</span>
+<span class="w">    </span><span class="n">execution_times</span><span class="p">,</span>
+<span class="p">)</span>
+</pre></div>
+</div>
+<p>to:</p>
+<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="n">as_task_status</span><span class="p">(</span>
+<span class="w">    </span><span class="n">execution_result</span><span class="p">,</span>
+<span class="w">    </span><span class="n">executor_id</span><span class="p">,</span>
+<span class="w">    </span><span class="n">stage_attempt_num</span><span class="p">,</span>
+<span class="w">    </span><span class="n">key</span><span class="p">,</span>
+<span class="w">    </span><span class="n">execution_times</span><span class="p">,</span>
+<span class="w">    </span><span class="n">TaskCompletionExtras</span><span class="w"> </span><span class="p">{</span>
+<span class="w">        </span><span class="n">operator_metrics</span><span class="p">,</span>
+<span class="w">        </span><span class="o">..</span><span class="nb">Default</span><span class="p">::</span><span class="n">default</span><span class="p">()</span>
+<span class="w">    </span><span class="p">},</span>
+<span class="p">)</span>
+</pre></div>
+</div>
+</section>
+</section>
 </section>
 </section>
 
@@ -496,6 +536,10 @@ ones.</p>
 <li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#sortmergejoinexec-is-no-longer-converted-to-a-broadcast-join"><code class="docutils literal notranslate"><span class="pre">SortMergeJoinExec</span></code> is no longer converted to a broadcast join</a></li>
 </ul>
 </li>
+<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#api-changes">API changes</a><ul class="nav section-nav flex-column">
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ballista-executor-as-task-status-signature-reshaped"><code class="docutils literal notranslate"><span class="pre">ballista_executor::as_task_status</span></code> signature reshaped</a></li>
+</ul>
+</li>
 </ul>
 </li>
 </ul>


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@datafusion.apache.org
For additional commands, e-mail: commits-help@datafusion.apache.org