Extract Upgrade to .hyper Format


In Tableau version 2018, we introduced the .hyper format for Tableau extracts to replace the old .tde format. The .hyper format has been the standard format used by Tableau to created extracts since 2018, and the large majority of extracts are now .hyper files. Beginning in early 2023, Tableau is discontinuing support for the .tde format on Tableau Cloud and Tableau Public. For more details, see this Tableau Community post(Link opens in a new window).

Discontinuation of support for TDE extract files

Beginning in 2023, the .tde format for Tableau extracts is deprecated. This format was replaced by the .hyper format in 2018 but continued to be valid for uploaded files until March 2023.

  • This change takes place for Tableau Cloud and Tableau Public as of March 2023.
  • Beginning with version 2023.1.0 of Tableau Server, the uploading of .tde format files is disabled by default.

It is unusual to have existing .tde files because these were replaced by .hyper format files in 2018 and several common actions on the files automatically and permanently convert them to the supported .hyper format. For details see below.

Tasks that cause an extract upgrade

There are three distinct ways a .tde extract can get upgraded to a .hyper extract: 1.) during an extract refresh (full or incremental), 2.) when appending data to an extract and 3.) when an extract is upgraded manually. After an extract has been upgraded using Tableau Desktop, it's not automatically removed in case the .tde extract is being referenced by other workbooks.

In addition to the tasks that upgrade an extract, extract tasks performed outside of Tableau Desktop can cause an extract upgrade to the .tde extract you interact with. This includes the following tasks:

  • Manual refresh (Tableau Server and Tableau Cloud)

  • Incremental refresh on a published extract data source from Tableau Bridge (Tableau Cloud)

  • A scheduled full or incremental extract refresh data source (Tableau Server and Tableau Cloud)

  • A scheduled incremental extract refresh from Tableau Bridge (Tableau Cloud)

Manually upgrade your extract

If you manage extracts locally, you can manually upgrade your .tde extract to a .hyper extract using Tableau Desktop.

  1. In Tableau Desktop, open a workbook that uses a .tde extract.
  2. Select the extract data source from the Data menu and then select Extract > Upgrade
  3. Select File > Save, which saves the workbook and also completes the extract upgrade.
Back to top
Thanks for your feedback!