topic Re: Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline in Data Engineering

Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline

Rakuka — Thu, 23 Apr 2026 09:33:36 GMT

Hi Fabric team,

Good morning

I am facing an issue while trying to use an on-premises SQL Server source in Microsoft Fabric through an on-premises data gateway.

Environment

Fabric trial capacity
Source: local/on-prem SQL Server hosted on my laptop
SQL Server test connection in SSMS works successfully using localhost,1433
Database: OBT
Gateway name: OneBridge
Authentication used in Fabric connection: Basic (sa)
What I configured

Created an on-premises SQL Server connection in Manage Connections and Gateways
Connection name: OBT_SQL_Local_1433_OneBridge
Server: localhost,1433
Database: OBT
Gateway cluster: OneBridge
Observed behavior

The gateway OneBridge is visible and online under On-premises data gateways
Gateway network diagnostics passed successfully, including Fabric-related endpoint checks
The SQL Server connection row gets created and shows Gateway cluster name = OneBridge
However, the connection does not become properly usable:
it remains non-clickable / not fully online
it does not appear correctly in Copy activity source selection
Copy activity shows no usable results for the saved connection
In earlier attempts, I also saw an error similar to:
undefined not found in linked-service-registry
Troubleshooting already completed

Verified SQL Server connectivity in SSMS using localhost,1433
Verified target database OBT is accessible
Recreated the connection multiple times
Deleted faulty/old test connections
Tested across different workspaces
Tested in different browser sessions
Verified gateway is online
Ran gateway diagnostics and network port tests successfully
Expected behavior
The saved on-prem SQL Server connection should become fully usable and appear in Fabric Copy activity / pipeline source selection.

Actual behavior
The connection is only partially created and cannot be used in pipeline Copy activity.

Please investigate whether this is a Fabric connection registration, linked service registry, or gateway integration issue on the service side.

I can provide screenshots of:

Manage Connections and Gateways
Gateway online status
Gateway diagnostics results
SSMS successful connection using localhost,1433
Copy activity source picker not showing the saved connection.
Thank you in advance
Rakuka

Re: Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline

Lodha_Jaydeep — Thu, 23 Apr 2026 10:54:41 GMT

Hi @Rakuka,

Thanks for reaching to community, will happy to assist. Localhost on the gateway configuration would not be work I think. Below is the reasons and fixes you can try.

Root Cause

localhost doesn't work with the on-premises data gateway. The gateway runs as a Windows service under a different identity and cannot resolve localhost the same way SSMS does on your machine. This is why the connection appears created and online but never becomes fully usable.

Fix - Replace localhost with Machine Name (Do This First)

Instead of localhost,1433 use your actual machine hostname:

Find your machine name:

   Run → cmd → type: hostname

In Manage Connections and Gateways, delete the current OBT_SQL_Local_1433_OneBridge connection
Recreate it with:
- Server: YOUR-PC-NAME,1433 or YOUR-PC-NAME\INSTANCENAME
- Database: OBT
- Gateway: OneBridge
- Authentication: Basic (sa)\Any if you create new.

Probably this will fix your issue. Please have a look at the below screenshots for the same.

Note: New connection with the machine name should be tested with the SSMS first if you are able to connect. Also, as you are able to create gteway connection so, I am assuming that Remote/TCP connections are allowed for your SQL server.

Re: Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline

Lodha_Jaydeep — Thu, 23 Apr 2026 10:54:42 GMT

Hi @Rakuka,

Thanks for reaching to community, will happy to assist. Localhost on the gateway configuration would not be work I think. Below is the reasons and fixes you can try.

Root Cause

Fix - Replace localhost with Machine Name (Do This First)

Instead of localhost,1433 use your actual machine hostname:

Find your machine name:

   Run → cmd → type: hostname

In Manage Connections and Gateways, delete the current OBT_SQL_Local_1433_OneBridge connection
Recreate it with:
- Server: YOUR-PC-NAME,1433 or YOUR-PC-NAME\INSTANCENAME
- Database: OBT
- Gateway: OneBridge
- Authentication: Basic (sa)\Any if you create new.

Probably this will fix your issue. Please have a look at the below screenshots for the same.

Re: Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline

Rakuka — Thu, 23 Apr 2026 11:35:54 GMT

Hi Jaydeep,

Thank you for your suggestion.

We had already tested these paths during troubleshooting. Port 1433 is confirmed to be working, and SQL Server is successfully reachable from SSMS using the same machine where the gateway is installed. We also tested multiple server name variations, including localhost,1433, host/machine-name based formats, and named-instance style formats.

In addition, we verified that the OneBridge gateway is online, the gateway network diagnostics completed successfully (34/34 tests passed), and the Fabric SQL connection is bound to the gateway cluster. We also tested in different workspaces and browsers, deleted and recreated the faulty connections, and re-created a clean on-prem SQL Server connection several times.

Despite all of this, the connection still does not become fully usable inside Fabric Copy activity, and we also encountered the errors like error 26 and “undefined not found in linked-service-registry.” Because of that, this now appears to be beyond a basic hostname, port, or TCP configuration issue.

I also doubted that because Fabric trial version is having some inherent features' non-availability.

But when I tried your solution I got error 26 saying "Fabric cannot locate the specified SQL Server instance or database" in source section of the pipeline's copy activity.

Regards

~~~~~~~~~~~~~~~~~~~~

Rakuka

Re: Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline

Lodha_Jaydeep — Thu, 23 Apr 2026 12:14:01 GMT

Hi @Rakuka,

Thanks for getting back to me. I’m also using a Free Trial capacity, and the configuration shown in my screenshots is working as expected.

Before we try the new Server/Machine name in Fabric again, could you confirm if you can successfully connect using that same name within SSMS? This helps us rule out any local connectivity issues.

Regarding the error message 'undefined not found in linked-service-registry,' this actually appears to be a Fabric backend service registration failure rather than a misconfiguration on your end or a network issue.

Since you’ve already attempted to re-configure the gateway multiple times without success, we might want to try a different authentication approach.

could you test using Windows Authentication with your specific username to see if that bypasses the registry error? Be make sure to not skip connection you can get the window Auth user name from the SSMS and password should be used for the log-on to the machine.

I’m happy to keep digging into this with you. If this helps resolve the issue, please consider marking this as the Accepted Solution so it can help other community members. Kudos are always appreciated!

Re: Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline

tayloramy — Thu, 23 Apr 2026 13:26:03 GMT

Hi @Rakuka,

If you open the gateway software and perform the network ports test, what is the result?

Re: Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline

Rakuka — Thu, 23 Apr 2026 13:36:52 GMT

Hi @tayloramy,
Yes, I opened the on-premises data gateway software and ran the Network ports test.
The result was 34/34 tests succeeded. The test also showed success for the Fabric-related endpoint ci.frontend.clouddatahub.net on port 443, and all listed gateway/service bus endpoints were returned as Open/Success. So based on the gateway diagnostics, there does not appear to be a firewall, outbound port, or general gateway network communication issue.
Despite that, the SQL Server connection in Fabric still does not become fully usable in Copy activity.

Re: Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline

Rakuka — Thu, 23 Apr 2026 13:42:18 GMT

Thank you for the follow-up, @Lodha_Jaydeep

Yes, we already completed that validation. Connectivity was tested from SSMS on the same machine where the gateway is installed, and port 1433 is working. Multiple server-name formats were also tested during troubleshooting, including localhost,1433, machine-name based formats, and named-instance style formats. In addition, the OneBridge gateway is online and the gateway Network ports test completed successfully (34/34 passed).

We also agree that the undefined not found in linked-service-registry message looks more like a Fabric backend/service registration issue than a local SQL Server, gateway, or firewall issue. That is consistent with the fact that the problem persists even after repeated reconfiguration, connection recreation, workspace changes, and browser changes.

Windows Authentication was also attempted earlier, in addition to SQL authentication, and neither path made the connection fully usable inside Fabric Copy activity. Based on the full set of checks completed so far, this now appears to be beyond a basic connectivity or authentication configuration issue.

Re: Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline

Rakuka — Fri, 24 Apr 2026 07:38:41 GMT

Hello @Lodha_Jaydeep & @tayloramy,

Yesterday when i contacted Microsoft on this issue, I recieved a reply which is as follows.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Please note that the West India region currently does not support the use of an on-premises data gateway for Data Factory pipelines. As a result, if your Data Factory is deployed in the West India region, you will not see the option to select an on-premises data gateway while creating a pipeline connection.

Additionally, even if a connection is created, it may not appear under the Connections section within pipeline activities.

For more information, kindly refer to the known issues documentation below for your reference.

Microsoft Fabric Known Issues

Please let me know if you have any questions.

Thank you.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

So, which region you guys are using, can you check and let me know please? Is everything working fine at your end?

If possible, can I change my region now or in the next billing cycle (I doubt it's not a paid version)

thank you.

Rakuka

Re: Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline

Lodha_Jaydeep — Fri, 24 Apr 2026 10:29:00 GMT

Hi @Rakuka,

Thank you for the update, I’m glad we have identified the root cause. As we suspected, this is not a configuration error, but rather a limitation where certain trial features are not supported in all regions.

I am currently operating within the Central India region.

Could you please check the Workspace settings for the pipeline and confirm if it is currently assigned to the North India region?

Re: Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline

Rakuka — Fri, 24 Apr 2026 10:49:12 GMT

Hi @Lodha_Jaydeep

Thank you for your follow-up.

I have raised a formal Microsoft support ticket on this issue, and their final response was that the limitation is tied to the tenant/home region, not the individual workspace setting or a local configuration problem. I verified this from About Microsoft Fabric in the tenant settings, and my Fabric home region is West India.

Microsoft confirmed that West India currently does not support the use of an on-premises data gateway for Fabric Data Factory pipelines / Copy activity. They also mentioned that, in this scenario, even if a connection is created successfully, it may still not appear properly under pipeline connections or Copy activity source selection. That matches exactly what I observed during troubleshooting.

So based on the Microsoft ticket outcome, this appears to be a regional product limitation rather than an issue with my SQL Server, gateway, authentication, browser, workspace, or connection setup. I had already validated SQL Server access in SSMS, confirmed port 1433 was working, verified that the gateway was online, and confirmed the gateway network diagnostics passed successfully.

Now I am planning to change the region possibly. Thanks.

Re: Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline

Lodha_Jaydeep — Fri, 24 Apr 2026 10:58:24 GMT

Hi @Rakuka,
Thank you for confirming.

You can verify the hosting region directly within the Workspace Settings, ideally these should align with your capacity settings.

I recommend migrating your workspace to the Central India region, if your organization's policy allows, to ensure full access to the features we discussed. Once you have finalized the new configuration, please let me know if the issue persists or if any further questions arise.

Re: Issue while trying to use an on-premises SQL Server source in Microsoft Fabric pipeline

tayloramy — Fri, 24 Apr 2026 14:46:08 GMT

Hi @Rakuka,

That is really unfortunate that it is not available in your region.
Moving Fabric items between regions is not trivial, you basically need to delete everything and start again, there is no automatic migration process...

The Power BI items can be exported and re-imported into the new region, however anything Fabric related like halekhouses, pipelines, dataflows, etc. cannot be.

Here's the documentation:

Workspaces with non-Power BI Fabric items can't be moved between regions. You must delete all the non-Power BI Fabric items before moving a workspace to a different region. Once the workspace is moved, it can take up to 30 minutes before non-Power BI items can be created.

https://learn.microsoft.com/en-us/fabric/admin/service-admin-premium-multi-geo?tabs=power-bi-premium

This puts you in a tough spot, and I don't have a good answer for how you can proceed.