What causes UserErrorDataFactoryIRNotFound?

The self-hosted integration runtime (SHIR) was deleted from the ADF instance or renamed. A pipeline was copied from another ADF instance but the IR name from the source does not exist in the target. The IR was removed during an infrastructure cleanup and the linked service was not updated. ARM template or Bicep deployment created the pipeline but did not create the matching IR

How do I fix UserErrorDataFactoryIRNotFound?

In the ADF portal, go to Manage → Integration Runtimes and verify that the referenced IR name exists.. If the IR was deleted, recreate it and re-register the SHIR software on the host machine if it was self-hosted.. Update all linked services that referenced the old IR name to point to the new or correct IR.. If the pipeline was migrated from another factory, check all linked service IR references before the first run.. Validate ARM or Bicep templates to ensure the IR resource is deployed before pipelines that depend on it.

High severityinfrastructure

Power BI Refresh Error:
UserErrorDataFactoryIRNotFound

What does this error mean?

ADF cannot locate the integration runtime referenced by a linked service or activity. The IR may have been deleted, renamed, or not yet registered in this data factory.

Common causes

1The self-hosted integration runtime (SHIR) was deleted from the ADF instance or renamed
2A pipeline was copied from another ADF instance but the IR name from the source does not exist in the target
3The IR was removed during an infrastructure cleanup and the linked service was not updated
4ARM template or Bicep deployment created the pipeline but did not create the matching IR

How to fix it

1In the ADF portal, go to Manage → Integration Runtimes and verify that the referenced IR name exists.
2If the IR was deleted, recreate it and re-register the SHIR software on the host machine if it was self-hosted.
3Update all linked services that referenced the old IR name to point to the new or correct IR.
4If the pipeline was migrated from another factory, check all linked service IR references before the first run.
5Validate ARM or Bicep templates to ensure the IR resource is deployed before pipelines that depend on it.

Frequently asked questions

Can I use the AutoResolve IR instead of a self-hosted one?

AutoResolve IR works for cloud-to-cloud connections. If your source is on-premises or in a private network, you need a self-hosted IR. Check whether the data source is accessible from the Azure cloud.

Official documentation: azure-data-factory