MetricSign
EN|NLRequest Access
Medium severityconfiguration

Power BI Refresh Error:
DF-Executor-IncorrectLinkedServiceConfiguration

What does this error mean?

A linked service used by the data flow source or sink has an incorrect configuration — a required property is missing, has the wrong value, or the linked service type does not match what the transformation expects. The data flow executor detected the misconfiguration before establishing the connection.

Common causes

  • 1A required linked service property (server name, account name, database name) is empty or has an incorrect value
  • 2The linked service type does not match the data store type configured in the source or sink transformation
  • 3A Key Vault reference in the linked service credentials points to a secret that does not exist or the Key Vault linked service is itself misconfigured
  • 4The linked service was recently modified (server renamed, database moved) and the new configuration has an error that the 'Test connection' would catch

How to fix it

  1. 1Open the linked service used by the failing source or sink transformation and click 'Test connection' to validate the configuration.
  2. 2Check that the connection type matches the actual data store — for example, a Blob Storage linked service cannot be used with a SQL source transformation.
  3. 3Verify that all required fields (server, database, container, account name) are correctly filled in the linked service settings.
  4. 4If using Key Vault for secrets, confirm the Key Vault linked service is also correctly configured and the secret name matches.
  5. 5Recreate the linked service if the configuration appears correct but the error persists — stale linked service metadata can cause this error.

Frequently asked questions

How do I test a linked service configuration without running the full pipeline?

Open the linked service in ADF Studio (Manage > Linked services) and click 'Test connection' to validate settings without running any activity. If the test fails, the error message specifies which property is invalid.

Why would a linked service that worked before suddenly show IncorrectLinkedServiceConfiguration?

Common causes: server or account renamed, Key Vault secret rotated or expired, or an env var in a parameterized linked service now resolves differently. Check recent changes to the linked service and connected resources.

Does this affect all pipelines using the same linked service?

Yes — a misconfigured linked service affects every pipeline that uses it. In ADF Studio, open the linked service and check the 'Related' section to see all dependent pipelines.

Will downstream Power BI datasets be affected?

Yes — the pipeline fails and no data reaches the target. Dependent datasets serve stale figures.

Official documentation: https://learn.microsoft.com/en-us/azure/data-factory/data-flow-troubleshoot-guide

Other configuration errors