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 -
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), 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.
-
Create a file named
enterprise-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 the path to the certificate using
sslCertPath.The certificate must be a PEM-encoded file.
sslCertPathreplaces the default trust store instead of adding to it.sslCertPath=<path to your PEM-encoded CA certificate>The connector does not support the sslKeystorePathandsslKeystorePasswordproperties and ignores them if specified. -
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. |