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 5d9491a09c Publish built docs triggered by 3d5863b05950da382df7e070f457d8166618d270 5d9491a09c is described below commit 5d9491a09ca20008ad43425ff407bf38499fda33 Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com> AuthorDate: Thu Sep 4 18:23:45 2025 +0000 Publish built docs triggered by 3d5863b05950da382df7e070f457d8166618d270 --- _sources/library-user-guide/upgrading.md.txt | 22 +++++++++++++++++ library-user-guide/upgrading.html | 36 ++++++++++++++++++++++++++++ searchindex.js | 2 +- 3 files changed, 59 insertions(+), 1 deletion(-) diff --git a/_sources/library-user-guide/upgrading.md.txt b/_sources/library-user-guide/upgrading.md.txt index 5637228d9c..e27408e48c 100644 --- a/_sources/library-user-guide/upgrading.md.txt +++ b/_sources/library-user-guide/upgrading.md.txt @@ -253,6 +253,28 @@ Reimplementation for any custom `DataSource` should be relatively straightforwar [#17395]: https://github.com/apache/datafusion/pull/17395/ +### `FileOpenFuture` now uses `DataFusionError` instead of `ArrowError` + +The `FileOpenFuture` type alias has been updated to use `DataFusionError` instead of `ArrowError` for its error type. This change affects the `FileOpener` trait and any implementations that work with file streaming operations. + +**Before:** + +```rust +,ignore +pub type FileOpenFuture = BoxFuture<'static, Result<BoxStream<'static, Result<RecordBatch, ArrowError>>>>; +``` + +**After:** + +```rust +,ignore +pub type FileOpenFuture = BoxFuture<'static, Result<BoxStream<'static, Result<RecordBatch>>>>; +``` + +If you have custom implementations of `FileOpener` or work directly with `FileOpenFuture`, you'll need to update your error handling to use `DataFusionError` instead of `ArrowError`. The `FileStreamState` enum's `Open` variant has also been updated accordingly. See [#17397] for more details. + +[#17397]: https://github.com/apache/datafusion/pull/17397 + ## DataFusion `49.0.0` ### `MSRV` updated to 1.85.1 diff --git a/library-user-guide/upgrading.html b/library-user-guide/upgrading.html index 702fd6c39b..8f24327a9f 100644 --- a/library-user-guide/upgrading.html +++ b/library-user-guide/upgrading.html @@ -739,6 +739,27 @@ </code> </a> </li> + <li class="toc-h3 nav-item toc-entry"> + <a class="reference internal nav-link" href="#fileopenfuture-now-uses-datafusionerror-instead-of-arrowerror"> + <code class="docutils literal notranslate"> + <span class="pre"> + FileOpenFuture + </span> + </code> + now uses + <code class="docutils literal notranslate"> + <span class="pre"> + DataFusionError + </span> + </code> + instead of + <code class="docutils literal notranslate"> + <span class="pre"> + ArrowError + </span> + </code> + </a> + </li> </ul> </li> <li class="toc-h2 nav-item toc-entry"> @@ -1450,6 +1471,21 @@ See <a class="reference external" href="https://github.com/apache/datafusion/pul <p>We refactored <code class="docutils literal notranslate"><span class="pre">DataSource::try_swapping_with_projection</span></code> to simplify the method and minimize leakage across the ExecutionPlan <-> DataSource abstraction layer. Reimplementation for any custom <code class="docutils literal notranslate"><span class="pre">DataSource</span></code> should be relatively straightforward, see <a class="reference external" href="https://github.com/apache/datafusion/pull/17395/">#17395</a> for more details.</p> </section> +<section id="fileopenfuture-now-uses-datafusionerror-instead-of-arrowerror"> +<h3><code class="docutils literal notranslate"><span class="pre">FileOpenFuture</span></code> now uses <code class="docutils literal notranslate"><span class="pre">DataFusionError</span></code> instead of <code class="docutils literal notranslate"><span class="pre">ArrowError</span></code><a class="headerlink" href="#fileopenfuture-now-uses-datafusionerror-instead-of-arrowerror" title="Link to this heading">¶</a></h3> +<p>The <code class="docutils literal notranslate"><span class="pre">FileOpenFuture</span></code> type alias has been updated to use <code class="docutils literal notranslate"><span class="pre">DataFusionError</span></code> instead of <code class="docutils literal notranslate"><span class="pre">ArrowError</span></code> for its error type. This change affects the <code class="docutils literal notranslate"><span class="pre">FileOpener</span></code> trait and any implementations that work wi [...] +<p><strong>Before:</strong></p> +<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="p">,</span><span class="n">ignore</span> +<span class="k">pub</span><span class="w"> </span><span class="k">type</span><span class="w"> </span><span class="nc">FileOpenFuture</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">BoxFuture</span><span class="o"><'</span><span class="nb">static</span><span class="p">,</span><span class="w"> </span><span class="nb">Result</span><span class="o"><</span><span class="n">BoxStream</span><span class="o"><'</span><span class="nb">s [...] +</pre></div> +</div> +<p><strong>After:</strong></p> +<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="p">,</span><span class="n">ignore</span> +<span class="k">pub</span><span class="w"> </span><span class="k">type</span><span class="w"> </span><span class="nc">FileOpenFuture</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">BoxFuture</span><span class="o"><'</span><span class="nb">static</span><span class="p">,</span><span class="w"> </span><span class="nb">Result</span><span class="o"><</span><span class="n">BoxStream</span><span class="o"><'</span><span class="nb">s [...] +</pre></div> +</div> +<p>If you have custom implementations of <code class="docutils literal notranslate"><span class="pre">FileOpener</span></code> or work directly with <code class="docutils literal notranslate"><span class="pre">FileOpenFuture</span></code>, you’ll need to update your error handling to use <code class="docutils literal notranslate"><span class="pre">DataFusionError</span></code> instead of <code class="docutils literal notranslate"><span class="pre">ArrowError</span></code>. The <code clas [...] +</section> </section> <section id="datafusion-49-0-0"> <h2>DataFusion <code class="docutils literal notranslate"><span class="pre">49.0.0</span></code><a class="headerlink" href="#datafusion-49-0-0" title="Link to this heading">¶</a></h2> diff --git a/searchindex.js b/searchindex.js index f1a74edf48..872598c3e0 100644 --- a/searchindex.js +++ b/searchindex.js @@ -1 +1 @@ -Search.setIndex({"alltitles":{"!=":[[57,"op-neq"]],"!~":[[57,"op-re-not-match"]],"!~*":[[57,"op-re-not-match-i"]],"!~~":[[57,"id19"]],"!~~*":[[57,"id20"]],"#":[[57,"op-bit-xor"]],"%":[[57,"op-modulo"]],"&":[[57,"op-bit-and"]],"(relation, name) tuples in logical fields and logical columns are unique":[[12,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[57,"op-multiply"]],"+":[[57,"op-plus"]],"-":[[57,"op-minus"]],"/":[[57,"op-divide"]],"<":[[57,"op-lt"]],"< [...] \ No newline at end of file +Search.setIndex({"alltitles":{"!=":[[57,"op-neq"]],"!~":[[57,"op-re-not-match"]],"!~*":[[57,"op-re-not-match-i"]],"!~~":[[57,"id19"]],"!~~*":[[57,"id20"]],"#":[[57,"op-bit-xor"]],"%":[[57,"op-modulo"]],"&":[[57,"op-bit-and"]],"(relation, name) tuples in logical fields and logical columns are unique":[[12,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[57,"op-multiply"]],"+":[[57,"op-plus"]],"-":[[57,"op-minus"]],"/":[[57,"op-divide"]],"<":[[57,"op-lt"]],"< [...] \ No newline at end of file --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@datafusion.apache.org For additional commands, e-mail: commits-h...@datafusion.apache.org