Share via

Connect to AtScale

  • Article

AtScale’s semantic layer delivers a single source of governed metrics and KPIs, tied to live lakehouse data and to BI tools including Excel, Tableau, and Power BI.

You can connect Databricks SQL warehouses (formerly Databricks SQL endpoints) and Azure Databricks clusters to AtScale.

Connect to AtScale using Partner Connect

Note

Partner Connect only supports SQL warehouses for AtScale connections.

To connect to AtScale using Partner Connect, see Connect to semantic layer partners using Partner Connect.

Connect to AtScale manually

This section describes how to connect to AtScale manually.

Note

To connect to AtScale faster, use Partner Connect. Partner Connect only supports SQL warehouses for AtScale connections.

Requirements

Before you connect to AtScale manually, you must have the following:

  • An AtScale account.

  • A cluster or SQL warehouse in your Azure Databricks workspace.

  • The connection details for your cluster or SQL warehouse, specifically the Server Hostname, Port, and HTTP Path values.

  • An Azure Databricks personal access token or a Microsoft Entra ID (formerly Azure Active Directory) token.. To create a personal access token, do the following:

    1. In your Azure Databricks workspace, click your Azure Databricks username in the top bar, and then select Settings from the drop down.
    2. Click Developer.
    3. Next to Access tokens, click Manage.
    4. Click Generate new token.
    5. (Optional) Enter a comment that helps you to identify this token in the future, and change the token’s default lifetime of 90 days. To create a token with no lifetime (not recommended), leave the Lifetime (days) box empty (blank).
    6. Click Generate.
    7. Copy the displayed token to a secure location, and then click Done.

    Note

    Be sure to save the copied token in a secure location. Do not share your copied token with others. If you lose the copied token, you cannot regenerate that exact same token. Instead, you must repeat this procedure to create a new token. If you lose the copied token, or you believe that the token has been compromised, Databricks strongly recommends that you immediately delete that token from your workspace by clicking the trash can (Revoke) icon next to the token on the Access tokens page.

    If you are not able to create or use tokens in your workspace, this might be because your workspace administrator has disabled tokens or has not given you permission to create or use tokens. See your workspace administrator or the following topics:

    Note

    As a security best practice, when you authenticate with automated tools, systems, scripts, and apps, Databricks recommends that you use personal access tokens belonging to service principals instead of workspace users. To create tokens for service principals, see Manage tokens for a service principal.

Manual connection steps

To connect to AtScale manually, see Adding Databricks Data Warehouses on the AtScale website.

Next steps

Read the AtScale documentation:

  1. Log in to your AtScale account.
  2. Click the Help icon.
  3. Click Documentation.

Additional resources