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 0147a96156 Publish built docs triggered by
36c0cda206db6cdb4ace600422835c890294a1f1
0147a96156 is described below
commit 0147a961568e4bb3cf43dd6f31247cbdfb72e1c9
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Wed Jan 28 20:59:11 2026 +0000
Publish built docs triggered by 36c0cda206db6cdb4ace600422835c890294a1f1
---
_sources/library-user-guide/upgrading.md.txt | 40 +++++++++++++++++++++++++++-
library-user-guide/upgrading.html | 35 +++++++++++++++++++++++-
searchindex.js | 2 +-
3 files changed, 74 insertions(+), 3 deletions(-)
diff --git a/_sources/library-user-guide/upgrading.md.txt
b/_sources/library-user-guide/upgrading.md.txt
index 447a773eee..f5c4fc0921 100644
--- a/_sources/library-user-guide/upgrading.md.txt
+++ b/_sources/library-user-guide/upgrading.md.txt
@@ -21,7 +21,45 @@
## DataFusion `53.0.0`
-**Note:** DataFusion `53.0.0` 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.
+**Note:** DataFusion `53.0.0` 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. See [#19692] for
+\*more details.
+
+[#19692]: https://github.com/apache/datafusion/issues/19692
+
+### `FileSinkConfig` adds `file_output_mode`
+
+`FileSinkConfig` now includes a `file_output_mode: FileOutputMode` field to
control
+single-file vs directory output behavior. Any code constructing
`FileSinkConfig` via struct
+literals must initialize this field.
+
+The `FileOutputMode` enum has three variants:
+
+- `Automatic` (default): Infer output mode from the URL (extension/trailing
`/` heuristic)
+- `SingleFile`: Write to a single file at the exact output path
+- `Directory`: Write to a directory with generated filenames
+
+**Before:**
+
+```rust,ignore
+FileSinkConfig {
+ // ...
+ file_extension: "parquet".into(),
+}
+```
+
+**After:**
+
+```rust,ignore
+use datafusion_datasource::file_sink_config::FileOutputMode;
+
+FileSinkConfig {
+ // ...
+ file_extension: "parquet".into(),
+ file_output_mode: FileOutputMode::Automatic,
+}
+```
### `SimplifyInfo` trait removed, `SimplifyContext` now uses builder-style API
diff --git a/library-user-guide/upgrading.html
b/library-user-guide/upgrading.html
index c4ab58cbda..13dc0af168 100644
--- a/library-user-guide/upgrading.html
+++ b/library-user-guide/upgrading.html
@@ -409,7 +409,39 @@
<h1>Upgrade Guides<a class="headerlink" href="#upgrade-guides" title="Link to
this heading">#</a></h1>
<section id="datafusion-53-0-0">
<h2>DataFusion <code class="docutils literal notranslate"><span
class="pre">53.0.0</span></code><a class="headerlink" href="#datafusion-53-0-0"
title="Link to this heading">#</a></h2>
-<p><strong>Note:</strong> DataFusion <code class="docutils literal
notranslate"><span class="pre">53.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><strong>Note:</strong> DataFusion <code class="docutils literal
notranslate"><span class="pre">53.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. See <a
class="reference external"
href="https://github.com/apache/datafusion/issues/19692";>#19692</a> for
+*more details.</p>
+<section id="filesinkconfig-adds-file-output-mode">
+<h3><code class="docutils literal notranslate"><span
class="pre">FileSinkConfig</span></code> adds <code class="docutils literal
notranslate"><span class="pre">file_output_mode</span></code><a
class="headerlink" href="#filesinkconfig-adds-file-output-mode" title="Link to
this heading">#</a></h3>
+<p><code class="docutils literal notranslate"><span
class="pre">FileSinkConfig</span></code> now includes a <code class="docutils
literal notranslate"><span class="pre">file_output_mode:</span> <span
class="pre">FileOutputMode</span></code> field to control
+single-file vs directory output behavior. Any code constructing <code
class="docutils literal notranslate"><span
class="pre">FileSinkConfig</span></code> via struct
+literals must initialize this field.</p>
+<p>The <code class="docutils literal notranslate"><span
class="pre">FileOutputMode</span></code> enum has three variants:</p>
+<ul class="simple">
+<li><p><code class="docutils literal notranslate"><span
class="pre">Automatic</span></code> (default): Infer output mode from the URL
(extension/trailing <code class="docutils literal notranslate"><span
class="pre">/</span></code> heuristic)</p></li>
+<li><p><code class="docutils literal notranslate"><span
class="pre">SingleFile</span></code>: Write to a single file at the exact
output path</p></li>
+<li><p><code class="docutils literal notranslate"><span
class="pre">Directory</span></code>: Write to a directory with generated
filenames</p></li>
+</ul>
+<p><strong>Before:</strong></p>
+<div class="highlight-rust notranslate"><div
class="highlight"><pre><span></span><span class="n">FileSinkConfig</span><span
class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="c1">// ...</span>
+<span class="w"> </span><span class="n">file_extension</span><span
class="p">:</span><span class="w"> </span><span
class="s">"parquet"</span><span class="p">.</span><span
class="n">into</span><span class="p">(),</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p><strong>After:</strong></p>
+<div class="highlight-rust notranslate"><div
class="highlight"><pre><span></span><span class="k">use</span><span class="w">
</span><span class="n">datafusion_datasource</span><span
class="p">::</span><span class="n">file_sink_config</span><span
class="p">::</span><span class="n">FileOutputMode</span><span class="p">;</span>
+
+<span class="n">FileSinkConfig</span><span class="w"> </span><span
class="p">{</span>
+<span class="w"> </span><span class="c1">// ...</span>
+<span class="w"> </span><span class="n">file_extension</span><span
class="p">:</span><span class="w"> </span><span
class="s">"parquet"</span><span class="p">.</span><span
class="n">into</span><span class="p">(),</span>
+<span class="w"> </span><span class="n">file_output_mode</span><span
class="p">:</span><span class="w"> </span><span
class="nc">FileOutputMode</span><span class="p">::</span><span
class="n">Automatic</span><span class="p">,</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</section>
<section
id="simplifyinfo-trait-removed-simplifycontext-now-uses-builder-style-api">
<h3><code class="docutils literal notranslate"><span
class="pre">SimplifyInfo</span></code> trait removed, <code class="docutils
literal notranslate"><span class="pre">SimplifyContext</span></code> now uses
builder-style API<a class="headerlink"
href="#simplifyinfo-trait-removed-simplifycontext-now-uses-builder-style-api"
title="Link to this heading">#</a></h3>
<p>The <code class="docutils literal notranslate"><span
class="pre">SimplifyInfo</span></code> trait has been removed and replaced with
the concrete <code class="docutils literal notranslate"><span
class="pre">SimplifyContext</span></code> struct. This simplifies the
expression simplification API and removes the need for trait objects.</p>
@@ -2305,6 +2337,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-53-0-0">DataFusion <code class="docutils literal
notranslate"><span class="pre">53.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="#filesinkconfig-adds-file-output-mode"><code class="docutils literal
notranslate"><span class="pre">FileSinkConfig</span></code> adds <code
class="docutils literal notranslate"><span
class="pre">file_output_mode</span></code></a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#simplifyinfo-trait-removed-simplifycontext-now-uses-builder-style-api"><code
class="docutils literal notranslate"><span
class="pre">SimplifyInfo</span></code> trait removed, <code class="docutils
literal notranslate"><span class="pre">SimplifyContext</span></code> now uses
builder-style API</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#filterexec-builder-methods-deprecated"><code class="docutils literal
notranslate"><span class="pre">FilterExec</span></code> builder methods
deprecated</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#protobuf-conversion-trait-added">Protobuf conversion trait added</a></li>
diff --git a/searchindex.js b/searchindex.js
index dbf935fbe4..5e95b1295c 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[62,"op-neq"]],"!~":[[62,"op-re-not-match"]],"!~*":[[62,"op-re-not-match-i"]],"!~~":[[62,"id19"]],"!~~*":[[62,"id20"]],"#":[[62,"op-bit-xor"]],"%":[[62,"op-modulo"]],"&":[[62,"op-bit-and"]],"(relation,
name) tuples in logical fields and logical columns are
unique":[[14,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[62,"op-multiply"]],"+":[[62,"op-plus"]],"-":[[62,"op-minus"]],"/":[[62,"op-divide"]],"1.
Array Literal Con [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[62,"op-neq"]],"!~":[[62,"op-re-not-match"]],"!~*":[[62,"op-re-not-match-i"]],"!~~":[[62,"id19"]],"!~~*":[[62,"id20"]],"#":[[62,"op-bit-xor"]],"%":[[62,"op-modulo"]],"&":[[62,"op-bit-and"]],"(relation,
name) tuples in logical fields and logical columns are
unique":[[14,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[62,"op-multiply"]],"+":[[62,"op-plus"]],"-":[[62,"op-minus"]],"/":[[62,"op-divide"]],"1.
Array Literal Con [...]
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
