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/08/11 20:00:02 UTC
(datafusion) branch asf-site updated: Publish built docs triggered by 041a71671c7a505a2e3ed58689a20137c8f3d172
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.git
The following commit(s) were added to refs/heads/asf-site by this push:
new e77d17d4c4 Publish built docs triggered by 041a71671c7a505a2e3ed58689a20137c8f3d172
e77d17d4c4 is described below
commit e77d17d4c4e489d56d8e9bb4f710764786920c4c
Author: github-actions[bot] <gi...@users.noreply.github.com>
AuthorDate: Tue Aug 11 19:59:58 2026 +0000
Publish built docs triggered by 041a71671c7a505a2e3ed58689a20137c8f3d172
---
.../library-user-guide/upgrading/55.0.0.md.txt | 26 ++++++++++++++++++++++
library-user-guide/upgrading/55.0.0.html | 23 +++++++++++++++++++
searchindex.js | 2 +-
3 files changed, 50 insertions(+), 1 deletion(-)
diff --git a/_sources/library-user-guide/upgrading/55.0.0.md.txt b/_sources/library-user-guide/upgrading/55.0.0.md.txt
index 73eb3dfd86..7d0c19c846 100644
--- a/_sources/library-user-guide/upgrading/55.0.0.md.txt
+++ b/_sources/library-user-guide/upgrading/55.0.0.md.txt
@@ -1193,3 +1193,29 @@ See [PR #24030](https://github.com/apache/datafusion/pull/24030) for details.
[`bufwriter`]: https://docs.rs/tokio/latest/tokio/io/struct.BufWriter.html
[`asyncarrowwriter`]: https://docs.rs/parquet/59.1.0/parquet/arrow/async_writer/struct.AsyncArrowWriter.html
[`parquet/examples/object_store.rs`]: https://github.com/apache/arrow-rs/blob/main/parquet/examples/object_store.rs
+
+### `datafusion-proto`: parquet options conversions are fallible
+
+`protobuf::ParquetOptions` and `protobuf::TableParquetOptions` validate
+`writer_version` when converting into their `datafusion-common` counterparts, so
+those conversions are `TryFrom` rather than `From`.
+
+Every other `From` / `TryFrom` conversion between DataFusion types and
+`datafusion_proto::protobuf` messages is unchanged. Several impls moved to the
+crate that owns their DataFusion type, but trait impls are global, so
+`X::try_from(&proto)` and `proto.try_into()` still resolve with no import
+changes.
+
+**Migration guide:**
+
+```rust,ignore
+// Before
+let opts = ParquetOptions::from(&proto_opts);
+let table_opts = TableParquetOptions::from(&proto_table_opts);
+
+// After
+let opts = ParquetOptions::try_from(&proto_opts)?;
+let table_opts = TableParquetOptions::try_from(&proto_table_opts)?;
+```
+
+See [issue #24019](https://github.com/apache/datafusion/issues/24019) for details.
diff --git a/library-user-guide/upgrading/55.0.0.html b/library-user-guide/upgrading/55.0.0.html
index 87fac35502..6caacfbcc2 100644
--- a/library-user-guide/upgrading/55.0.0.html
+++ b/library-user-guide/upgrading/55.0.0.html
@@ -1479,6 +1479,28 @@ runtime), implement <code class="docutils literal notranslate"><span class="pre"
following the pattern in <a class="reference external" href="https://github.com/apache/arrow-rs/blob/main/parquet/examples/object_store.rs"><code class="docutils literal notranslate"><span class="pre">parquet/examples/object_store.rs</span></code></a></p>
<p>See <a class="reference external" href="https://github.com/apache/datafusion/pull/24030">PR #24030</a> for details.</p>
</section>
+<section id="datafusion-proto-parquet-options-conversions-are-fallible">
+<h3><code class="docutils literal notranslate"><span class="pre">datafusion-proto</span></code>: parquet options conversions are fallible<a class="headerlink" href="#datafusion-proto-parquet-options-conversions-are-fallible" title="Link to this heading">#</a></h3>
+<p><code class="docutils literal notranslate"><span class="pre">protobuf::ParquetOptions</span></code> and <code class="docutils literal notranslate"><span class="pre">protobuf::TableParquetOptions</span></code> validate
+<code class="docutils literal notranslate"><span class="pre">writer_version</span></code> when converting into their <code class="docutils literal notranslate"><span class="pre">datafusion-common</span></code> counterparts, so
+those conversions are <code class="docutils literal notranslate"><span class="pre">TryFrom</span></code> rather than <code class="docutils literal notranslate"><span class="pre">From</span></code>.</p>
+<p>Every other <code class="docutils literal notranslate"><span class="pre">From</span></code> / <code class="docutils literal notranslate"><span class="pre">TryFrom</span></code> conversion between DataFusion types and
+<code class="docutils literal notranslate"><span class="pre">datafusion_proto::protobuf</span></code> messages is unchanged. Several impls moved to the
+crate that owns their DataFusion type, but trait impls are global, so
+<code class="docutils literal notranslate"><span class="pre">X::try_from(&proto)</span></code> and <code class="docutils literal notranslate"><span class="pre">proto.try_into()</span></code> still resolve with no import
+changes.</p>
+<p><strong>Migration guide:</strong></p>
+<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="c1">// Before</span>
+<span class="kd">let</span><span class="w"> </span><span class="n">opts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ParquetOptions</span><span class="p">::</span><span class="n">from</span><span class="p">(</span><span class="o">&</span><span class="n">proto_opts</span><span class="p">);</span>
+<span class="kd">let</span><span class="w"> </span><span class="n">table_opts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">TableParquetOptions</span><span class="p">::</span><span class="n">from</span><span class="p">(</span><span class="o">&</span><span class="n">proto_table_opts</span><span class="p">);</span>
+
+<span class="c1">// After</span>
+<span class="kd">let</span><span class="w"> </span><span class="n">opts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ParquetOptions</span><span class="p">::</span><span class="n">try_from</span><span class="p">(</span><span class="o">&</span><span class="n">proto_opts</span><span class="p">)</span><span class="o">?</span><span class="p">;</span>
+<span class="kd">let</span><span class="w"> </span><span class="n">table_opts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">TableParquetOptions</span><span class="p">::</span><span class="n">try_from</span><span class="p">(</span><span class="o">&</span><span class="n">proto_table_opts</span><span class="p">)</span><span class="o">?</span><span class="p">;</span>
+</pre></div>
+</div>
+<p>See <a class="reference external" href="https://github.com/apache/datafusion/issues/24019">issue #24019</a> for details.</p>
+</section>
</section>
</section>
@@ -1564,6 +1586,7 @@ following the pattern in <a class="reference external" href="https://github.com/
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#cachedparquetfilereader-removed-parquetfilereader-fields-are-now-private"><code class="docutils literal notranslate"><span class="pre">CachedParquetFileReader</span></code> removed; <code class="docutils literal notranslate"><span class="pre">ParquetFileReader</span></code> fields are now private</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#array-distance-scalar-function-now-rejects-multidimensional-arrays"><code class="docutils literal notranslate"><span class="pre">array_distance</span></code> scalar function now rejects multidimensional arrays</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#parquetobjectreader-parquetobjectwriter-deprecated-upstream"><code class="docutils literal notranslate"><span class="pre">ParquetObjectReader</span></code> / <code class="docutils literal notranslate"><span class="pre">ParquetObjectWriter</span></code> deprecated upstream</a></li>
+<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#datafusion-proto-parquet-options-conversions-are-fallible"><code class="docutils literal notranslate"><span class="pre">datafusion-proto</span></code>: parquet options conversions are fallible</a></li>
</ul>
</li>
</ul>
diff --git a/searchindex.js b/searchindex.js
index 834b995c63..64f88470b7 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[76,"op-neq"]],"!~":[[76,"op-re-not-match"]],"!~*":[[76,"op-re-not-match-i"]],"!~~":[[76,"id19"]],"!~~*":[[76,"id20"]],"#":[[76,"op-bit-xor"]],"%":[[76,"op-modulo"]],"&":[[76,"op-bit-and"]],"(relation, name) tuples in logical fields and logical columns are unique":[[16,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[76,"op-multiply"]],"+":[[76,"op-plus"]],"-":[[76,"op-minus"]],"/":[[76,"op-divide"]],"1. Array Literal Con [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[76,"op-neq"]],"!~":[[76,"op-re-not-match"]],"!~*":[[76,"op-re-not-match-i"]],"!~~":[[76,"id19"]],"!~~*":[[76,"id20"]],"#":[[76,"op-bit-xor"]],"%":[[76,"op-modulo"]],"&":[[76,"op-bit-and"]],"(relation, name) tuples in logical fields and logical columns are unique":[[16,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[76,"op-multiply"]],"+":[[76,"op-plus"]],"-":[[76,"op-minus"]],"/":[[76,"op-divide"]],"1. Array Literal Con [...]
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@datafusion.apache.org
For additional commands, e-mail: commits-help@datafusion.apache.org