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:
-
Copy the
.tacofile intoC:\Users\<Windows User>\Documents\My Tableau Repository\Connectors -
Copy the
.jarfile intoC:\Program Files\Tableau\Drivers -
Restart Tableau Desktop.
Install the Connector on macOS
To install the Couchbase Tableau Connector on macOS:
-
Copy the
.tacofile into/Users/<user>/Documents/My Tableau Repository/Connectors -
Copy the
.jarfile into/Users/<user>/Library/Tableau/Drivers directory -
Restart Tableau Desktop.
Verify the Connector Installation
To verify if the connector is installed correctly:
-
Open Tableau Desktop.
-
Go to .
-
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) or if you’re connecting to Couchbase Capella, no manual SSL configuration is required. Certificates of well-known public certification authorities as well as Couchbase Capella are trusted by default.
If you use a certificate from a private CA or require client certificate authentication, you must configure a properties file as follows.
-
Create a file named
couchbase-analytics.propertiesand 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
-
To trust a certificate from a private CA, specify either the certificate path or the keystore path, not both.
- Certificate file path
-
sslCertPath=<path to your certificate file> - Keystore path
-
sslKeystorePath=<path to your keystore> sslKeystorePassword=<your keystore password>
-
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>
| For steps to install and configure the connector on Tableau Server, see Install the Couchbase Analytics Connector on Tableau Server. |