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

  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.

Configure SSL Certificates for Tableau Desktop

If you use a certificate from a trusted public certificate authority (CA), no manual SSL configuration is required.

If you use a certificate from a private CA or require client certificate authentication, you must configure a properties file as follows.

  1. Create a file named enterprise-analytics.properties and save it in the following directory:

    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/Datasources

  2. To trust a certificate from a private CA, specify the path to the certificate using sslCertPath.

    The certificate must be a PEM-encoded file. sslCertPath replaces the default trust store instead of adding to it.

    sslCertPath=<path to your PEM-encoded CA certificate>
    The connector does not support the sslKeystorePath and sslKeystorePassword properties and ignores them if specified.
  3. To authenticate using a client certificate, configure either PEM files or a keystore.

    PEM Files
    clientCertPath=<path to client certificate pem>
    clientKeyPath=<path to client key pem>
    # Optional; required only if the private key is encrypted
    clientKeyPassword=<private key password>
    Keystore
    clientCertKeystorePath=<path to keystore file>
    clientCertKeystorePassword=<keystore password>

    The keystore must contain exactly one entry.

For steps to install and configure the connector on Tableau Server, see Install the Couchbase Tableau Connector on Tableau Server.