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/09/16 14:21:01 UTC
(datafusion) branch asf-site updated: Publish built docs triggered by 2cb6b54085ad36f412717b6a79b683d78ae2f48e
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 8ac50dbb88 Publish built docs triggered by 2cb6b54085ad36f412717b6a79b683d78ae2f48e
8ac50dbb88 is described below
commit 8ac50dbb88d575cf89ef4945f89b2570ea8d7946
Author: github-actions[bot] <gi...@users.noreply.github.com>
AuthorDate: Wed Sep 16 14:20:56 2026 +0000
Publish built docs triggered by 2cb6b54085ad36f412717b6a79b683d78ae2f48e
---
.../library-user-guide/upgrading/56.0.0.md.txt | 37 ++++++++++++++++++++++
library-user-guide/upgrading/56.0.0.html | 34 ++++++++++++++++++++
searchindex.js | 2 +-
3 files changed, 72 insertions(+), 1 deletion(-)
diff --git a/_sources/library-user-guide/upgrading/56.0.0.md.txt b/_sources/library-user-guide/upgrading/56.0.0.md.txt
index ef51e4c9a7..20cd0809ee 100644
--- a/_sources/library-user-guide/upgrading/56.0.0.md.txt
+++ b/_sources/library-user-guide/upgrading/56.0.0.md.txt
@@ -227,6 +227,43 @@ The protobuf wire format remains backward compatible.
See [PR #24945](https://github.com/apache/datafusion/pull/24945) for details.
+### Generated protobuf `CsvWriterOptions` changed
+
+The generated `CsvWriterOptions` now includes `compression_level`,
+`timestamp_tz_format`, and `terminator`. Its four existing format fields changed
+from `String` to `Option<String>` to distinguish unset from explicitly empty
+formats. This affects exhaustive struct literals and direct format-field access.
+
+Wrap existing formats in `Some` or use `None`, and initialize the new fields
+(explicitly or through `Default`):
+
+```rust,ignore
+// Before (unchanged fields omitted)
+CsvWriterOptions {
+ date_format: "%Y-%m-%d".to_string(),
+ datetime_format: String::new(),
+ timestamp_format: String::new(),
+ time_format: String::new(),
+ // ...
+}
+
+// After
+CsvWriterOptions {
+ date_format: Some("%Y-%m-%d".to_string()),
+ datetime_format: None,
+ timestamp_format: None,
+ time_format: None,
+ compression_level: None,
+ timestamp_tz_format: None,
+ terminator: Vec::new(),
+ // ...
+}
+```
+
+The protobuf wire format remains backward compatible.
+
+See [PR #25058](https://github.com/apache/datafusion/pull/25058) for details.
+
### `DefaultStatisticsProvider` is deprecated
`datafusion_physical_plan::operator_statistics::DefaultStatisticsProvider` is
diff --git a/library-user-guide/upgrading/56.0.0.html b/library-user-guide/upgrading/56.0.0.html
index 545ba4dd0d..273ff90926 100644
--- a/library-user-guide/upgrading/56.0.0.html
+++ b/library-user-guide/upgrading/56.0.0.html
@@ -638,6 +638,39 @@ struct literal.</p></li>
<p>The protobuf wire format remains backward compatible.</p>
<p>See <a class="reference external" href="https://github.com/apache/datafusion/pull/24945">PR #24945</a> for details.</p>
</section>
+<section id="generated-protobuf-csvwriteroptions-changed">
+<h3>Generated protobuf <code class="docutils literal notranslate"><span class="pre">CsvWriterOptions</span></code> changed<a class="headerlink" href="#generated-protobuf-csvwriteroptions-changed" title="Link to this heading">#</a></h3>
+<p>The generated <code class="docutils literal notranslate"><span class="pre">CsvWriterOptions</span></code> now includes <code class="docutils literal notranslate"><span class="pre">compression_level</span></code>,
+<code class="docutils literal notranslate"><span class="pre">timestamp_tz_format</span></code>, and <code class="docutils literal notranslate"><span class="pre">terminator</span></code>. Its four existing format fields changed
+from <code class="docutils literal notranslate"><span class="pre">String</span></code> to <code class="docutils literal notranslate"><span class="pre">Option<String></span></code> to distinguish unset from explicitly empty
+formats. This affects exhaustive struct literals and direct format-field access.</p>
+<p>Wrap existing formats in <code class="docutils literal notranslate"><span class="pre">Some</span></code> or use <code class="docutils literal notranslate"><span class="pre">None</span></code>, and initialize the new fields
+(explicitly or through <code class="docutils literal notranslate"><span class="pre">Default</span></code>):</p>
+<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="c1">// Before (unchanged fields omitted)</span>
+<span class="n">CsvWriterOptions</span><span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="n">date_format</span><span class="p">:</span><span class="w"> </span><span class="s">"%Y-%m-%d"</span><span class="p">.</span><span class="n">to_string</span><span class="p">(),</span>
+<span class="w"> </span><span class="n">datetime_format</span><span class="p">:</span><span class="w"> </span><span class="nb">String</span><span class="p">::</span><span class="n">new</span><span class="p">(),</span>
+<span class="w"> </span><span class="n">timestamp_format</span><span class="p">:</span><span class="w"> </span><span class="nb">String</span><span class="p">::</span><span class="n">new</span><span class="p">(),</span>
+<span class="w"> </span><span class="n">time_format</span><span class="p">:</span><span class="w"> </span><span class="nb">String</span><span class="p">::</span><span class="n">new</span><span class="p">(),</span>
+<span class="w"> </span><span class="c1">// ...</span>
+<span class="p">}</span>
+
+<span class="c1">// After</span>
+<span class="n">CsvWriterOptions</span><span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="n">date_format</span><span class="p">:</span><span class="w"> </span><span class="nb">Some</span><span class="p">(</span><span class="s">"%Y-%m-%d"</span><span class="p">.</span><span class="n">to_string</span><span class="p">()),</span>
+<span class="w"> </span><span class="n">datetime_format</span><span class="p">:</span><span class="w"> </span><span class="nb">None</span><span class="p">,</span>
+<span class="w"> </span><span class="n">timestamp_format</span><span class="p">:</span><span class="w"> </span><span class="nb">None</span><span class="p">,</span>
+<span class="w"> </span><span class="n">time_format</span><span class="p">:</span><span class="w"> </span><span class="nb">None</span><span class="p">,</span>
+<span class="w"> </span><span class="n">compression_level</span><span class="p">:</span><span class="w"> </span><span class="nb">None</span><span class="p">,</span>
+<span class="w"> </span><span class="n">timestamp_tz_format</span><span class="p">:</span><span class="w"> </span><span class="nb">None</span><span class="p">,</span>
+<span class="w"> </span><span class="n">terminator</span><span class="p">:</span><span class="w"> </span><span class="nb">Vec</span><span class="p">::</span><span class="n">new</span><span class="p">(),</span>
+<span class="w"> </span><span class="c1">// ...</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>The protobuf wire format remains backward compatible.</p>
+<p>See <a class="reference external" href="https://github.com/apache/datafusion/pull/25058">PR #25058</a> for details.</p>
+</section>
<section id="defaultstatisticsprovider-is-deprecated">
<h3><code class="docutils literal notranslate"><span class="pre">DefaultStatisticsProvider</span></code> is deprecated<a class="headerlink" href="#defaultstatisticsprovider-is-deprecated" title="Link to this heading">#</a></h3>
<p><code class="docutils literal notranslate"><span class="pre">datafusion_physical_plan::operator_statistics::DefaultStatisticsProvider</span></code> is
@@ -813,6 +846,7 @@ filter on <code class="docutils literal notranslate"><span class="pre">a@0</
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#executionoptions-has-a-new-enable-nlj-coordinated-fallback-field"><code class="docutils literal notranslate"><span class="pre">ExecutionOptions</span></code> has a new <code class="docutils literal notranslate"><span class="pre">enable_nlj_coordinated_fallback</span></code> field</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#datafusion-optimizer-use-statistics-registry-is-deprecated-and-ignored"><code class="docutils literal notranslate"><span class="pre">datafusion.optimizer.use_statistics_registry</span></code> is deprecated and ignored</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#generated-protobuf-jsonwriteroptions-gained-a-compression-level-field">Generated protobuf <code class="docutils literal notranslate"><span class="pre">JsonWriterOptions</span></code> gained a <code class="docutils literal notranslate"><span class="pre">compression_level</span></code> field</a></li>
+<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#generated-protobuf-csvwriteroptions-changed">Generated protobuf <code class="docutils literal notranslate"><span class="pre">CsvWriterOptions</span></code> changed</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#defaultstatisticsprovider-is-deprecated"><code class="docutils literal notranslate"><span class="pre">DefaultStatisticsProvider</span></code> is deprecated</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#statisticsregistry-compute-and-compute-base-are-deprecated"><code class="docutils literal notranslate"><span class="pre">StatisticsRegistry::compute</span></code> and <code class="docutils literal notranslate"><span class="pre">compute_base</span></code> are deprecated</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#api-change-for-floor-and-ceil-udf">API change for <code class="docutils literal notranslate"><span class="pre">floor</span></code> and <code class="docutils literal notranslate"><span class="pre">ceil</span></code> UDF</a></li>
diff --git a/searchindex.js b/searchindex.js
index 288d372273..3ab1935f13 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[77,"op-neq"]],"!~":[[77,"op-re-not-match"]],"!~*":[[77,"op-re-not-match-i"]],"!~~":[[77,"id19"]],"!~~*":[[77,"id20"]],"#":[[77,"op-bit-xor"]],"%":[[77,"op-modulo"]],"&":[[77,"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"]],"*":[[77,"op-multiply"]],"+":[[77,"op-plus"]],"-":[[77,"op-minus"]],"/":[[77,"op-divide"]],"1. Array Literal Con [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[77,"op-neq"]],"!~":[[77,"op-re-not-match"]],"!~*":[[77,"op-re-not-match-i"]],"!~~":[[77,"id19"]],"!~~*":[[77,"id20"]],"#":[[77,"op-bit-xor"]],"%":[[77,"op-modulo"]],"&":[[77,"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"]],"*":[[77,"op-multiply"]],"+":[[77,"op-plus"]],"-":[[77,"op-minus"]],"/":[[77,"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