Connector Plugins Built with the Tableau Connector SDK
When Tableau doesn't provide a built-in connector for your data, you can connect to ODBC- and JDBC-based data using connector plugins created with the Tableau Connector SDK. These connectors — also called TACO files, because of their .taco filename extensions — can be built by a third-party developer or by your own developer. This topic describes a connector plugin and how to use it.
Note: Connector plugins are supported in Tableau 2019.4 and later.
What is a connector plugin?
How to use a connector plugin
- Download the connector file, [connector name].taco.
- Place the .taco file in the following directory (default location):
- Windows - C:\Users\[Windows User]\Documents\My Tableau Repository\Connectors
- macOS - /Users/[user]/Documents/My Tableau Repository/Connectors
Connect Tableau to the data
- Start Tableau, and under Connect, select the name of the connector you just installed. For a complete list of data connectors, select More under To a Server.
- Enter the information that you’re prompted for, and then select Sign In.
Note: Some connectors require the installation of an additional driver. If prompted during the connection process, follow the prompts to download and install the required driver.
- Wait while the connector retrieves your data.
- Select the sheet tab to start your analysis.
Add the connector to Tableau Server
If you want to publish your data to Tableau Server, you must first install the same connector file on the computer running Tableau Server.
Note: If Tableau Server runs on multiple computers, follow the same steps for each computer.
There are two options:
- Place a copy of the .taco file you use on Tableau Desktop in this location on the server:
In most cases, Tableau Server is installed in the ProgramData folder, so you would copy the .taco file to C:\ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Connectors.
- Restart the server.
- Create a directory for Tableau connectors. For example, C:\tableau_connectors.
- Copy the .taco file to the folder your created on each computer running Tableau Server.
- Set the
native_api.connect_plugins_pathoption. For example:
tsm configuration set -k native_api.connect_plugins_path -v C:/tableau_connectors
If this causes a configuration error, try adding the
--force-keysoption to the end of the command.
Apply the pending configuration changes. This restarts the server.
tsm pending-changes apply
Tableau support for connector plugins
Tableau doesn't provide technical support for partner-distributed connector plugins. They are also not supported in Tableau Online. For technical support, contact the developer of the connector plugin.
Tableau does provide technical support the Connector SDK. If you find an issue with the SDK or any of the developer samples, submit an issue on Github(Link opens in a new window).
Note: Connector plugins currently cannot be used with Tableau Online.
For more information about the Connector SDK, or to see samples, see the Tableau Connector SDK(Link opens in a new window) repository on GitHub.
Test and vet a connector plugin