Following the release of Tableau 2023.2, the master branch of the repo now targets Tableau 2023.3. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2023.2, please download the Tableau Connector SDK for Tableau 2023.2 release.

On June 15, with the full release of Tableau 2023.2 we moved the latest version of the master branch to target Tableau 2023.2. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2023.1, please download the Tableau Connector SDK for Tableau 2023.1 release.

On March 15, with the full release of Tableau 2023.1 we moved the latest version of the master branch to target Tableau 2023.1. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2022.4, please download the Tableau Connector SDK for Tableau 2022.4 release.

Support for multiple user-configurable OAuth integrations
Once a connector has been updated, this release includes a major platform update that allows a Tableau Administrator to fully configure the OAuth flow for their IDP of choice. For more information about how to update your connector, see: OAuth Authentication Support

On December 14, with the full release of Tableau 2022.4 we moved the latest version of the master branch to target Tableau 2022.4. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2022.3, please download the Tableau Connector SDK for Tableau 2022.3 release.

On October 18, with the full release of Tableau 2022.3 we moved the latest version of the master branch to target Tableau 2022.3. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2022.2, please download the Tableau Connector SDK for Tableau 2022.2 release.

Run TDVT tests on Linux
TDVT tests can now be run with tabquerytoolsrv using Tableau Linux Server installs: details

On June 29, with the full release of Tableau 2022.2 we moved the latest version of the master branch to target Tableau 2022.2. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2022.1, please download the Tableau Connector SDK for Tableau 2022.1 release.

On March 31, with the full release of Tableau 2022.1 we moved the latest version of the master branch to target Tableau 2022.1. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2021.4, please download the Tableau Connector SDK for Tableau 2021.4 release.

Connection Dialog V2 Placeholder Text The Connection Dialog V2 text field now supports placeholder text.

Javascript logging.log() function will only log message “Connector SDK logging.log() function is deprecated.” in the log file. This change has been applied to 2022.1 release and all maintaince releases starting April 2022.

On December 16, with the full release of Tableau 2021.4 we moved the latest version of the master branch to target Tableau 2021.4. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2021.3, please download the Tableau Connector SDK for Tableau 2021.3 release.

Full Hive Dialect Sample Released With the addition of new dialect customizations, we have updated our Hive12Dialect.tdd sample to no longer rely on an existing base dialect, and instead be fully defined in the .tdd file.

On September 9th, with the full release of Tableau 2021.3 we moved the latest version of the master branch to target Tableau 2021.3. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2021.2, please download the Tableau Connector SDK for Tableau 2021.2 release.

On March 29th, with the full release of Tableau 2021.2 we moved the latest version of the master branch to target Tableau 2021.2. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2021.1, please download the Tableau Connector SDK for Tableau 2021.1 release.

• Extract Only Connector Web Authoring
  Starting in 2021.2, extract only connectors created with the Tableau Connector SDK now support web authoring, allowing you to create new connections on Tableau Server for those connectors.

• Deprecated connection-matcher and connection-normalizer JavaScript files
  Using JavaScript files for connection-matcher and connection-normalizer has been deprecated since Tableau 2020.3, but starting with Tableau 2021.2 connectors using those files will throw an error when being loaded.

On March 29th, with the full release of Tableau 2021.1 we moved the latest version of the master branch to target Tableau 2020.1. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2020.4, please download the Tableau Connector SDK for Tableau 2020.4 release.

• OAuth Authentication Support
  Starting in Tableau 2021.1 a connector using Connection Dialog V2 style, OAuth is supported as one of the categories for authetication. To learn more please refer here. For a complete example please refer to here.
• Runtime Determination of Connection Normalizer
  Starting in Tableau 2021.1 a connector using Connection Dialog V2 style, connection-fields, can let the system determine at runtime the correct connection-normalizer by not defining it. Any connection-normalizer defined in the tdr file will take precedence at runtime. To use set min-version-tableau='2021.1' or newer in the manifest file.

On December 14, with the full release of Tableau 2020.4 we moved the latest version of the master branch to target Tableau 2020.4. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2020.3, please download the Tableau Connector SDK for Tableau 2020.3 release.

Features added in the SDK for Tableau 2020.4 include:

• ISO8601 support added
  ISO8601 support has been added to the postgres_odbc and postgres_jdbc samples. The samples can be found here.
• JDBC Kerberos Postgres sample using Connection Dialogs v2
  This sample connector plugin demonstrates how to incorporate different Kerberos-based authentication modes for the “Tableau + Postgres + JDBC” use cases. This plugin has been created using the Connection Dialog v2 framework See more here.
• Partner Run Connectors Tests
  Added tests that the partner can run to validate certian aspects of the connector developed. More information about running the tests can be found in the “Run Connectors tests” section here.

On August 12, with the full release of Tableau 2020.3 we moved the latest version of the master branch to target Tableau 2020.3. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2020.2, please download the Tableau Connector SDK for Tableau 2020.2 release.

Features included now included in the SDK for Tableau 2020.3 include:

• Connection Dialogs v2
  Connection Dialogs v2 feature, which will allow for more flexible connection dialogs. Learn more about connection Dialogs v2 here.
• Updated Dialect Samples
  With 2020.3, the Connector SDK contains the complete dialect definition file for Postgres JDBC connector and Postgres ODBC connector. This should serve as a good example to write a dialect file for JDBC or ODBC connectors with 2020.3 updates.
• Delegation UID
  This applies to databases that support a user(authenticated_user) that can delegate requests to another user(delegated_user) by enabling the client to pass a DelegationUID(delegated_user) to the database server.
• Scenario-based Samples
  Scenario-based samples provide good examples for specific scenarios partners might face while developing their connectors. They are in the master branch of Connector SDK.
  • Extract Only Connector See more here.
  • MySQL Based Connector See more here.
  • Connectors Using Vendor Attributes See more here.
• ‘format-true’ and ‘format-false’ to allow literal, predicate and value attributes
  With the release of Tableau 2020.3, format-true and format-false have two parameters, literal and predicate. See more about Boolean Support here. We have also added support for unicode-prefix in format-string-literal. See more about String Literal Support here

Note: Certain features can be seen in the 2020.3 branch, but they are not final and may have issues, and that we will merge them into master when 2020.3 is released to the public.

With the release of Tableau 2020.3 Beta, you get a sneak peek into the features available in Tableau 2020.3 and Connector SDK.

• Connection Dialogs v2
  Connection Dialogs v2 feature, which will allow for more flexible connection dialogs. Learn more about connection Dialogs v2 here.
• Updated Dialect Samples
  The 2020-3 branch of connector SDK contains the complete dialect definition file for Postgres JDBC connector and Postgres ODBC connector. This should serve as a good example to write a dialect file for JDBC or ODBC connectors with 2020.3 updates.
• Delegation UID
  This applies to databases that support a user(authenticated_user) that can delegate requests to another user(delegated_user) by enabling the client to pass a DelegationUID(delegated_user) to the database server. More details on this feature will be added with the release of 2020.3.
• Scenario-based Samples
  Scenario-based samples provide good examples for specific scenarios partners might face while developing their connectors. They are in the master branch of Connector SDK.
  • Extract Only Connector See more here.
  • MySQL Based Connector See more here.
  • Connectors Using Vendor Attributes See more here.
• ‘format-true’ and ‘format-false’ to allow literal, predicate and value attributes
  With the release of Tableau 2020.3, format-true and format-false will have two parameters, literal and predicate. See more about Boolean Support here. We have also added the support for unicode-prefix in format-string-literal. See more about String Literal Support here

The dialect documentation has been updated. This should help the connector plugin developers get a better idea of writing dialect files and troubleshoot errors better.
The following sections have been added to the dialect documentation:

• Date Function Element
  • DATEPART without custom start of week
  • DATEPART for Custom Start of Week
  • format-bool-as-value
• Join Support
  • supported-joins
  • format-is-distinct
• Boolean Support
  • format-true
  • format-false
  • format-bool-as-value
• String Literal Support
  • Standard vs Extended
  • Unicode Prefix
• Temporary Table Support
  • format-create-table
  • format-select
  • format-drop-table
    

See detailed documentation here.

On May 8th, with the full release of Tableau 2020.2 we moved the latest version of the master branch to target Tableau 2020.2. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2020.1, please download the Tableau Connector SDK for Tableau 2020.1 release.

We’ve updated the packager tool to prepare for the upcoming Connection Dialogs v2 feature, which will allow for more flexible connection dialogs.

In Tableau 2019.4, we introduced a python-based packaging tool that packages your connector into a single file we call a .taco. Packaging your connector into a single .taco file allows you to easily distribute and share your connector, and end users can install these connectors by simply dropping them into their “My Tableau Repository/Connectors” folder. (More information about .taco files can be found here.) One of the requirements for .taco files to be loaded into Tableau is that they are signed by a trusted certificate authority, so that customers can be confidant of the authenticity and integrity of the .taco file.

Before, our packaging tool would sign the connector by calling jarsigner (.taco files are actually .jar files with a different file extension). However, many of the people signing their .taco file have had trouble with the limited options the packaging tool has for signing, and instead called jarsigner themselves. This meant we had two paths to support - signing the .taco with our packager, and signing it with jarsigner.

We’ve pushed a change to the packaging tool that removes the option to sign .taco files as part of the packaging process. This means that everyone will need to use jarsigner directly to sign their .taco files using the same methods you’d use to sign any other .jar file. We decided on this action since creating an interface for the packager to cover every possible jarsigner option would become unwieldy, especially for a tool whose primary purpose was to package the connector. It also future proofs the signing process in case jarsigner itself changes its interface.

We’ve also overhauled the documentation around packaging and signing in order to cover the new changes, as well as smooth over some rough edges in the packaging and signing process.

We hope these changes make it simpler to to sign your connector. If you have any trouble, please look over our documentation or open an issue on our github page.

On March 11th, with the full release of Tableau 2020.1 we moved the latest version of the master branch to target Tableau 2020.1. This means that the samples and connectors made with this version of the SDK may not work with older versions of Tableau. To develop against Tableau 2019.4, please download the Tableau Connector SDK for Tableau 2019.4 release.

One of the new features is the addition of three new customizable text fields called Vendor Attributes! We have instructions on how to use them in our documentation, and you can see an example of them in a working connector in our Postgres JDBC sample connector here.