This is an automated email from the ASF dual-hosted git repository.

github-merge-queue[bot] pushed a commit to branch 
gh-readonly-queue/main/pr-22133-937dfdad748589aa7372848bb2a57ef04109b931
in repository https://gitbox.apache.org/repos/asf/datafusion.git

commit 1f2b020888e0f96ac9e9825e4267690a058819b8
Author: Tim Saucer <[email protected]>
AuthorDate: Wed May 13 07:24:09 2026 -0400

    docs: updating arrays_zip output field naming (#22133)
    
    ## Which issue does this PR close?
    
    No issue opened, but discovered regression in unit tests in
    datafusion-python during upgrading to `main`
    
    ## Rationale for this change
    
    Documentation only to let users know that they will need to update their
    field naming expectations. The change happened in
    https://github.com/apache/datafusion/pull/20886
    
    ## What changes are included in this PR?
    
    Upgrade guide document.
    
    ## Are these changes tested?
    
    N/A
    
    ---------
    
    Co-authored-by: hsiang-c <[email protected]>
    Co-authored-by: Oleks V <[email protected]>
---
 docs/source/library-user-guide/upgrading/54.0.0.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/source/library-user-guide/upgrading/54.0.0.md 
b/docs/source/library-user-guide/upgrading/54.0.0.md
index 7911bbdc50..0ba3e4eb3e 100644
--- a/docs/source/library-user-guide/upgrading/54.0.0.md
+++ b/docs/source/library-user-guide/upgrading/54.0.0.md
@@ -557,6 +557,20 @@ are stored as `Arc<T>` so the map remains cheap to clone.
 - Custom `ParquetFileReaderFactory` implementations or other consumers that
   read `partitioned_file.extensions` and downcast manually.
 
+### `arrays_zip` struct field names changed
+
+The `arrays_zip` (and its alias `list_zip`) scalar function now names its
+output struct fields `"1"`, `"2"`, ..., `"n"` (1-indexed, matching DuckDB and
+Spark) instead of `c0`, `c1`, ..., `c{n-1}`.
+
+**Who is affected:**
+
+- Queries or downstream code that references the output struct fields by name
+  (e.g. `arrays_zip(a, b)[1]['c0']`). Update field accessors to `'1'`, `'2'`,
+  etc. (e.g. `arrays_zip(a, b)[1]['1']`).
+
+See [PR #20886](https://github.com/apache/datafusion/pull/20886) for details.
+
 ### `Box<C>` and `Arc<C>` `TreeNodeContainer` impls now require `C: Default`
 
 The generic `TreeNodeContainer` implementations for `Box<C>` and `Arc<C>` now


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to