Connectors and Connections > Data Ingestion and Replication connection properties > Microsoft Fabric Lakehouse connection properties
  

Microsoft Fabric Lakehouse connection properties

Create a Microsoft Fabric Lakehouse connection to securely read from or write to Microsoft Fabric Lakehouse.

Prerequisites

Before you configure the connection properties, make sure to complete the following prerequisites:
  1. 1Power BI prerequisites:
    1. aCreate a workspace, if it does not already exist.
    2. bCreate a lakehouse in the workspace. Make sure you have the required admin privileges to create a lakehouse.
    For more information about creating a workspace and lakehouse, see Creating a workspace and lakehouse.
  2. 2Microsoft Azure portal prerequisites:
    1. aRegister your application in Microsoft Entra ID and generate client ID, tenant ID, and client secret.
      2. The connector does not require any API permissions assigned to your application. Additionally, you can remove any API permissions that are assigned to the application.
    2. bCreate a security group with assigned owners or members in Microsoft Entra ID.
      3. For more information about creating a security group, see Creating a security group.
  3. 3To allow Microsoft Entra app to use the Power BI APIs, enable the Power BI service admin settings, and then add the Microsoft Entra app to the workspace in Power BI.
    4. Note:
    The Manage access pane in the Microsoft Entra app allows you to add roles based on the required capabilities. The pane displays admin, member, contributor, and viewer roles. The maximum number of capabilities are associated with the admin role. However, to access Microsoft Fabric OneLake and perform read and write operations, you need at least the Contributor role.
    For more information about enabling access in the Power BI admin portal and adding the Microsoft Entra app to the workspace, see Enabling access in the Power BI portal.

Connect to Microsoft Fabric Lakehouse

Let's configure the Microsoft Fabric Lakehouse connection properties to connect to Microsoft Fabric Lakehouse.

Before you begin

Before you get started, you'll need to keep the client ID, client secret, tenant ID, workspace, and database details handy.
Check out Prerequisites to make sure that the setup is complete and all the prerequisites are in place before you configure a connection.

Connection details

The following table describes the basic connection properties:
Property
Description
Connection Name
Name of the connection.
Each connection name must be unique within the organization. Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -,
Maximum length is 255 characters.
Description
Description of the connection. Maximum length is 4000 characters.
Use Secret Vault
Stores sensitive credentials for this connection in the secrets manager that is configured for your organization.
This property appears only if secrets manager is set up for your organization.
When you enable the secret vault in the connection, you can select the credentials that the Secure Agent retrieves from the secrets manager. If you don't enable this option, the credentials are stored in the repository or on a local Secure Agent, depending on how your organization is configured.
Note:
If you’re using this connection to apply data access policies through pushdown or proxy services, you cannot use the Secret Vault configuration option.
For information about how to configure and use a secrets manager, see Secrets manager configuration.
Runtime Environment
The name of the runtime environment where you want to run tasks.
Select a Secure Agent, Hosted Agent, serverless, or elastic runtime environment.
SQL Connection String
The SQL connection string to connect to Microsoft Fabric Lakehouse.
Specify the connection string in the following format:
<Server>.lakehouse.pbidedicated.windows.net
Client ID
The application ID or client ID of your application registered in Azure Active Directory for service principal authentication.
Client Secret
The client secret for your application registered in Azure Active Directory.
Tenant ID
The tenant ID of your application registered in Azure Active Directory.
Workspace
The name of the workspace in Microsoft Fabric Lakehouse that you want to connect.
Database
The name of the database in Microsoft Fabric Lakehouse that you want to connect.

Advanced settings

The following table describes the advanced connection properties:
Property
Description
Lakehouse schemas
Indicates if the schemas are enabled for Microsoft Fabric Lakehouse.
Schema Name
The name of the schema in Microsoft Fabric Data Lakehouse where the tables are stored.