This is an automated email from the ASF dual-hosted git repository.
github-merge-queue[bot] pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/datafusion.git
The following commit(s) were added to refs/heads/main by this push:
new 1f2b020888 docs: updating arrays_zip output field naming (#22133)
1f2b020888 is described below
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]
