Jailer - Model Migration Tool

The Model Migration Tool

When the underlying data model is updated — for example after running Data Model → Analyze Database to pick up schema changes — existing extraction models may be affected by newly discovered associations. The Model Migration Tool guides you through a review of these new associations so that none of them silently affects your export without a conscious decision.

When does the Model Migration Tool appear?

The tool opens automatically the first time you load an extraction model after its data model has been updated. The trigger is the presence of associations that are new in the data model — i.e. not recorded in the saved extraction model — and that are directly or indirectly connected to one of the extraction model's subject tables.

Associations that are not reachable from any subject table are not shown; they cannot affect the export result and require no decision.

What does the dialog show?

The dialog contains a table with one row per pending association. The columns are:

From	Source table of the association
To	Destination table of the association
Condition	The SQL join condition
Name	The association name as defined in the data model
Checked	Checkbox to confirm that a decision has been made for this association

Clicking a row selects the association in the main editor view, where you can inspect the join condition in full context.

How do I work through the list?

For each association in the list, decide whether it should participate in future exports:

Include without restriction — the association is already enabled by default. Simply tick the Checked checkbox to confirm your decision.
Restrict or exclude — click the row to select the association in the editor, define a restriction condition (or set it to false to exclude entirely), then tick Checked.

Use "Check all" to mark all remaining associations as reviewed in one step, if the defaults are acceptable for all of them.

What if I close the dialog before I am done?

Closing the dialog does not discard your progress. As long as unchecked associations remain, a red "Migration pending" button is shown in the toolbar at the top of the Extraction Model Editor. Click it to reopen the dialog at any time.

The dialog can also be docked as a tab into the Closure View panel using the "Dock" button, so it stays visible while you work in the editor.

Can I save the extraction model before migration is complete?

Yes. Saving an extraction model with pending associations is fully supported. The pending status of each unchecked association is stored in the model file. The next time you open the model, the Migration Tool reappears with the same remaining associations so you can continue from where you left off.

When is the migration finished?

Migration is complete when every association in the list has been checked off. At that point the dialog closes automatically, the "Migration pending" button disappears from the toolbar, and the extraction model is ready for use without any further action.