Create Databricks Account connection

After configuring Databricks permissions for Data Access, create a Databricks Account connection from an Edge or Collibra Cloud site to the Databricks data source. This connection acts as a bridge between Data Access and your underlying data source.

Prerequisites

  • You have configured the data source permissions for Data Access.
  • You have a global role with the Edge > Manage connections and capabilities global permission, for example, Edge integration engineer.
  • You have an Edge site or a Collibra Cloud site whose status is Healthy and version is 2026.03.21-18 or newer.

Steps

  1. Open the Edge or Collibra Cloud site:
    1. On the main toolbar, click Products icon > Settings.
      The Settings page opens.
    2. In the Edge section, click Sites.
    3. Click the name of the site.
  2. Click Create Connection.
  3. In the Create Connection dialog box, select Databricks Account.
  4. Enter the required information.
    FieldDescription
    NameA unique name for the Databricks Account connection.
    Description

    A brief explanation of the connection's purpose.

    Account ID

    The ID of the Databricks account that is associated with your deployment.

    Databricks platform

    The cloud platform that hosts your Databricks account, such as, AWS, Azure, or GCP.

    Unlike legacy workspace-level connections, the Databricks account connection integrates at the account level to manage access across multiple workspaces simultaneously.

    Authentication type

    The method that is used to authenticate with the Databricks account API. Select one of the following options:

    • Google Cloud Platform: Used if your Databricks account is deployed on Google Cloud. Select this option if you chose the GCP authentication method when configuring Databricks permissions.
    • Microsoft Entra ID: Used when authenticating through an Azure service principal or managed service identity (MSI). Select this option if you chose the Microsoft Entra ID authentication method when configuring Databricks permissions.
    • OAuth: Used when authenticating through a dedicated Databricks service principal. Select this option if you chose the Databricks OAuth authentication method when configuring Databricks permissions.
    • Personal Access Token: Used for development or testing. Select this option if you chose the Personal Access Token authentication method when configuring Databrickspermissions.
  5. If you selected Google Cloud Platform in the Authentication type field, enter the following information.
    FieldDescription
    GCP Credentials

    The JSON-formatted private key file content for your GCP service account

    GCP Service Account

    The email address of the GCP service account to impersonate when authenticating through Application Default Credentials (ADC). This enables keyless, password-free GCP authentication for Databricks.

  6. If you selected Microsoft Entra ID in the Authentication type field, enter the following information.
    FieldDescription
    Use Microsoft Entra ID MSI

    Select the Use Microsoft Entra ID MSI checkbox if you are using managed identities to authenticate directly from an Azure-hosted Edge environment.

    Microsoft Entra ID service principal client ID

    The client ID of your Azure app registration.

    Microsoft Entra ID service principal client secret

    The client secret of your Azure app registration.

    Microsoft Entra ID service principal tenant ID

    The directory (tenant) ID where your Azure app registration is configured.

    Azure Environment

    The target Azure cloud environment containing your deployment (for example, Public, UsGov, China, or Germany).

  7. If you selected OAuth in the Authentication type field, enter the following information.
    FieldDescription
    OAuth Client ID

    The client ID that is generated for your Databricks service principal.

    OAuth Client Secret

    The client secret that is generated for your Databricks service principal.

  8. If you selected Personal Access Token in the Authentication type field, enter the following information.
    FieldDescription
    Token

    The Databricks Personal Access Token (PAT) or Microsoft Entra ID user token.

  9. Click Create.
    10. The Databricks Account connection is created.

What's next

Add Databricks to Data Access