Connect to MicroStrategy

This article describes how to use MicroStrategy Workstation with a Databricks cluster or a Databricks SQL warehouse (formerly Databricks SQL endpoint).


Before you connect to MicroStrategy manually, you need the following:

  • A cluster or SQL warehouse in your Databricks workspace.

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

  • A Databricks personal access token. To create a personal access token, do the following:

    1. In your Databricks workspace, click your Databricks username in the top bar, and then select User 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.


    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:


    As a security best practice when you authenticate with automated tools, systems, scripts, and apps, Databricks recommends that you use OAuth tokens.

    If you use personal access token authentication, Databricks recommends using personal access tokens belonging to service principals instead of workspace users. To create tokens for service principals, see Manage tokens for a service principal.

Connect to MicroStrategy manually

To connect to MicroStrategy manually, do the following:

  1. Start MicroStrategy Workstation.

  2. In the navigation bar, in the Analysis area, next to Dossiers, click the plus (Create a new dossier) icon.

  3. In the Untitled Dossier window, in the Datasets panel, click New Data. If the Datasets pane is not visible, in the navigation bar, click the dataset (Click to Open Datasets Panel) icon.

  4. In the Data Sources dialog, click the Databricks icon. If the Databricks icon is not visible, scroll to view it, or in the Search box, enter Databricks.

  5. In the Select Import Options, click to Select Tables, Build a Query, or Type a Query, and click Next.

  6. In the Import from Table - Select or Import from Table - SQL Editor dialog, next to Data Sources, click the plus (New Data Source) icon.

  7. In the Connections dialog, enter a Connection Name.

  8. For [JDBC URL], enter the JDBC URL from Step 1. If the URL ends with ;UID=token;PWD=<personal-access-token>, do not include that portion of the URL, as you will provide this information next.

  9. If a Token box displays, enter your personal access token from Step 1.

  10. If a User box displays, enter the word token.

  11. If a Password box displays, enter your personal access token from Step 1.

  12. Click Save.

Next steps

To continue using MicroStrategy Workstation, see the following resources on the MicroStrategy website:

Additional resources