Release Notes -- 2026-04-16¶
Databricks Forge v0.39.5 → v0.40.0
v0.40.0 -- Adaptive Column Budget Engine¶
New Features¶
Always-on adaptive column budgeting¶
Replaces the manual Large Schema Mode toggle with a two-layer adaptive engine that is always active:
- Fill-then-trim token allocation -- Dynamically computes per-table column limits within the available token budget. Narrow tables keep all columns; wide tables share surplus proportionally. Every table retains at least 10 columns.
- LLM-based column ranking -- When trimming is needed, a single lightweight classification call ranks columns by business relevance (goals, priorities, measurable outcomes, join keys) instead of relying solely on heuristic scoring. Falls back silently to the heuristic scorer on any LLM failure.
Zero cost when all columns fit (most batches). Typically 0-3 lightweight LLM calls per run.
Auto-detected wide schema fetch limits¶
Tables with 100+ columns are automatically detected at metadata extraction time. When present, fetch-level memory limits (200K column rows, 18 sample columns) are applied without any manual toggle.
Improvements¶
- Uncapped batch estimation -- Token-aware batching now uses full column counts for realistic sizing, preventing batch overstuffing that forced aggressive trimming.
- Structured trim logging -- Detailed logs when the adaptive engine trims columns, including per-table before/after counts, LLM ranking status, and available token budget. User-facing run message reports trimming activity.
- Removed
largeSchemaModetoggle -- The settings UI toggle, pipeline config field, and all related plumbing have been removed across ~15 files. Old serialised runs withlargeSchemaMode: trueare harmlessly ignored.
v0.39.5 -- Large Schema Mode global scope fix¶
Bug Fixes¶
- Large Schema Mode now applies to standalone estate scans -- Previously the setting only affected pipeline run steps (metadata extraction, use case generation, SQL generation) but was completely ignored by standalone estate scans. The column row cap is now enforced in both code paths.
- Serialization gap in
generationOptions--largeSchemaModeandbusinessValueEnabledwere not persisted in the run'sgenerationOptionsJSON, causing the flags to default tofalsewhen a run was re-loaded from the database. Both flags are now serialized correctly.
Improvements¶
- "Schema Handling" settings card -- The Large Schema Mode toggle has been extracted from the "Estate Scan" settings card into its own "Schema Handling" card, making it clear the setting applies globally to both pipeline runs and estate scans.
- Corrected UI description -- The toggle description previously stated "max 15 per table" but the actual budget constant is 25 columns per table. The UI and code comments are now aligned.
All Commits¶
| Hash | Summary |
|---|---|
3ff99f3 |
feat: replace Large Schema Mode toggle with always-on adaptive column budget engine |
0279e96 |
fix: make Large Schema Mode apply to both pipeline runs and estate scans |