This is an automated email from the ASF dual-hosted git repository.
alamb 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 36e823f061 Add note in upgrade guide about changes to `Expr::Scalar`
in 48.0.0 (#16360)
36e823f061 is described below
commit 36e823f0618283b77627714a5a1628392f92acc9
Author: Andrew Lamb <and...@nerdnetworks.org>
AuthorDate: Mon Jun 16 07:24:10 2025 -0400
Add note in upgrade guide about changes to `Expr::Scalar` in 48.0.0 (#16360)
---
docs/source/library-user-guide/upgrading.md | 37 ++++++++++++++++++++++++++++-
1 file changed, 36 insertions(+), 1 deletion(-)
diff --git a/docs/source/library-user-guide/upgrading.md
b/docs/source/library-user-guide/upgrading.md
index 67ae418374..4fea730463 100644
--- a/docs/source/library-user-guide/upgrading.md
+++ b/docs/source/library-user-guide/upgrading.md
@@ -21,6 +21,41 @@
## DataFusion `48.0.0`
+### `Expr::Literal` has optional metadata
+
+The [`Expr::Literal`] variant now includes optional metadata, which allows for
+carrying through Arrow field metadata to support extension types and other
uses.
+
+This means code such as
+
+```rust
+# /* comment to avoid running
+match expr {
+...
+ Expr::Literal(scalar) => ...
+...
+}
+# */
+```
+
+Should be updated to:
+
+```rust
+# /* comment to avoid running
+match expr {
+...
+ Expr::Literal(scalar, _metadata) => ...
+...
+}
+# */
+```
+
+Likewise constructing `Expr::Literal` requires metadata as well. The [`lit`]
function
+has not changed and returns an `Expr::Literal` with no metadata.
+
+[`expr::literal`]:
https://docs.rs/datafusion/latest/datafusion/logical_expr/enum.Expr.html#variant.Literal
+[`lit`]: https://docs.rs/datafusion/latest/datafusion/logical_expr/fn.lit.html
+
### `Expr::WindowFunction` is now `Box`ed
`Expr::WindowFunction` is now a `Box<WindowFunction>` instead of a
`WindowFunction` directly.
@@ -200,7 +235,7 @@ working but no one knows due to lack of test coverage).
[api deprecation guidelines]:
https://datafusion.apache.org/contributor-guide/api-health.html#deprecation-guidelines
-### `PartitionedFile` added as an arguement to the `FileOpener` trait
+### `PartitionedFile` added as an argument to the `FileOpener` trait
This is necessary to properly fix filter pushdown for filters that combine
partition
columns and file columns (e.g. `day = username['dob']`).
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@datafusion.apache.org
For additional commands, e-mail: commits-h...@datafusion.apache.org
