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 61afa41453 Publish built docs triggered by 
7cecc1827936428b2f620d1d9b27cdd26f020605
61afa41453 is described below

commit 61afa41453108bee2a1f8a3f1a06e9deb1b452ef
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Sat Jun 21 11:41:38 2025 +0000

    Publish built docs triggered by 7cecc1827936428b2f620d1d9b27cdd26f020605
---
 _sources/library-user-guide/upgrading.md.txt | 29 +++++++++++++++++++++++
 library-user-guide/upgrading.html            | 35 ++++++++++++++++++++++++++++
 searchindex.js                               |  2 +-
 3 files changed, 65 insertions(+), 1 deletion(-)

diff --git a/_sources/library-user-guide/upgrading.md.txt 
b/_sources/library-user-guide/upgrading.md.txt
index 613c2be43d..182e728c5b 100644
--- a/_sources/library-user-guide/upgrading.md.txt
+++ b/_sources/library-user-guide/upgrading.md.txt
@@ -59,6 +59,35 @@ See [#16317] for details.
 
 [#16317]: https://github.com/apache/datafusion/pull/16317
 
+### New `datafusion.execution.spill_compression` configuration option
+
+DataFusion 49.0.0 adds support for compressing spill files when data is 
written to disk during spilling query execution. A new configuration option 
`datafusion.execution.spill_compression` controls the compression codec used.
+
+**Configuration:**
+
+- **Key**: `datafusion.execution.spill_compression`
+- **Default**: `uncompressed`
+- **Valid values**: `uncompressed`, `lz4_frame`, `zstd`
+
+**Usage:**
+
+```rust
+use datafusion::prelude::*;
+use datafusion_common::config::SpillCompression;
+
+let config = SessionConfig::default()
+    .with_spill_compression(SpillCompression::Zstd);
+let ctx = SessionContext::new_with_config(config);
+```
+
+Or via SQL:
+
+```sql
+SET datafusion.execution.spill_compression = 'zstd';
+```
+
+For more details about this configuration option, including performance 
trade-offs between different compression codecs, see the [Configuration 
Settings](../user-guide/configs.md) documentation.
+
 ## DataFusion `48.0.0`
 
 ### `Expr::Literal` has optional metadata
diff --git a/library-user-guide/upgrading.html 
b/library-user-guide/upgrading.html
index baa1e14504..100e3017b5 100644
--- a/library-user-guide/upgrading.html
+++ b/library-user-guide/upgrading.html
@@ -584,6 +584,17 @@
      </code>
     </a>
    </li>
+   <li class="toc-h3 nav-item toc-entry">
+    <a class="reference internal nav-link" 
href="#new-datafusion-execution-spill-compression-configuration-option">
+     New
+     <code class="docutils literal notranslate">
+      <span class="pre">
+       datafusion.execution.spill_compression
+      </span>
+     </code>
+     configuration option
+    </a>
+   </li>
   </ul>
  </li>
  <li class="toc-h2 nav-item toc-entry">
@@ -994,6 +1005,30 @@ is more efficient.</p>
 </div>
 <p>See <a class="reference external" 
href="https://github.com/apache/datafusion/pull/16317";>#16317</a> for 
details.</p>
 </section>
+<section id="new-datafusion-execution-spill-compression-configuration-option">
+<h3>New <code class="docutils literal notranslate"><span 
class="pre">datafusion.execution.spill_compression</span></code> configuration 
option<a class="headerlink" 
href="#new-datafusion-execution-spill-compression-configuration-option" 
title="Link to this heading">¶</a></h3>
+<p>DataFusion 49.0.0 adds support for compressing spill files when data is 
written to disk during spilling query execution. A new configuration option 
<code class="docutils literal notranslate"><span 
class="pre">datafusion.execution.spill_compression</span></code> controls the 
compression codec used.</p>
+<p><strong>Configuration:</strong></p>
+<ul class="simple">
+<li><p><strong>Key</strong>: <code class="docutils literal notranslate"><span 
class="pre">datafusion.execution.spill_compression</span></code></p></li>
+<li><p><strong>Default</strong>: <code class="docutils literal 
notranslate"><span class="pre">uncompressed</span></code></p></li>
+<li><p><strong>Valid values</strong>: <code class="docutils literal 
notranslate"><span class="pre">uncompressed</span></code>, <code 
class="docutils literal notranslate"><span class="pre">lz4_frame</span></code>, 
<code class="docutils literal notranslate"><span 
class="pre">zstd</span></code></p></li>
+</ul>
+<p><strong>Usage:</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</span><span class="p">::</span><span 
class="n">prelude</span><span class="p">::</span><span class="o">*</span><span 
class="p">;</span>
+<span class="k">use</span><span class="w"> </span><span 
class="n">datafusion_common</span><span class="p">::</span><span 
class="n">config</span><span class="p">::</span><span 
class="n">SpillCompression</span><span class="p">;</span>
+
+<span class="kd">let</span><span class="w"> </span><span 
class="n">config</span><span class="w"> </span><span class="o">=</span><span 
class="w"> </span><span class="n">SessionConfig</span><span 
class="p">::</span><span class="n">default</span><span class="p">()</span>
+<span class="w">    </span><span class="p">.</span><span 
class="n">with_spill_compression</span><span class="p">(</span><span 
class="n">SpillCompression</span><span class="p">::</span><span 
class="n">Zstd</span><span class="p">);</span>
+<span class="kd">let</span><span class="w"> </span><span 
class="n">ctx</span><span class="w"> </span><span class="o">=</span><span 
class="w"> </span><span class="n">SessionContext</span><span 
class="p">::</span><span class="n">new_with_config</span><span 
class="p">(</span><span class="n">config</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>Or via SQL:</p>
+<div class="highlight-sql notranslate"><div 
class="highlight"><pre><span></span><span class="k">SET</span><span class="w"> 
</span><span class="n">datafusion</span><span class="p">.</span><span 
class="n">execution</span><span class="p">.</span><span 
class="n">spill_compression</span><span class="w"> </span><span 
class="o">=</span><span class="w"> </span><span 
class="s1">&#39;zstd&#39;</span><span class="p">;</span>
+</pre></div>
+</div>
+<p>For more details about this configuration option, including performance 
trade-offs between different compression codecs, see the <a class="reference 
internal" href="../user-guide/configs.html"><span class="std 
std-doc">Configuration Settings</span></a> documentation.</p>
+</section>
 </section>
 <section id="datafusion-48-0-0">
 <h2>DataFusion <code class="docutils literal notranslate"><span 
class="pre">48.0.0</span></code><a class="headerlink" href="#datafusion-48-0-0" 
title="Link to this heading">¶</a></h2>
diff --git a/searchindex.js b/searchindex.js
index 9d0564efad..14f339befc 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[57,"op-neq"]],"!~":[[57,"op-re-not-match"]],"!~*":[[57,"op-re-not-match-i"]],"!~~":[[57,"id19"]],"!~~*":[[57,"id20"]],"#":[[57,"op-bit-xor"]],"%":[[57,"op-modulo"]],"&":[[57,"op-bit-and"]],"(relation,
 name) tuples in logical fields and logical columns are 
unique":[[12,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[57,"op-multiply"]],"+":[[57,"op-plus"]],"-":[[57,"op-minus"]],"/":[[57,"op-divide"]],"<":[[57,"op-lt"]],"<
 [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[57,"op-neq"]],"!~":[[57,"op-re-not-match"]],"!~*":[[57,"op-re-not-match-i"]],"!~~":[[57,"id19"]],"!~~*":[[57,"id20"]],"#":[[57,"op-bit-xor"]],"%":[[57,"op-modulo"]],"&":[[57,"op-bit-and"]],"(relation,
 name) tuples in logical fields and logical columns are 
unique":[[12,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[57,"op-multiply"]],"+":[[57,"op-plus"]],"-":[[57,"op-minus"]],"/":[[57,"op-divide"]],"<":[[57,"op-lt"]],"<
 [...]
\ No newline at end of file


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@datafusion.apache.org
For additional commands, e-mail: commits-h...@datafusion.apache.org

Reply via email to