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

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


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

commit 9b7548771174a0b50a9f7f8966829569f8df0081
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Fri Sep 26 20:37:53 2025 +0000

    Publish built docs triggered by 22309f92f4874bff71c1c9f626e2909aa0279c5e
---
 _sources/library-user-guide/upgrading.md.txt | 38 ++++++++++++++++++++-
 library-user-guide/upgrading.html            | 51 +++++++++++++++++++++++++++-
 searchindex.js                               |  2 +-
 3 files changed, 88 insertions(+), 3 deletions(-)

diff --git a/_sources/library-user-guide/upgrading.md.txt 
b/_sources/library-user-guide/upgrading.md.txt
index 55827a780b..8530dd372f 100644
--- a/_sources/library-user-guide/upgrading.md.txt
+++ b/_sources/library-user-guide/upgrading.md.txt
@@ -23,7 +23,7 @@
 
 **Note:** DataFusion `51.0.0` has not been released yet. The information 
provided in this section pertains to features and changes that have already 
been merged to the main branch and are awaiting release in this version.
 
-You can see the current [status of the `51.0.0 `release 
here](https://github.com/apache/datafusion/issues/17558)
+You can see the current [status of the `51.0.0`release 
here](https://github.com/apache/datafusion/issues/17558)
 
 ### `MSRV` updated to 1.87.0
 
@@ -31,6 +31,42 @@ The Minimum Supported Rust Version (MSRV) has been updated 
to [`1.87.0`].
 
 [`1.87.0`]: https://releases.rs/docs/1.87.0/
 
+### `datafusion-proto` use `TaskContext` rather than `SessionContext` in 
physical plan serde methods
+
+There have been changes in the public API methods of `datafusion-proto` which 
handle physical plan serde.
+
+Methods like `physical_plan_from_bytes`, `parse_physical_expr` and similar, 
expect `TaskContext` instead of `SessionContext`
+
+```diff
+- let plan2 = physical_plan_from_bytes(&bytes, &ctx)?;
++ let plan2 = physical_plan_from_bytes(&bytes, &ctx.task_ctx())?;
+```
+
+as `TaskContext` contains `RuntimeEnv` methods such as 
`try_into_physical_plan` will not have explicit `RuntimeEnv` parameter.
+
+```diff
+let result_exec_plan: Arc<dyn ExecutionPlan> = proto
+-   .try_into_physical_plan(&ctx, runtime.deref(), &composed_codec)
++.  .try_into_physical_plan(&ctx.task_ctx(), &composed_codec)
+```
+
+`PhysicalExtensionCodec::try_decode()` expects `TaskContext` instead of 
`FunctionRegistry`:
+
+```diff
+pub trait PhysicalExtensionCodec {
+    fn try_decode(
+        &self,
+        buf: &[u8],
+        inputs: &[Arc<dyn ExecutionPlan>],
+-        registry: &dyn FunctionRegistry,
++        ctx: &TaskContext,
+    ) -> Result<Arc<dyn ExecutionPlan>>;
+```
+
+See [issue #17601] for more details.
+
+[issue #17601]: https://github.com/apache/datafusion/issues/17601
+
 ## DataFusion `50.0.0`
 
 ### ListingTable automatically detects Hive Partitioned tables
diff --git a/library-user-guide/upgrading.html 
b/library-user-guide/upgrading.html
index 7d4abd4012..cced31efca 100644
--- a/library-user-guide/upgrading.html
+++ b/library-user-guide/upgrading.html
@@ -581,6 +581,28 @@
      updated to 1.87.0
     </a>
    </li>
+   <li class="toc-h3 nav-item toc-entry">
+    <a class="reference internal nav-link" 
href="#datafusion-proto-use-taskcontext-rather-than-sessioncontext-in-physical-plan-serde-methods">
+     <code class="docutils literal notranslate">
+      <span class="pre">
+       datafusion-proto
+      </span>
+     </code>
+     use
+     <code class="docutils literal notranslate">
+      <span class="pre">
+       TaskContext
+      </span>
+     </code>
+     rather than
+     <code class="docutils literal notranslate">
+      <span class="pre">
+       SessionContext
+      </span>
+     </code>
+     in physical plan serde methods
+    </a>
+   </li>
   </ul>
  </li>
  <li class="toc-h2 nav-item toc-entry">
@@ -1337,11 +1359,38 @@
 <section id="datafusion-51-0-0">
 <h2>DataFusion <code class="docutils literal notranslate"><span 
class="pre">51.0.0</span></code><a class="headerlink" href="#datafusion-51-0-0" 
title="Link to this heading">¶</a></h2>
 <p><strong>Note:</strong> DataFusion <code class="docutils literal 
notranslate"><span class="pre">51.0.0</span></code> has not been released yet. 
The information provided in this section pertains to features and changes that 
have already been merged to the main branch and are awaiting release in this 
version.</p>
-<p>You can see the current <a class="reference external" 
href="https://github.com/apache/datafusion/issues/17558";>status of the <code 
class="docutils literal notranslate"><span class="pre">51.0.0</span> 
</code>release here</a></p>
+<p>You can see the current <a class="reference external" 
href="https://github.com/apache/datafusion/issues/17558";>status of the <code 
class="docutils literal notranslate"><span 
class="pre">51.0.0</span></code>release here</a></p>
 <section id="msrv-updated-to-1-87-0">
 <h3><code class="docutils literal notranslate"><span 
class="pre">MSRV</span></code> updated to 1.87.0<a class="headerlink" 
href="#msrv-updated-to-1-87-0" title="Link to this heading">¶</a></h3>
 <p>The Minimum Supported Rust Version (MSRV) has been updated to <a 
class="reference external" href="https://releases.rs/docs/1.87.0/";><code 
class="docutils literal notranslate"><span 
class="pre">1.87.0</span></code></a>.</p>
 </section>
+<section 
id="datafusion-proto-use-taskcontext-rather-than-sessioncontext-in-physical-plan-serde-methods">
+<h3><code class="docutils literal notranslate"><span 
class="pre">datafusion-proto</span></code> use <code class="docutils literal 
notranslate"><span class="pre">TaskContext</span></code> rather than <code 
class="docutils literal notranslate"><span 
class="pre">SessionContext</span></code> in physical plan serde methods<a 
class="headerlink" 
href="#datafusion-proto-use-taskcontext-rather-than-sessioncontext-in-physical-plan-serde-methods"
 title="Link to this heading">¶</a></h3>
+<p>There have been changes in the public API methods of <code class="docutils 
literal notranslate"><span class="pre">datafusion-proto</span></code> which 
handle physical plan serde.</p>
+<p>Methods like <code class="docutils literal notranslate"><span 
class="pre">physical_plan_from_bytes</span></code>, <code class="docutils 
literal notranslate"><span class="pre">parse_physical_expr</span></code> and 
similar, expect <code class="docutils literal notranslate"><span 
class="pre">TaskContext</span></code> instead of <code class="docutils literal 
notranslate"><span class="pre">SessionContext</span></code></p>
+<div class="highlight-diff notranslate"><div 
class="highlight"><pre><span></span><span class="gd">- let plan2 = 
physical_plan_from_bytes(&amp;bytes, &amp;ctx)?;</span>
+<span class="gi">+ let plan2 = physical_plan_from_bytes(&amp;bytes, 
&amp;ctx.task_ctx())?;</span>
+</pre></div>
+</div>
+<p>as <code class="docutils literal notranslate"><span 
class="pre">TaskContext</span></code> contains <code class="docutils literal 
notranslate"><span class="pre">RuntimeEnv</span></code> methods such as <code 
class="docutils literal notranslate"><span 
class="pre">try_into_physical_plan</span></code> will not have explicit <code 
class="docutils literal notranslate"><span class="pre">RuntimeEnv</span></code> 
parameter.</p>
+<div class="highlight-diff notranslate"><div 
class="highlight"><pre><span></span>let result_exec_plan: Arc&lt;dyn 
ExecutionPlan&gt; = proto
+<span class="gd">-   .try_into_physical_plan(&amp;ctx, runtime.deref(), 
&amp;composed_codec)</span>
+<span class="gi">+.  .try_into_physical_plan(&amp;ctx.task_ctx(), 
&amp;composed_codec)</span>
+</pre></div>
+</div>
+<p><code class="docutils literal notranslate"><span 
class="pre">PhysicalExtensionCodec::try_decode()</span></code> expects <code 
class="docutils literal notranslate"><span 
class="pre">TaskContext</span></code> instead of <code class="docutils literal 
notranslate"><span class="pre">FunctionRegistry</span></code>:</p>
+<div class="highlight-diff notranslate"><div 
class="highlight"><pre><span></span>pub trait PhysicalExtensionCodec {
+<span class="w"> </span>   fn try_decode(
+<span class="w"> </span>       &amp;self,
+<span class="w"> </span>       buf: &amp;[u8],
+<span class="w"> </span>       inputs: &amp;[Arc&lt;dyn ExecutionPlan&gt;],
+<span class="gd">-        registry: &amp;dyn FunctionRegistry,</span>
+<span class="gi">+        ctx: &amp;TaskContext,</span>
+<span class="w"> </span>   ) -&gt; Result&lt;Arc&lt;dyn ExecutionPlan&gt;&gt;;
+</pre></div>
+</div>
+<p>See <a class="reference external" 
href="https://github.com/apache/datafusion/issues/17601";>issue #17601</a> for 
more details.</p>
+</section>
 </section>
 <section id="datafusion-50-0-0">
 <h2>DataFusion <code class="docutils literal notranslate"><span 
class="pre">50.0.0</span></code><a class="headerlink" href="#datafusion-50-0-0" 
title="Link to this heading">¶</a></h2>
diff --git a/searchindex.js b/searchindex.js
index 8e6f13ba69..126fa1d374 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[58,"op-neq"]],"!~":[[58,"op-re-not-match"]],"!~*":[[58,"op-re-not-match-i"]],"!~~":[[58,"id19"]],"!~~*":[[58,"id20"]],"#":[[58,"op-bit-xor"]],"%":[[58,"op-modulo"]],"&":[[58,"op-bit-and"]],"(relation,
 name) tuples in logical fields and logical columns are 
unique":[[13,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[58,"op-multiply"]],"+":[[58,"op-plus"]],"-":[[58,"op-minus"]],"/":[[58,"op-divide"]],"<":[[58,"op-lt"]],"<
 [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[58,"op-neq"]],"!~":[[58,"op-re-not-match"]],"!~*":[[58,"op-re-not-match-i"]],"!~~":[[58,"id19"]],"!~~*":[[58,"id20"]],"#":[[58,"op-bit-xor"]],"%":[[58,"op-modulo"]],"&":[[58,"op-bit-and"]],"(relation,
 name) tuples in logical fields and logical columns are 
unique":[[13,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[58,"op-multiply"]],"+":[[58,"op-plus"]],"-":[[58,"op-minus"]],"/":[[58,"op-divide"]],"<":[[58,"op-lt"]],"<
 [...]
\ No newline at end of file


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to