Connect to data governance partners using Partner Connect

To connect your Databricks workspace to a data governance partner solution using Partner Connect, you typically follow the steps in this article.

Important

Before you follow the steps in this article, see the appropriate partner article for important partner-specific information. There might be differences in the connection steps between partner solutions. For example, some partner solutions allow you to connect Databricks SQL warehouses (formerly Databricks SQL endpoints) or Databricks clusters, but not both.

Requirements

See the requirements for using Partner Connect.

Important

For partner-specific requirements, see the appropriate partner article.

Steps to connect to a data governance partner

To connect your Databricks workspace to a data governance partner solution, do the following:

  1. In the sidebar, click Partner Connect.

  2. Click the partner tile.

    If the partner tile has a check mark icon, a workspace admin has already used Partner Connect to connect your workspace to the partner. Click Sign in to sign in to your existing partner account and skip the rest of the steps in this section.

  3. If there are no SQL warehouses in your workspace, do the following:

    1. Click Create warehouse. A new tab opens in your browser that displays the New SQL Warehouse page in the Databricks SQL UI.

    2. Follow the steps in Create a SQL warehouse.

    3. Return to the Partner Connect tab in your browser, then close the partner tile.

    4. Re-open the partner tile.

  4. Select a SQL warehouse from the drop-down list. If your SQL warehouse is stopped, click Start.

  5. Select a catalog and a schema from the drop-down lists, then click Add. You can repeat this step to add multiple schemas.

    Note

    If a partner doesn’t support Unity Catalog with Partner Connect, the default catalog for your Unity Catalog enabled workspace is used. If your workspace isn’t Unity Catalog enabled, the legacy Hive metastore (hive_metastore) is used.

  6. Click Next.

    Partner Connect creates the following resources in your workspace:

    • A Databricks service principal named <PARTNER>_USER.

    • A Databricks personal access token that is associated with the <PARTNER>_USER service principal.

    Partner Connect also grants the following privileges to the <PARTNER>_USER service principal:

    • (Unity Catalog)USE CATALOG: Required to interact with objects within the selected catalog.

    • (Unity Catalog) USE SCHEMA: Required to interact with objects within the selected schema.

    • (Legacy Hive metastore) USAGE: Required to grant the SELECT and READ_METADATA privileges for the schemas you selected.

    • SELECT: Grants the ability to read the schemas you selected.

    • (Legacy Hive metastore) READ_METADATA: Grants the ability to read metadata for the schemas you selected.

    • CAN USE: Grants permissions to use the SQL warehouse you selected.

  7. Click Next.

  8. Click Connect to <Partner>.

    A new tab that displays the partner website opens in your web browser.

  9. Complete the on-screen instructions on the partner website to create your trial partner account.