Troubleshoot the file system connector in Azure Data Factory and Azure Synapse

APPLIES TO: Azure Data Factory Azure Synapse Analytics

Tip

Data Factory in Microsoft Fabric is the next generation of Azure Data Factory, with a simpler architecture, built-in AI, and new features. If you're new to data integration, start with Fabric Data Factory. Existing ADF workloads can upgrade to Fabric to access new capabilities across data science, real-time analytics, and reporting.

• Start a Fabric free trial.
• Upgrade from Azure Data Factory to Data Factory in Microsoft Fabric

This article provides suggestions to troubleshoot common problems with the file system connector in Azure Data Factory and Azure Synapse.

Error code: AccessToOnPremFileSystemDenied

• Message: Access to '%path;' is not allowed.

• Cause: Copying files from local machine isn't supported under Azure Integration Runtime. For Self-hosted Integration Runtime (versions >= 5.22.8297.1), Azure Data Factory is introducing a new security control to allow or disallow local SHIR file system access through the connector. It's disabled by default.

• Recommendation: Using command line from Set up an existing self-hosted IR via local PowerShell, you could allow or disallow local SHIR file system access.

Related content

For more troubleshooting help, try these resources:

• Connector troubleshooting guide
• Data Factory blog
• Data Factory feature requests
• Azure videos
• Microsoft Q&A page
• Stack Overflow forum for Data Factory
• X information about Data Factory