Prerequisites
- Access to a Microsoft Fabric Lakehouse with an SQL analytics endpoint enabled. For more information, read Create a Lakehouse in Microsoft Fabric.
- Appropriate permissions in Fabric Lakehouse for the identity you plan to use. For more information, read Workspace roles in Lakehouse.
- Tenant and Workspace settings configured to support Microsoft Entra authentication. For more information, read Microsoft Entra authentication as an alternative to SQL authentication.
Finding your SQL analytics endpoint connection string
To locate the connection string for your SQL analytics endpoint:- Go to the Azure portal.
- Navigate to your Fabric Lakehouse resource.
- Select the ellipses
..., and click Copy connection string.
- Under Settings, select Connection strings.
- Copy the SQL analytics endpoint connection string.
Configuring the Microsoft SQL Server Load component
To connect to a Fabric Lakehouse SQL analytics endpoint using the Microsoft SQL Server Load component, follow these steps:- In the Connect section, open the Authentication Type drop-down, and select Username & Password.
-
To populate the Username and Password fields, choose one of the following authentication methods and configure the properties as described below:
Service Principal authentication (recommended for automated processes)
- Username: The application (client) ID of your Azure app registration.
- Password: The client secret for the Azure app registration.
- Connection Options:
- Click the configuration button next to this property to open the Connection Options dialog.
- From the Parameter drop-down, select “authentication”, and enter
ActiveDirectoryServicePrincipalin the Value field. - Add another parameter, select “selectMethod”, and enter
directin the Value field.
- Username: The user principal name (UPN) of your Fabric account. This is usually in email format.
- Password: The password for your Fabric account.
- Connection Options:
- Click the configuration button next to this property to open the Connection Options dialog.
- From the Parameter drop-down, select “authentication”, and enter
ActiveDirectoryPasswordin the Value field. - Add another parameter, select “selectMethod”, and enter
directin the Value field.
-
In the Connection URL property, enter the following:
This string has been obtained by following the steps in Finding your SQL analytics endpoint connection string.
- Configure other properties as required. For more information, read Microsoft SQL Server Load component.

