apache / apache/datafusion-python
Expose SessionContext.add_analyzer_rule for Python-defined analyzer rules
- Dominant language
- Python
- Stars
- 604
- Forks
- 174
- Avg merge
- 1d 7h
- Merged PRs (30d)
- 4
Description
## Background
`SessionContext::add_analyzer_rule` registers an `Arc` that runs during plan analysis (the pre-optimization pass that resolves names, applies type coercion, etc.). The Python bindings do not expose this method.
## Upstream signature
```rust
pub fn add_analyzer_rule(&self, analyzer_rule: Arc)
```
## User value
Lets users intercept and transform a logical plan immediately after analysis, before the main optimizer runs. Useful for custom semantic validation, injecting domain-specific defaults, or rewriting unresolved references against an external catalog.
## Why deferred
Blocked upstream, same root cause as #1574 ([add_optimizer_rule](https://github.com/apache/datafusion-python/issues/1574)): no FFI bridge exists for the logical `AnalyzerRule` trait, and a Python-only adapter can observe but not meaningfully transform `LogicalPlan` nodes because there are no Python constructors for the variants. Tracked here; revisit when upstream lands an `FFI_AnalyzerRule`.
Contributor guide
No contributing guide indexed for this repository
Research direction
Start by reviewing SessionContext::add_analyzer_rule, issue #1574, and the upstream work for an FFI_AnalyzerRule bridge. The task is ready when Python bindings can expose analyzer rules that meaningfully transform logical plans, including the required LogicalPlan support.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python, rust
- Domain
- api, backend-api-design
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100