## Connector Download

The Tableau connector is available to download from the automated CI workflow: [link](https://github.com/opensearch-project/sql-jdbc/actions/workflows/bi-connectors.yml).
The release snapshot is also available [here](opensearch_sql_jdbc.taco).

## Connector Install

1. Put connector `taco` file into
  * Windows: `C:\Users\%USERNAME%\Documents\My Tableau Repository\Connectors`;
  * MacOS: `~/Documents/My Tableau Repository/Connectors`.
1. Put OpenSearch `JDBC` [driver](../../README.md) (`jar` file) into
  * Windows: `C:\Program Files\Tableau\Drivers`;
  * MacOS: `~/Library/Tableau/Drivers`.
1. Run `Tableau Desktop` with command line flag `-DDisableVerifyConnectorPluginSignature=true`:
  * Windows: `"C:\Program Files\Tableau\Tableau 2022.1\bin\tableau.exe" -DDisableVerifyConnectorPluginSignature=true`;
  * MacOS: `open -n /Applications/Tableau\ Desktop\ 2022.1.app --args -DDisableVerifyConnectorPluginSignature=true`.    
Adjust the command line accoring to the Tableau version you have. You can create a shortcut or a script to simplify this step.

## TDVT report for OpenSearch JDBC Tableau connector

Each Tableau connector has to be tested and verified using [TDVT](https://tableau.github.io/connector-plugin-sdk/docs/tdvt).

Most recent tests of the connector were performed on OpenSearch v.1.2.0 with SQL plugin v.1.2.0.

TDVT test results are available in [tdvt_test_results.csv](tdvt_test_results.csv).

Test pass rate is 669/837 (80%).

## See also

* [Connector user manual for Tableau Desktop](tableau_support.md)
* JDBC Driver user manual [describes](../../docs/tableau.md) how to use the `JDBC` driver without the connector