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/05/01 11:55:15 UTC
(datafusion) branch asf-site updated: Publish built docs triggered by bb8636453a673b459595cb5b22216db24f5b4a51
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 1a9189ba80 Publish built docs triggered by bb8636453a673b459595cb5b22216db24f5b4a51
1a9189ba80 is described below
commit 1a9189ba80f98e79e7daa267b2242fca68c62e7e
Author: github-actions[bot] <gi...@users.noreply.github.com>
AuthorDate: Fri May 1 11:55:10 2026 +0000
Publish built docs triggered by bb8636453a673b459595cb5b22216db24f5b4a51
---
.../library-user-guide/upgrading/54.0.0.md.txt | 37 ++++++++++++++++++++++
library-user-guide/upgrading/54.0.0.html | 29 +++++++++++++++++
searchindex.js | 2 +-
3 files changed, 67 insertions(+), 1 deletion(-)
diff --git a/_sources/library-user-guide/upgrading/54.0.0.md.txt b/_sources/library-user-guide/upgrading/54.0.0.md.txt
index 854dee0724..34d1f7c61e 100644
--- a/_sources/library-user-guide/upgrading/54.0.0.md.txt
+++ b/_sources/library-user-guide/upgrading/54.0.0.md.txt
@@ -410,6 +410,43 @@ caller-computed `NullBuffer`.
[#17861]: https://github.com/apache/datafusion/pull/17861
+### Conversion from `FileDecryptionProperties` to `ConfigFileDecryptionProperties` is now fallible
+
+Previously, `datafusion_common::config::ConfigFileDecryptionProperties`
+implemented `From<&Arc<parquet::encryption::decrypt::FileDecryptionProperties>>`.
+If an error was encountered when retrieving the footer key without providing key metadata,
+the error would be ignored and an empty footer key set in the result.
+This could lead to obscure errors later.
+
+`ConfigFileDecryptionProperties` now instead implements `TryFrom<&Arc<FileDecryptionProperties>>`,
+and errors retrieving the footer key will be propagated up.
+
+**Migration guide:**
+
+Replace calls to `ConfigFileDecryptionProperties::from` with `ConfigFileDecryptionProperties::try_from`,
+and affected calls to `into` with `try_into`, with appropriate error handling added.
+
+**Before:**
+
+```rust,ignore
+let config_decryption_properties: ConfigFileDecryptionProperties = (&decryption_properties).into();
+// or
+let config_decryption_properties = ConfigFileDecryptionProperties::from(&decryption_properties);
+```
+
+(where `decryption_properties` is an `Arc<FileDecryptionProperties>`)
+
+**After:**
+
+```rust,ignore
+let config_decryption_properties: ConfigFileDecryptionProperties = (&decryption_properties).try_into()?;
+// or
+let config_decryption_properties = ConfigFileDecryptionProperties::try_from(&decryption_properties)?;
+```
+
+See [#21602](https://github.com/apache/datafusion/issues/21602) and
+[PR #21603](https://github.com/apache/datafusion/pull/21603) for details.
+
### `approx_percentile_cont`, `approx_percentile_cont_with_weight`, `approx_median` now coerce to floats
The type signatures of `approx_percentile_cont`, `approx_percentile_cont_with_weight`, and
diff --git a/library-user-guide/upgrading/54.0.0.html b/library-user-guide/upgrading/54.0.0.html
index 7dbaa2dba4..4485e2c877 100644
--- a/library-user-guide/upgrading/54.0.0.html
+++ b/library-user-guide/upgrading/54.0.0.html
@@ -820,6 +820,34 @@ were only ever used to implement <code class="docutils literal notranslate"><spa
you were importing them externally, use Arrow’s corresponding builders with a
caller-computed <code class="docutils literal notranslate"><span class="pre">NullBuffer</span></code>.</p>
</section>
+<section id="conversion-from-filedecryptionproperties-to-configfiledecryptionproperties-is-now-fallible">
+<h3>Conversion from <code class="docutils literal notranslate"><span class="pre">FileDecryptionProperties</span></code> to <code class="docutils literal notranslate"><span class="pre">ConfigFileDecryptionProperties</span></code> is now fallible<a class="headerlink" href="#conversion-from-filedecryptionproperties-to-configfiledecryptionproperties-is-now-fallible" title="Link to this heading">#</a></h3>
+<p>Previously, <code class="docutils literal notranslate"><span class="pre">datafusion_common::config::ConfigFileDecryptionProperties</span></code>
+implemented <code class="docutils literal notranslate"><span class="pre">From<&Arc<parquet::encryption::decrypt::FileDecryptionProperties>></span></code>.
+If an error was encountered when retrieving the footer key without providing key metadata,
+the error would be ignored and an empty footer key set in the result.
+This could lead to obscure errors later.</p>
+<p><code class="docutils literal notranslate"><span class="pre">ConfigFileDecryptionProperties</span></code> now instead implements <code class="docutils literal notranslate"><span class="pre">TryFrom<&Arc<FileDecryptionProperties>></span></code>,
+and errors retrieving the footer key will be propagated up.</p>
+<p><strong>Migration guide:</strong></p>
+<p>Replace calls to <code class="docutils literal notranslate"><span class="pre">ConfigFileDecryptionProperties::from</span></code> with <code class="docutils literal notranslate"><span class="pre">ConfigFileDecryptionProperties::try_from</span></code>,
+and affected calls to <code class="docutils literal notranslate"><span class="pre">into</span></code> with <code class="docutils literal notranslate"><span class="pre">try_into</span></code>, with appropriate error handling added.</p>
+<p><strong>Before:</strong></p>
+<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="kd">let</span><span class="w"> </span><span class="n">config_decryption_properties</span><span class="p">:</span><span class="w"> </span><span class="nc">ConfigFileDecryptionProperties</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">(</span><span class="o">&</span><span class="n">decryption_properties</span><span class="p">).</span><span class="n [...]
+<span class="c1">// or</span>
+<span class="kd">let</span><span class="w"> </span><span class="n">config_decryption_properties</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ConfigFileDecryptionProperties</span><span class="p">::</span><span class="n">from</span><span class="p">(</span><span class="o">&</span><span class="n">decryption_properties</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>(where <code class="docutils literal notranslate"><span class="pre">decryption_properties</span></code> is an <code class="docutils literal notranslate"><span class="pre">Arc<FileDecryptionProperties></span></code>)</p>
+<p><strong>After:</strong></p>
+<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="kd">let</span><span class="w"> </span><span class="n">config_decryption_properties</span><span class="p">:</span><span class="w"> </span><span class="nc">ConfigFileDecryptionProperties</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">(</span><span class="o">&</span><span class="n">decryption_properties</span><span class="p">).</span><span class="n [...]
+<span class="c1">// or</span>
+<span class="kd">let</span><span class="w"> </span><span class="n">config_decryption_properties</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ConfigFileDecryptionProperties</span><span class="p">::</span><span class="n">try_from</span><span class="p">(</span><span class="o">&</span><span class="n">decryption_properties</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/21602">#21602</a> and
+<a class="reference external" href="https://github.com/apache/datafusion/pull/21603">PR #21603</a> for details.</p>
+</section>
<section id="approx-percentile-cont-approx-percentile-cont-with-weight-approx-median-now-coerce-to-floats">
<h3><code class="docutils literal notranslate"><span class="pre">approx_percentile_cont</span></code>, <code class="docutils literal notranslate"><span class="pre">approx_percentile_cont_with_weight</span></code>, <code class="docutils literal notranslate"><span class="pre">approx_median</span></code> now coerce to floats<a class="headerlink" href="#approx-percentile-cont-approx-percentile-cont-with-weight-approx-median-now-coerce-to-floats" title="Link to this heading">#</a></h3>
<p>The type signatures of <code class="docutils literal notranslate"><span class="pre">approx_percentile_cont</span></code>, <code class="docutils literal notranslate"><span class="pre">approx_percentile_cont_with_weight</span></code>, and
@@ -928,6 +956,7 @@ allocation-free variant:</p>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#datafusion-proto-physicalprotoconverterextension-reshaped"><code class="docutils literal notranslate"><span class="pre">datafusion-proto</span></code>: <code class="docutils literal notranslate"><span class="pre">PhysicalProtoConverterExtension</span></code> reshaped</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#executionprops-has-new-fields"><code class="docutils literal notranslate"><span class="pre">ExecutionProps</span></code> has new fields</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#items-in-datafusion-functions-strings-are-no-longer-public">Items in <code class="docutils literal notranslate"><span class="pre">datafusion_functions::strings</span></code> are no longer public</a></li>
+<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#conversion-from-filedecryptionproperties-to-configfiledecryptionproperties-is-now-fallible">Conversion from <code class="docutils literal notranslate"><span class="pre">FileDecryptionProperties</span></code> to <code class="docutils literal notranslate"><span class="pre">ConfigFileDecryptionProperties</span></code> is now fallible</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#approx-percentile-cont-approx-percentile-cont-with-weight-approx-median-now-coerce-to-floats"><code class="docutils literal notranslate"><span class="pre">approx_percentile_cont</span></code>, <code class="docutils literal notranslate"><span class="pre">approx_percentile_cont_with_weight</span></code>, <code class="docutils literal notranslate"><span class="pre">approx_median</span></code> now coerce to f [...]
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#box-c-and-arc-c-treenodecontainer-impls-now-require-c-default"><code class="docutils literal notranslate"><span class="pre">Box<C></span></code> and <code class="docutils literal notranslate"><span class="pre">Arc<C></span></code> <code class="docutils literal notranslate"><span class="pre">TreeNodeContainer</span></code> impls now require <code class="docutils literal notranslate"><span class [...]
</ul>
diff --git a/searchindex.js b/searchindex.js
index bf9577506a..3ccfaed956 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[73,"op-neq"]],"!~":[[73,"op-re-not-match"]],"!~*":[[73,"op-re-not-match-i"]],"!~~":[[73,"id19"]],"!~~*":[[73,"id20"]],"#":[[73,"op-bit-xor"]],"%":[[73,"op-modulo"]],"&":[[73,"op-bit-and"]],"(relation, name) tuples in logical fields and logical columns are unique":[[15,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[73,"op-multiply"]],"+":[[73,"op-plus"]],"-":[[73,"op-minus"]],"/":[[73,"op-divide"]],"1. Array Literal Con [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[73,"op-neq"]],"!~":[[73,"op-re-not-match"]],"!~*":[[73,"op-re-not-match-i"]],"!~~":[[73,"id19"]],"!~~*":[[73,"id20"]],"#":[[73,"op-bit-xor"]],"%":[[73,"op-modulo"]],"&":[[73,"op-bit-and"]],"(relation, name) tuples in logical fields and logical columns are unique":[[15,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[73,"op-multiply"]],"+":[[73,"op-plus"]],"-":[[73,"op-minus"]],"/":[[73,"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