Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

A newer version of this documentation is available.

View Latest

Install the Couchbase Tableau Connector on Tableau Desktop

  • how-to
You can install the Couchbase Tableau Connector for Tableau Desktop on both macOS and Windows.

After you download the Couchbase Tableau Connector, extract the ZIP archive to a local directory. The archive contains a .taco file and a .jar file.

Install the Connector on Windows

To install the Couchbase Tableau Connector on Windows:

  1. Copy the .taco file into C:\Users\<Windows User>\Documents\My Tableau Repository\Connectors

  2. Copy the .jar file into C:\Program Files\Tableau\Drivers

  3. Restart Tableau Desktop.

Install the Connector on macOS

To install the Couchbase Tableau Connector on macOS:

  1. Copy the .taco file into /Users/<user>/Documents/My Tableau Repository/Connectors

  2. Copy the .jar file into /Users/<user>/Library/Tableau/Drivers directory

  3. Restart Tableau Desktop.

Verify the Connector Installation

To verify if the connector is installed correctly:

  1. Open Tableau Desktop.

  2. Go to Connect  To a Server  More.

  3. In the search box, enter Couchbase.

If the connector appears in the search results, it’s installed correctly.

Set Up SSL Support for Tableau Desktop

Usually, you won’t need to follow this section. There is no need to provide a certificate if you are connecting to Couchbase Capella, or using a certificate from a public certificate authority. Certificates of well-known public certification authorities as well as Couchbase Capella are trusted by default.

To configure SSL support for Tableau Connector:

  1. Make sure you know the absolute paths to the certificate or keystore. You should only supply one of the certificate path or the keystore path, not both.

  2. Create a file called couchbase-analytics.properties and save it in the following directory, depending on whether you are running macOS or Windows:

    Windows

    Save the file to C:\Users\<Windows User>\Documents\My Tableau Repository\Datasources

    MacOS

    Save the file to /Users/<user>/Documents/My Tableau Repository/Data sources

  3. To provide the Certificate file path, add the following line in the properties file.

    sslCertPath=<path to your certificate file>

  4. To provide the keystore path, add the following lines in the properties file.

    sslKeystorePath=<path to your keystore>
sslKeystorePassword=<your keystore password>