Using a .tdc File with Tableau Server

Published: 24 Jul 2014
Last Modified Date: 13 Jun 2018


How to use a .tdc file with Tableau Server.


  • Tableau Server
  • Tableau Server on Linux


Important: Tableau does not test or support .tdc files. These files should be used as a tool to explore or occasionally address issues with your data connection. Creating and maintaining .tdc files requires careful manual editing, and there is no support for sharing these files.
  1. Place the .tdc file in the bin folder or the vizqlserver\Datasources folder. For a default installation, these folders are located:
    • With 64-bit Tableau Server: "C:\Program Files\Tableau\Tableau Server\[version]\bin"
    • With 32-bit Tableau Server: "C:\Program Files (x86)\Tableau\Tableau Server\[version]\bin"
    • C:\ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources
    On Tableau Server for Linux:
    • /var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/
  2. Restart Tableau Server.

Additional Information

  • A .tdc file must be placed on each computer running vizqlserver or backgrounder (if applicable for extract refreshes).
  • The bin directory is checked first, and then the Datasources directory.
  • A .tdc file in the Datasources directory will override one in the bin directory.
  • A backup does not back up .tdc files.
  • A restore deletes existing .tdc files.
  • A .tdc file in the bin folder will not be retained across an upgrade because the bin directory is removed during uninstall.
  • A .tdc file in the Datasources folder will not be retained across upgrades because a restore is part of the upgrade process.
  • The .tdc file used in Tableau Desktop should be uploaded to Tableau Server without changes.  Non-matching .tdc files will cause errors and will not work correctly.
Did this article resolve the issue?