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 using Tableau Desktop 2022.4. After an extract has been upgraded, the original .tde extract is automatically removed from Tableau Cloud if it's not being reference by other workbooks.

The followings tasks will upgrade a .tde extract to a .hyper extract on Tableau Cloud:

  • Manual extract refresh

  • Incremental extract refresh using Tableau Bridge

    Note: A full refresh of a .tde extract using Tableau Bridge 10.4 and earlier does not upgrade the extract.

  • A scheduled full or incremental extract refresh

  • A scheduled incremental extract refresh using Tableau Bridge

    Note: A full refresh of a .tde extract using Tableau Bridge 10.4 and earlier does not upgrade the extract.

  • Automated refresh tasks that are performed through the Extract Command-Line Utility

  • Automated append data to an extract using tabcmd

  • Automated append data to an extract using the Extract Command-Line Utility

Back to top
Thanks for your feedback!