Submit a ticket My tickets
Welcome
Login  Sign up

Tableau Connector (Server/Cloud)

This article describes how Tableau Server connector for DataGalaxy works.

This connector is available in the following modes:

Desktop mode ✅SaaS Online mode ✅
Please be careful! Starting with version 6.0.0 of the Tableau plugin, the technical naming of objects changes and is not backward-compatible. Therefore, if you migrate from a previous version, the objects will be duplicated in DataGalaxy. If you have enriched these objects with custom fields or links, it will be necessary to carry over these modifications to the new objects (export/import). You can use the orphaned objects management feature to clean up old objects. Information on the release here.


Since May 2023, for Tableau Cloud, the authentication using a Personal Access Token (PAT) is mandatory, using a username and password is no longer supported. If you use the Online connector for Tableau Cloud, you have to create a PAT on your Tableau environment and update the configuration of the connector : set the name of the PAT as the Username and paste the PAT in the Password field.


Connector scope

The connector allows you to import the following metadata from Tableau server :

  • The set of projects, workbooks and shared data sources of a given site

  • The content of a workbook: worksheet, dashboards, stories and embedded data sources

  • Fields in shared and embedded data sources 

  • Links between dashboards and worksheets, between shared and embedded data sources and between worksheets and data source fields

By default, the following attributes are populated for the entire scope: 

  • Functional and technical labels
  • Description of project and Datasource fields (if filled in the source)

  • Data Owner of projects and folders (if the e-mail address is present in the DataGalaxy platform)

Additional attributes are also filled in depending on the technology and by type of object. To make them appear in DataGalaxy screens, it may be necessary to adapt the screens of the concerned objects. See this article to learn more about screen customization.

The following table details the objects and attributes retrieved, and their correspondences in DataGalaxy :

Source
DataGalaxy Object
DataGalaxy attributes
Comments
Project / Sub-projectApplicationCreation date of the source objectEach project shared in the Tableau tool is imported as an application, within  a root application (to be named during configuration ) in the Usage module.
Shared Data SourceData SetURL,
Creation date of the source object

Embedded Data SourceData Set

Data Source FieldFieldTechnical type
WorkbookApplicationURL,
Creation date of the source object 

WorksheetReportCreation date of the source object
Dashboard and storiesDashboardCreation date of the source object 

Configuration of a connection

Tableau Server Connector uses the Tableau REST API, compatible with Tableau Server and Tableau Online. Authentication is performed using a user's Personal Access Token (Authentication Methods - Sign In).

The following information is required to set up a connection:

ParameterMandatoryDescriptionExample
Protocol YesChoice of protocol: https or httphttps
ServerYesTableau server nameprod-uk-a.online.tableau.com
PortNoTableau server port (default protocol port will be used when empty)
SiteNoThe name of the site (do not enter a complete URL)
Example: datagalaxy
datagalaxy
API versionYesVersion of the Tableau API used
This version is dependent on the version of the Tableau server, more information available here
3.12
Root application nameYes

Name of the "parent" application in the DataGalaxy Usage module, which will be used to store all the workbooks of the Tableau tool. If the application does not exist, it will be created during the import.


Project namesNoList of project names you want to filter on when retrieving metadata, separated by a comma.Samples, Your project
UserYesUser name (PAT name)
PasswordYesUser password (PAT token)

Execution of the connector

To create a connection to Tableau via the Online connector, the entry points are as follows: 

  • From the Import button of the "Shortcuts" widget on the home screen of a client space or workspace 

  • From the Import button of one of the modules when it is empty

  • From the Import button in the contextual menu of one of the modules, on the right side of the filtered views

  • From the Add a connection button in the Connector tab available in the workspace setup screen

You can optionally filter (by module, connector type or by using the search bar), then click on the desired technology:  

You then need to complete the login form using the login information described above to perform an import. For more details on the steps involved in running the Online connector, you can consult the following article: [HowTo] Running the Online Connector

This technology is also available via the Desktop Connector, you can find more information on the procedure here: [How to] How to use the connector.

Releases

DatePlugin
Version
DataGalaxy
release

release    Desktop Connector

version (minimum)

Description
28/05/20266.8.1v3.345.05.15.7Fixed filtering issues on projects for certain api versions
19/03/20266.8.0
5.15.7Added the possibility to filter by project
10/02/20266.7.1v3.306.45.15.4
Fixed some bugs related to lineage generation
03/12/20256.7.0v3.286.45.15.3Added best-effort error handling strategy for link generation failures
02/12/20256.6.0v3.285.35.15.3Added retry mechanism for GraphQL queries on timeout errors
28/11/20256.5.0v3.284.15.15.2Added best-effort error handling strategy for Tableau API failures
24/11/20256.4.1v3.282.35.15.2
Added hidden technical parameters to customize the batch size of the GraphQL queries sent by the connector to Tableau
21/11/20256.3.2v3.282.25.15.2Fixed the token renewal mechanism
14/11/20256.3.0v3.280.25.15.1
Reduced the required number of network calls to fetch workbooks
30/07/20256.2.1v3.219.1
5.7.7
Fixed a bug related to the renewal of the token
20/09/20246.1.0v3.77.15.2.6Improved pagination system for graphQL queries (warning: makes the connector slower but more scalable than before)
28/08/20246.0.3v3.70.05.2.6Improved pagination system to retrieve metadata
21/08/20246.0.2v3.68.05.2.2Logs made more explicit in verbose mode
14/08/2024
6.0.1v3.67.05.1.1Logs made more explicit in verbose mode
01/08/20246.0.0v3.64.05.0.4Update of technical name for datasets to avoid duplicates
30/07/20245.0.0v3.63.05.0.4Migrated from java 11 to java 17 + CVE fixes
06/06/20244.3.5v3.50.0
Bugfix related to a volumetric problem
04/06/20244.3.4v3.49.0

Bugfixes
17/04/20244.3.3v3.42.0
Improve login process
07/12/20234.3.2v3.22.0
Update for retrocompatibility with former python plugin


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.