Databases & connectors

When to use the gateway troubleshooting guides

A workflow can be converted correctly and still fail in the customer tenant if the gateway, connector, driver, or credentials are not ready. Use the gateway guides before import when the analysis identifies on-premises data access or connector setup risk.

5 min readUpdated May 22, 2026gatewayconnectorsimport
Quick answer
In shortUse Flow Migrator's gateway guides before importing flows that depend on on-premises SQL Server, MySQL, PostgreSQL, Oracle, SharePoint, or file-system data.
Most likely causeUse the gateway guides when a workflow uses SQL Server, MySQL, PostgreSQL, Oracle, SharePoint on-premises, file system, or any other local/on-premises data source. These connectors may require the on-premises data gateway, local drivers, firewall access, and a service account with the correct permissions.
What to do nextConfirm the connector family first, then test the target connection before you rely on the exported flow.

When the guides matter

Use the gateway guides when a workflow uses SQL Server, MySQL, PostgreSQL, Oracle, SharePoint on-premises, file system, or any other local/on-premises data source. These connectors may require the on-premises data gateway, local drivers, firewall access, and a service account with the correct permissions.

The Analyze report may flag premium/gateway-sensitive connectors. The gateway guide is the next step for validating the environment before importing or testing the generated flow.

What to check first

  • Confirm where the gateway is installed and which tenant it is registered to.
  • Confirm the gateway machine can resolve and reach the target server name or IP address.
  • Confirm the correct driver or client library is installed for the connector family.
  • Confirm the account can authenticate from the gateway machine, not just from a developer desktop.
  • Confirm the Power Platform environment and connection reference use the intended gateway.

Where to go next

Open the Gateway guides section from the site navigation and choose the connector family. Each guide includes fast checks, command-line diagnostics, common error explanations, and validation steps for the specific source.

/gateway-guides

Related articles

Keep reading the next most relevant guides for this workflow pattern.