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

Create a connection

Before you configure the Microsoft Fabric Data Warehouse 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 Warehouse 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 Warehouse and then click Next.
    4Enter properties specific to the Microsoft Fabric Data Warehouse 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.
    SQL Connection String
    The SQL connection string to connect to Microsoft Fabric Data Warehouse.
    Specify the connection string in the following format:
    <Server>.datawarehouse.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 Data Warehouse that you want to connect.
    Database
    The name of the database in Microsoft Fabric Data Warehouse that you want to connect.
    5The following table describes the advanced connection property:
    Property
    Description
    Schema Name
    The name of the schema in Microsoft Fabric Data Warehouse where the tables are stored.
    6Click Test to test your connection to the source system.
    7Click Save.