Microsoft Fabric Data Lakehouse Sources > Before you begin > Create a connection
  

Create a connection

Before you configure the Microsoft Fabric Data Lakehouse catalog source, create a connection object in Administrator.
Use the Microsoft Entra ID service principal, formerly known as Azure Active Directory, to create a Microsoft Fabric Data Lakehouse connection in Administrator.
To use an external secrets manager to connect to the source system, use one of the following authentication tools:
    1In Administrator, select Connections.
    2Click Add Connection.
    3Search for and select Microsoft Fabric Data Lakehouse and then click Next.
    4Enter properties specific to the Microsoft Fabric Data Lakehouse connection:
    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 which 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, or serverless 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.
    5Click Test to test your connection to the source system.
    6Click Save.