Using a .tdc File with Tableau Server

Published: 24 Jul 2014
Last Modified Date: 25 Sep 2017


How to use a .tdc file with Tableau Server.


Tableau Server


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"
    • To know which version is installed on your computer, see Finding Your Tableau Server Version and Build Number.
    • C:\ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources
  2. Restart Tableau Server using tabadmin. For more information, see tabadmin Commands.

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.
Did this article resolve the issue?