---
schema_version: "1"
id: d5ca9b2f944de07e8c1fe368da1279ceefd24f906bda49bcb9f4f55385e1f3ac
title: Databricks
collection: tableau
version: next
locale: en-gb
portal_url: https://docs.salesforce.com/tableau/next/en-gb/pro/desktop/examples_databricks.md
canonical_url: https://help.tableau.com/v0.0/pro/desktop/en-gb/examples_databricks.htm
source_site: help.tableau.com
content_type: documentation
content_hash: c9099ac5eb309709ca564d7387da3d05012f44f61365ab2a013b45e843dbf7dd
description: Connect Tableau to a Databricks database and set up the data source.
---
[Skip to main content](#main-content)

# Databricks

This article describes how to connect Tableau to a Databricks database and set up the data source.

## Before you begin

Before you begin, gather this connection information:

- Name of the server that hosts the database you want to connect to
- HTTP path to the data source
- Authentication method:
    - Databricks login (recommended)
    - Personal Access Token
    - Service Principal
- Sign-in credentials to be used with your chosen authentication method:
    - Databricks login details (OAuth)
    - Personal Access Token password
    - Service Principal Client ID and Secret
- Get connection details for a Databricks compute resource.
- (Optional) Initial SQL statement to run every time Tableau connects

### Driver required

This connector requires a driver to talk to the database. If the driver is not installed on your computer, Tableau displays a message in the connection dialog box with a link to the [Driver Download](https://www.tableau.com/en-gb/support/drivers) page where you can find driver links and installation instructions.

## Make the connection and set up the data source

1. Start Tableau and under Connect, select Databricks. For a complete list of data connections, select More under To a Server. Then do the following:
    
    1. Enter the Server Hostname.
    2. Enter the HTTP Path to the data source.
    3. Select the Authentication method: Databricks login(recommended), Personal Access Token or Service Principal.
        
        Note: Basic authentication using a Databricks username and password reached end of life as of July 2024. For more information, see [End of life for Databricks-managed passwords](https://docs.databricks.com/en/security/auth/password-deprecation.html).
    4. Enter the sign-in credentials for the authentication method you chose:
        
        - For a Databricks login, sign in with your configured OAuth application. For more information, see [Configure Databricks sign-on from Tableau Server](https://docs.databricks.com/en/integrations/configure-oauth-tableau.html).
        - For personal access token, type the corresponding **Password**. (See [Personal Access Tokens](https://docs.databricks.com/aws/en/dev-tools/auth/pat) on the Databricks website for information on access tokens.)
        - For Service Principal, supply a client ID and secret. (For more information on managing Databricks service principals, see [Manage service principals](https://docs.databricks.com/aws/en/admin/users-groups/manage-service-principals) on the Databricks website.)
    5. (Optional) Select Initial SQL to specify a SQL command to run at the beginning of every connection, such as when you open the workbook, refresh an extract, sign in to Tableau Server or publish to Tableau Server. For more information, see [Run Initial SQL](https://help.tableau.com/v0.0/pro/desktop/en-gb/connect_basic_initialsql.htm).
    6. Select Sign In.
        
        If Tableau can’t make the connection, verify that your credentials are correct. If you still can't connect, your computer is having trouble locating the server. Contact your network administrator or database administrator for more assistance.
2. On the data source page, do the following:
    
    1. (Optional) Select the default data source name at the top of the page, and then enter a unique data source name for use in Tableau. For example, use a data source naming convention that helps other users of the data source figure out which data source to connect to.
    2. Under Schema, select a schema or use the text box to search for a schema by name.
    3. Under Table, select a table or use the text box to search for a table by name.
    4. Drag the table to the canvas, and then select the sheet tab to start your analysis.
        
        Use custom SQL to connect to a specific query rather than the entire data source. For more information, see [Connect to a Custom SQL Query](https://help.tableau.com/v0.0/pro/desktop/en-gb/customsql.htm).

## Sign in on a Mac

If you use Tableau Desktop on a Mac, when you enter the server name to connect, use a fully qualified domain name, such as mydb.test.ourdomain.lan, instead of a relative domain name, such as mydb or mydb.test.

Alternatively, you can add the domain to the list of Search Domains for the Mac computer so that when you connect, you need to provide only the server name. To update the list of Search Domains, go to System Preferences > Network > Advanced, and then open the DNS tab.

## Databricks best practices and troubleshooting

To learn more about optimising your workbooks, connections and general Tableau performance, there is a wealth of advice available in [Optimise Workbook Performance](https://help.tableau.com/v0.0/pro/desktop/en-gb/performance_tips.htm).

## See also

- [Set Up Data Sources](https://help.tableau.com/v0.0/pro/desktop/en-gb/datasource_prepare.htm) – Add more data to this data source or prepare your data before you analyse it.
- [Build Charts and Analyse Data](https://help.tableau.com/v0.0/pro/desktop/en-gb/design_and_analyze.htm) – Begin your data analysis.

- For information about best practices and troubleshooting when using Tableau with Databricks clusters, see [Connect Tableau and Databricks](https://docs.databricks.com/user-guide/bi/tableau.html) in the Databricks documentation.