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.

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.

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

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.

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 couchbase-operational-insights.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.