alamb opened a new issue, #19087: URL: https://github.com/apache/datafusion/issues/19087
### Is your feature request related to a problem or challenge? in https://github.com/apache/datafusion/pull/17843, @geoffreyclaude added the RelationPlanner that, along with the existing ExprPlanner and TypePlanners allows Datafusion users to extend SQL in many powerful ways https://github.com/apache/datafusion/pull/17843 has several great examples, but they may not be all that discoverable (easy for others to find) ### Describe the solution you'd like I think it would be even better to add a page to the documentation with a high level overview: ### Describe alternatives you've considered Add a page to the user guide https://datafusion.apache.org/library-user-guide with high level guidance of how to extend SQL 1. Explain the usecase for extending SQL syntax (that different systems have different SQL needs and instead of forcing one SQL dialect, DataFusion allows you to extend your own) 2. Enumerate the extension points and give examples - [`ExprPlanner`](https://docs.rs/datafusion/latest/datafusion/logical_expr/planner/trait.ExprPlanner.html): Allows one to intercept arbitrary expressions / operators (e.g. can plan the `:` operator for variant) - [`TypePlanner`](https://docs.rs/datafusion/latest/datafusion/logical_expr/planner/trait.TypePlanner.html): Allow supporting arbitrary types - `RelationPlanner` (added in [#17843](https://github.com/apache/datafusion/pull/17843)) : Allow planning items in the FROM clause, such as `PIVOT`/`UNPIVOT`, `TABLESAMPLE`, etc ### Additional context I also suggest a blog for this content as well - https://github.com/apache/datafusion/issues/16756 I think there would be substantial overlap with the content of the user guide page (which is fine -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
