Prerequisites

The connector supports Tableau Server 2020.1 or later. For earlier versions of Tableau Server, please use either the CData ODBC Driver or JDBC Driver for CData Connect instead.

Install the Connector

After the prerequisites are satisfied, complete the following instructions depending upon your platform:

Windows

1. Run the setup.exe installer. The driver JAR file is automatically placed in the drivers directory, C:\Program Files\Tableau\Drivers.
2. Determine your Tableau Server installation directory (TableauServerRoot). This is usually C:\ProgramData\Tableau\Tableau Server.
3. Follow the instructions in the Register with Tableau Server section to register the connector for use with published workbooks, as well as Tableau Prep Conductor and Tableau Prep Flow Authoring.

Linux

1. Unpack the setup.zip archive. Creating a directory for the connector like /opt/cdata/connect is recommended, but the exact install location does not matter.
2. Copy cdata.tableau.connect.jar from the lib directory into /opt/tableau/tableau_driver/jdbc.
3. Determine your Tableau Server installation directory (TableauServerRoot). This is usually /var/opt/tableau/tableau_server.
4. Follow the instructions in the Register with Tableau Server section to register the connector for use with published workbooks, as well as Tableau Prep Conductor and Tableau Prep Flow Authoring.

Register with Tableau Server

The connector must be registered with Tableau Server before it can be used with published workbooks or flows.

1. Go to the lib folder in the connector install directory.
2. Copy cdata.connect.taco into TableauServerRoot/data/tabsvc/vizqlserver/Connectors.
3. If you want to use the connector with Tableau Prep, copy that TACO file into these locations:
   • TableauServerRoot/data/tabsvc/flowprocessor/Connectors
   • TableauServerRoot/data/tabsvc/flowqueryservice/Connectors