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 aeb0e3a2ed Publish built docs triggered by 
577c42458e8ab7a0869345678e7f0cd5dbf82771
aeb0e3a2ed is described below

commit aeb0e3a2ed51c196d5a32725de4c9a971463ae8f
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Mon May 19 19:51:37 2025 +0000

    Publish built docs triggered by 577c42458e8ab7a0869345678e7f0cd5dbf82771
---
 _sources/library-user-guide/upgrading.md.txt | 15 +++++++++++++++
 library-user-guide/upgrading.html            | 12 ++++++++++++
 searchindex.js                               |  2 +-
 3 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/_sources/library-user-guide/upgrading.md.txt 
b/_sources/library-user-guide/upgrading.md.txt
index bc6585c02f..415bb658d4 100644
--- a/_sources/library-user-guide/upgrading.md.txt
+++ b/_sources/library-user-guide/upgrading.md.txt
@@ -38,6 +38,21 @@ has been removed, so you will need to remove all references 
to it.
 `ScalarFunctionArgs` now contains a field called `arg_fields`. You can use this
 to access the metadata associated with the columnar values during invocation.
 
+To upgrade user defined aggregate functions, there is now a function
+`return_field` that will allow you to specify both metadata and nullability of
+your function. You are not required to implement this if you do not need to
+handle metatdata.
+
+The largest change to aggregate functions happens in the accumulator arguments.
+Both the `AccumulatorArgs` and `StateFieldsArgs` now contain `Field` rather
+than `DataType`.
+
+To upgrade window functions, `ExpressionArgs` now contains input fields instead
+of input data types. When setting these fields, the name of the field is
+not important since this gets overwritten during the planning stage. All you
+should need to do is wrap your existing data types in fields with nullability
+set depending on your use case.
+
 ### Physical Expression return `Field`
 
 To support the changes to user defined functions processing metadata, the
diff --git a/library-user-guide/upgrading.html 
b/library-user-guide/upgrading.html
index 6a5b74f598..03e5253f83 100644
--- a/library-user-guide/upgrading.html
+++ b/library-user-guide/upgrading.html
@@ -834,6 +834,18 @@ field is not important. It will be overwritten during 
planning. <code class="doc
 has been removed, so you will need to remove all references to it.</p>
 <p><code class="docutils literal notranslate"><span 
class="pre">ScalarFunctionArgs</span></code> now contains a field called <code 
class="docutils literal notranslate"><span 
class="pre">arg_fields</span></code>. You can use this
 to access the metadata associated with the columnar values during 
invocation.</p>
+<p>To upgrade user defined aggregate functions, there is now a function
+<code class="docutils literal notranslate"><span 
class="pre">return_field</span></code> that will allow you to specify both 
metadata and nullability of
+your function. You are not required to implement this if you do not need to
+handle metatdata.</p>
+<p>The largest change to aggregate functions happens in the accumulator 
arguments.
+Both the <code class="docutils literal notranslate"><span 
class="pre">AccumulatorArgs</span></code> and <code class="docutils literal 
notranslate"><span class="pre">StateFieldsArgs</span></code> now contain <code 
class="docutils literal notranslate"><span class="pre">Field</span></code> 
rather
+than <code class="docutils literal notranslate"><span 
class="pre">DataType</span></code>.</p>
+<p>To upgrade window functions, <code class="docutils literal 
notranslate"><span class="pre">ExpressionArgs</span></code> now contains input 
fields instead
+of input data types. When setting these fields, the name of the field is
+not important since this gets overwritten during the planning stage. All you
+should need to do is wrap your existing data types in fields with nullability
+set depending on your use case.</p>
 </section>
 <section id="physical-expression-return-field">
 <h3>Physical Expression return <code class="docutils literal 
notranslate"><span class="pre">Field</span></code><a class="headerlink" 
href="#physical-expression-return-field" title="Link to this heading">ΒΆ</a></h3>
diff --git a/searchindex.js b/searchindex.js
index 52633b7d30..c7952e58cb 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[54,"op-neq"]],"!~":[[54,"op-re-not-match"]],"!~*":[[54,"op-re-not-match-i"]],"!~~":[[54,"id19"]],"!~~*":[[54,"id20"]],"#":[[54,"op-bit-xor"]],"%":[[54,"op-modulo"]],"&":[[54,"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"]],"*":[[54,"op-multiply"]],"+":[[54,"op-plus"]],"-":[[54,"op-minus"]],"/":[[54,"op-divide"]],"2022
 Q2":[[10,"q2"]] [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[54,"op-neq"]],"!~":[[54,"op-re-not-match"]],"!~*":[[54,"op-re-not-match-i"]],"!~~":[[54,"id19"]],"!~~*":[[54,"id20"]],"#":[[54,"op-bit-xor"]],"%":[[54,"op-modulo"]],"&":[[54,"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"]],"*":[[54,"op-multiply"]],"+":[[54,"op-plus"]],"-":[[54,"op-minus"]],"/":[[54,"op-divide"]],"2022
 Q2":[[10,"q2"]] [...]
\ 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