Edit

Share via


Assess your Pipelines for Migration to Fabric Data Factory

Use the built-in upgrade assessment to quickly check pipeline readiness and identify activity compatibility issues before migrating to Fabric.

Assess your Azure Data Factory pipelines for migration

In Azure Data Factory, open the factory you'd like to assess for migration. On the authoring canvas toolbar, select Start assessment (preview).

Note

If you are unable to see the banner where the "Start assessment" button is located, try clearing your browser cache and cookies. This often resolves display issues.

Screenshot showing how to run the Azure Data Factory Assessment tool.

This opens a side pane showing a preview of the list of pipelines in your data factory with expandable list of activities within the pipeline.

Screenshot showing how to view the Azure Data Factory migration assessment in the side pane.

Assess your Azure Synapse Analytics pipelines for migration

In Azure Synapse Analytics, open the pipelines you'd like to assess for migration. On the authoring canvas toolbar, select Start assessment (preview).

Screenshot showing how to run the Assessment tool in Synapse Analytics Workspace.

This opens a side pane showing a preview of the list of pipelines in your Synapse workspace with expandable list of activities within the pipeline.

Screenshot showing how to view the Synapse Pipelines assessment in the side pane.

You can export both ADF and Synapse assessment results as a .csv file, which lists pipeline names, activity-level statuses, and compatibility notes.

Some results point to features that are still in progress or out of scope. Use the results to prioritize the fixes and to decide whether to migrate now using existing tools such as PowerShell upgrade module or wait for upcoming support.

Understand the results

You’ll see one of the four results for each pipeline (and summarized at the factory level):

Status Meaning
Ready Good to go for migration
Needs review Requires changes before migration eg: Global parameters
Coming soon Support in progress; migrate later
Not compatible No equivalent in Fabric; refactor required

Drill into details

In the assessment side pane, expand each pipeline to see:

  • Activity‑level status (which activities block migration).
  • A summary of Ready/Needs review/Not compatible counts across pipelines.

Diagram showing a drill-down of the assessment details.

Use this list to build your to‑do plan (what to fix, what to defer, and what to replace).

Next steps

When your assessment shows acceptable readiness:

  1. Use migration flow when available in the future.
  2. Use PowerShell upgrade tool for early migration.
  3. Refer to planning guides for best practices.

FAQ

Does the assessment change my factory?

Answer: No. It only scans your configuration and lists findings in the side pane. You can safely run it to understand impact before migration.

Why do I see Coming soon?

Answer: It means the product team is actively adding support for those items. If they’re critical to your pipeline, see if you could use PowerShell upgrade tool or plan to migrate later or redesign the affected steps.

What if only one activity is Not compatible?

Answer: You can still migrate the pipeline after you refactor or replace that activity. The assessment helps you identify exactly where to focus.

Can I rerun the assessment after making changes?

Answer: Yes, you can rerun anytime to validate updates.

Compare Azure Data Factory and Fabric Data Factory

Migration best practices

Connector parity