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 a445a1b8e9 Publish built docs triggered by
477053d83120c8ca991d839ddea3cbef553928e6
a445a1b8e9 is described below
commit a445a1b8e9a12a4fe39fc208abf53c43581087a1
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Mon Dec 1 17:22:03 2025 +0000
Publish built docs triggered by 477053d83120c8ca991d839ddea3cbef553928e6
---
_sources/library-user-guide/upgrading.md.txt | 15 +++++++++++++++
library-user-guide/upgrading.html | 14 ++++++++++++++
searchindex.js | 2 +-
3 files changed, 30 insertions(+), 1 deletion(-)
diff --git a/_sources/library-user-guide/upgrading.md.txt
b/_sources/library-user-guide/upgrading.md.txt
index 25c209c5eb..d40fee0938 100644
--- a/_sources/library-user-guide/upgrading.md.txt
+++ b/_sources/library-user-guide/upgrading.md.txt
@@ -25,6 +25,21 @@
You can see the current [status of the `52.0.0`release
here](https://github.com/apache/datafusion/issues/18566)
+### Changes to DFSchema API
+
+To permit more efficient planning, several methods on `DFSchema` have been
+changed to return references to the underlying [`&FieldRef`] rather than
+[`&Field`]. This allows planners to more cheaply copy the references via
+`Arc::clone` rather than cloning the entire `Field` structure.
+
+You may need to change code to use `Arc::clone` instead of `.as_ref().clone()`
+directly on the `Field`. For example:
+
+```diff
+- let field = df_schema.field("my_column").as_ref().clone();
++ let field = Arc::clone(df_schema.field("my_column"));
+```
+
### Removal of `pyarrow` feature
The `pyarrow` feature flag has been removed. This feature has been migrated to
diff --git a/library-user-guide/upgrading.html
b/library-user-guide/upgrading.html
index 0d81f1bde4..118dac84d4 100644
--- a/library-user-guide/upgrading.html
+++ b/library-user-guide/upgrading.html
@@ -407,6 +407,19 @@
<h2>DataFusion <code class="docutils literal notranslate"><span
class="pre">52.0.0</span></code><a class="headerlink" href="#datafusion-52-0-0"
title="Link to this heading">#</a></h2>
<p><strong>Note:</strong> DataFusion <code class="docutils literal
notranslate"><span class="pre">52.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/18566";>status of the <code
class="docutils literal notranslate"><span
class="pre">52.0.0</span></code>release here</a></p>
+<section id="changes-to-dfschema-api">
+<h3>Changes to DFSchema API<a class="headerlink"
href="#changes-to-dfschema-api" title="Link to this heading">#</a></h3>
+<p>To permit more efficient planning, several methods on <code class="docutils
literal notranslate"><span class="pre">DFSchema</span></code> have been
+changed to return references to the underlying [<code class="docutils literal
notranslate"><span class="pre">&FieldRef</span></code>] rather than
+[<code class="docutils literal notranslate"><span
class="pre">&Field</span></code>]. This allows planners to more cheaply
copy the references via
+<code class="docutils literal notranslate"><span
class="pre">Arc::clone</span></code> rather than cloning the entire <code
class="docutils literal notranslate"><span class="pre">Field</span></code>
structure.</p>
+<p>You may need to change code to use <code class="docutils literal
notranslate"><span class="pre">Arc::clone</span></code> instead of <code
class="docutils literal notranslate"><span
class="pre">.as_ref().clone()</span></code>
+directly on the <code class="docutils literal notranslate"><span
class="pre">Field</span></code>. For example:</p>
+<div class="highlight-diff notranslate"><div
class="highlight"><pre><span></span><span class="gd">- let field =
df_schema.field("my_column").as_ref().clone();</span>
+<span class="gi">+ let field =
Arc::clone(df_schema.field("my_column"));</span>
+</pre></div>
+</div>
+</section>
<section id="removal-of-pyarrow-feature">
<h3>Removal of <code class="docutils literal notranslate"><span
class="pre">pyarrow</span></code> feature<a class="headerlink"
href="#removal-of-pyarrow-feature" title="Link to this heading">#</a></h3>
<p>The <code class="docutils literal notranslate"><span
class="pre">pyarrow</span></code> feature flag has been removed. This feature
has been migrated to
@@ -1893,6 +1906,7 @@ take care of constructing the <code class="docutils
literal notranslate"><span c
<nav class="bd-toc-nav page-toc"
aria-labelledby="pst-page-navigation-heading-2">
<ul class="visible nav section-nav flex-column">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link"
href="#datafusion-52-0-0">DataFusion <code class="docutils literal
notranslate"><span class="pre">52.0.0</span></code></a><ul class="nav
section-nav flex-column">
+<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#changes-to-dfschema-api">Changes to DFSchema API</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#removal-of-pyarrow-feature">Removal of <code class="docutils literal
notranslate"><span class="pre">pyarrow</span></code> feature</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#statistics-handling-moved-from-filesource-to-filescanconfig">Statistics
handling moved from <code class="docutils literal notranslate"><span
class="pre">FileSource</span></code> to <code class="docutils literal
notranslate"><span class="pre">FileScanConfig</span></code></a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#planner-now-requires-explicit-opt-in-for-within-group-syntax">Planner
now requires explicit opt-in for WITHIN GROUP syntax</a></li>
diff --git a/searchindex.js b/searchindex.js
index 33f5cb1acb..11435bb1b5 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[60,"op-neq"]],"!~":[[60,"op-re-not-match"]],"!~*":[[60,"op-re-not-match-i"]],"!~~":[[60,"id19"]],"!~~*":[[60,"id20"]],"#":[[60,"op-bit-xor"]],"%":[[60,"op-modulo"]],"&":[[60,"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"]],"*":[[60,"op-multiply"]],"+":[[60,"op-plus"]],"-":[[60,"op-minus"]],"/":[[60,"op-divide"]],"<":[[60,"op-lt"]],"<
[...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[60,"op-neq"]],"!~":[[60,"op-re-not-match"]],"!~*":[[60,"op-re-not-match-i"]],"!~~":[[60,"id19"]],"!~~*":[[60,"id20"]],"#":[[60,"op-bit-xor"]],"%":[[60,"op-modulo"]],"&":[[60,"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"]],"*":[[60,"op-multiply"]],"+":[[60,"op-plus"]],"-":[[60,"op-minus"]],"/":[[60,"op-divide"]],"<":[[60,"op-lt"]],"<
[...]
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
