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/04 20:51:14 UTC
(datafusion) branch asf-site updated: Publish built docs triggered by e8015e41a7d38098a61c3776debf052ae03ece96
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 77c2b1ed73 Publish built docs triggered by e8015e41a7d38098a61c3776debf052ae03ece96
77c2b1ed73 is described below
commit 77c2b1ed731b1e014626a4570ffcb74db56163c3
Author: github-actions[bot] <gi...@users.noreply.github.com>
AuthorDate: Tue Aug 4 20:51:08 2026 +0000
Publish built docs triggered by e8015e41a7d38098a61c3776debf052ae03ece96
---
.../library-user-guide/upgrading/55.0.0.md.txt | 48 ++++++++++++++++++++++
library-user-guide/upgrading/55.0.0.html | 44 ++++++++++++++++++++
searchindex.js | 2 +-
3 files changed, 93 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 9a65651fc3..53cba29f9a 100644
--- a/_sources/library-user-guide/upgrading/55.0.0.md.txt
+++ b/_sources/library-user-guide/upgrading/55.0.0.md.txt
@@ -1030,6 +1030,54 @@ The Minimum Supported Rust Version (MSRV) has been updated to [`1.94.0`].
[`1.94.0`]: https://releases.rs/docs/1.94.0/
+### `CachedParquetFileReader` removed; `ParquetFileReader` fields are now private
+
+`CachedParquetFileReader` duplicated `ParquetFileReader` and has been removed;
+`ParquetFileReader`'s fields are also now private, with
+`file_metrics()` and `partitioned_file()` accessors added for the two that
+were previously public.
+
+**Who is affected:**
+
+- Code that names the `CachedParquetFileReader` type.
+- Code that constructs a `ParquetFileReader` directly via a struct literal, or
+ reads/writes its fields.
+
+**Migration guide:**
+
+`ParquetFileReader::new` is no longer public; build a reader through
+`ParquetFileReaderFactory::create_reader` (via `DefaultParquetFileReaderFactory`
+or `CachedParquetFileReaderFactory`) instead of constructing one directly:
+
+```rust,ignore
+// Before
+let inner = ParquetObjectReader::new(Arc::clone(&store), location).with_file_size(size);
+let reader = CachedParquetFileReader::new(
+ file_metrics,
+ store,
+ inner,
+ partitioned_file,
+ metadata_cache,
+ metadata_size_hint,
+);
+
+// After
+let reader = CachedParquetFileReaderFactory::new(store, metadata_cache)
+ .create_reader(partition_index, partitioned_file, metadata_size_hint, &metrics)?;
+```
+
+Replace field access with the new accessor methods:
+
+```rust,ignore
+// Before
+let bytes_scanned = reader.file_metrics.bytes_scanned.value();
+let location = &reader.partitioned_file.object_meta.location;
+
+// After
+let bytes_scanned = reader.file_metrics().bytes_scanned.value();
+let location = &reader.partitioned_file().object_meta.location;
+```
+
### `array_distance` scalar function now rejects multidimensional arrays
`array_distance` only supports one-dimensional arrays. Previously, when given
diff --git a/library-user-guide/upgrading/55.0.0.html b/library-user-guide/upgrading/55.0.0.html
index d3b32b9e9f..c27b8bf5d0 100644
--- a/library-user-guide/upgrading/55.0.0.html
+++ b/library-user-guide/upgrading/55.0.0.html
@@ -1337,6 +1337,49 @@ each partition’s state.</p>
<h3><code class="docutils literal notranslate"><span class="pre">MSRV</span></code> updated to 1.94.0<a class="headerlink" href="#msrv-updated-to-1-94-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.94.0/"><code class="docutils literal notranslate"><span class="pre">1.94.0</span></code></a>.</p>
</section>
+<section id="cachedparquetfilereader-removed-parquetfilereader-fields-are-now-private">
+<h3><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 class="headerlink" href="#cachedparquetfilereader-removed-parquetfilereader-fields-are-now-private" title="Link to this heading">#</a></h3>
+<p><code class="docutils literal notranslate"><span class="pre">CachedParquetFileReader</span></code> duplicated <code class="docutils literal notranslate"><span class="pre">ParquetFileReader</span></code> and has been removed;
+<code class="docutils literal notranslate"><span class="pre">ParquetFileReader</span></code>’s fields are also now private, with
+<code class="docutils literal notranslate"><span class="pre">file_metrics()</span></code> and <code class="docutils literal notranslate"><span class="pre">partitioned_file()</span></code> accessors added for the two that
+were previously public.</p>
+<p><strong>Who is affected:</strong></p>
+<ul class="simple">
+<li><p>Code that names the <code class="docutils literal notranslate"><span class="pre">CachedParquetFileReader</span></code> type.</p></li>
+<li><p>Code that constructs a <code class="docutils literal notranslate"><span class="pre">ParquetFileReader</span></code> directly via a struct literal, or
+reads/writes its fields.</p></li>
+</ul>
+<p><strong>Migration guide:</strong></p>
+<p><code class="docutils literal notranslate"><span class="pre">ParquetFileReader::new</span></code> is no longer public; build a reader through
+<code class="docutils literal notranslate"><span class="pre">ParquetFileReaderFactory::create_reader</span></code> (via <code class="docutils literal notranslate"><span class="pre">DefaultParquetFileReaderFactory</span></code>
+or <code class="docutils literal notranslate"><span class="pre">CachedParquetFileReaderFactory</span></code>) instead of constructing one directly:</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">inner</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ParquetObjectReader</span><span class="p">::</span><span class="n">new</span><span class="p">(</span><span class="n">Arc</span><span class="p">::</span><span class="n">clone</span><span class="p">(</span><span class="o">&</span><span class="n">store</span><span class="p">),</span><span class="w"> </span><span class="n"> [...]
+<span class="kd">let</span><span class="w"> </span><span class="n">reader</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">CachedParquetFileReader</span><span class="p">::</span><span class="n">new</span><span class="p">(</span>
+<span class="w"> </span><span class="n">file_metrics</span><span class="p">,</span>
+<span class="w"> </span><span class="n">store</span><span class="p">,</span>
+<span class="w"> </span><span class="n">inner</span><span class="p">,</span>
+<span class="w"> </span><span class="n">partitioned_file</span><span class="p">,</span>
+<span class="w"> </span><span class="n">metadata_cache</span><span class="p">,</span>
+<span class="w"> </span><span class="n">metadata_size_hint</span><span class="p">,</span>
+<span class="p">);</span>
+
+<span class="c1">// After</span>
+<span class="kd">let</span><span class="w"> </span><span class="n">reader</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">CachedParquetFileReaderFactory</span><span class="p">::</span><span class="n">new</span><span class="p">(</span><span class="n">store</span><span class="p">,</span><span class="w"> </span><span class="n">metadata_cache</span><span class="p">)</span>
+<span class="w"> </span><span class="p">.</span><span class="n">create_reader</span><span class="p">(</span><span class="n">partition_index</span><span class="p">,</span><span class="w"> </span><span class="n">partitioned_file</span><span class="p">,</span><span class="w"> </span><span class="n">metadata_size_hint</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">metrics</span><span class="p">)</span><span class="o">?</span><span class=" [...]
+</pre></div>
+</div>
+<p>Replace field access with the new accessor methods:</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">bytes_scanned</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">reader</span><span class="p">.</span><span class="n">file_metrics</span><span class="p">.</span><span class="n">bytes_scanned</span><span class="p">.</span><span class="n">value</span><span class="p">();</span>
+<span class="kd">let</span><span class="w"> </span><span class="n">location</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="o">&</span><span class="n">reader</span><span class="p">.</span><span class="n">partitioned_file</span><span class="p">.</span><span class="n">object_meta</span><span class="p">.</span><span class="n">location</span><span class="p">;</span>
+
+<span class="c1">// After</span>
+<span class="kd">let</span><span class="w"> </span><span class="n">bytes_scanned</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">reader</span><span class="p">.</span><span class="n">file_metrics</span><span class="p">().</span><span class="n">bytes_scanned</span><span class="p">.</span><span class="n">value</span><span class="p">();</span>
+<span class="kd">let</span><span class="w"> </span><span class="n">location</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="o">&</span><span class="n">reader</span><span class="p">.</span><span class="n">partitioned_file</span><span class="p">().</span><span class="n">object_meta</span><span class="p">.</span><span class="n">location</span><span class="p">;</span>
+</pre></div>
+</div>
+</section>
<section id="array-distance-scalar-function-now-rejects-multidimensional-arrays">
<h3><code class="docutils literal notranslate"><span class="pre">array_distance</span></code> scalar function now rejects multidimensional arrays<a class="headerlink" href="#array-distance-scalar-function-now-rejects-multidimensional-arrays" title="Link to this heading">#</a></h3>
<p><code class="docutils literal notranslate"><span class="pre">array_distance</span></code> only supports one-dimensional arrays. Previously, when given
@@ -1431,6 +1474,7 @@ supports one-dimensional arrays.</p>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#windowexpr-evaluate-stateful-now-takes-a-windowevalcontext"><code class="docutils literal notranslate"><span class="pre">WindowExpr::evaluate_stateful</span></code> now takes a <code class="docutils literal notranslate"><span class="pre">WindowEvalContext</span></code></a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#partitionbatchstate-most-recent-row-removed"><code class="docutils literal notranslate"><span class="pre">PartitionBatchState::most_recent_row</span></code> removed</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#msrv-updated-to-1-94-0"><code class="docutils literal notranslate"><span class="pre">MSRV</span></code> updated to 1.94.0</a></li>
+<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>
</ul>
</li>
diff --git a/searchindex.js b/searchindex.js
index 040a675dff..3c336453ef 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[74,"op-neq"]],"!~":[[74,"op-re-not-match"]],"!~*":[[74,"op-re-not-match-i"]],"!~~":[[74,"id19"]],"!~~*":[[74,"id20"]],"#":[[74,"op-bit-xor"]],"%":[[74,"op-modulo"]],"&":[[74,"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"]],"*":[[74,"op-multiply"]],"+":[[74,"op-plus"]],"-":[[74,"op-minus"]],"/":[[74,"op-divide"]],"1. Array Literal Con [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[74,"op-neq"]],"!~":[[74,"op-re-not-match"]],"!~*":[[74,"op-re-not-match-i"]],"!~~":[[74,"id19"]],"!~~*":[[74,"id20"]],"#":[[74,"op-bit-xor"]],"%":[[74,"op-modulo"]],"&":[[74,"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"]],"*":[[74,"op-multiply"]],"+":[[74,"op-plus"]],"-":[[74,"op-minus"]],"/":[[74,"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