KNIME Documentation

Migrate deprecated database workflows ​

Use the Workflow Migration Tool to convert workflows that use deprecated database nodes to their current equivalents. The tool creates a migrated copy without modifying the original workflow.

Before you begin ​

  • Open the workflow you want to migrate in KNIME Analytics Platform.
  • Re-register any JDBC drivers you previously used. Drivers registered for the deprecated framework must be re-registered for the current framework. See Register a JDBC driver.

Migrate a workflow ​

Run the Workflow Migration Tool to convert deprecated database nodes to their current equivalents.

  1. Open the workflow that contains deprecated database nodes. A banner appears at the top of the workflow editor.
  2. Click Migrate workflow… to open the migration wizard.
  3. Confirm the workflow to migrate and set a name for the migrated copy. By default, the name appends (migrated) to the original.
  4. Click Next. The wizard analyses the workflow and lists all deprecated nodes with available migration rules and their replacements. Review any highlighted issues.
  5. Click Next to perform the migration.
  6. Review the migration report. Warnings and issues are highlighted. Save the report as HTML if needed.
  7. Click Finish. The migrated workflow opens with deprecated nodes replaced by their current counterparts.

The original workflow remains unchanged throughout the process.

Disable the migration banner ​

To stop KNIME from prompting you to migrate a specific workflow:

  1. Click Disable this message in the migration banner.
  2. In Preferences → Databases, clear Offer the migration of workflows that contain deprecated database nodes.
  3. Click Apply and Close.

To re-enable the prompt, return to Preferences → Databases and select the checkbox.

Next steps ​