Skip to content

Apache DataFusion SQL Query Engine

docs: updating arrays_zip output field naming (#22133)

Tim Saucer1f2b020888e0
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