Video | Tableau | Data prep | Tool strategy

How to create a TDS & TDSX file in Tableau: Saving a data source.

TDS, TDSX — it's a bit of a tongue twister, but here's exactly how Tableau's data source files work and why they'll speed up your workflow.

Watch on YouTube
  • A TDS file is an XML file that stores only metadata about a data source — connections, relationships, hierarchies, number formatting and data types — while a TDSX packages that metadata together with the actual data (the hyper extract).
  • Saved data sources live in version-specific folders on your machine, which is why items like Superstore Sales appear automatically on the Tableau start screen.
  • Right-click a data source and choose 'Add to Saved Data Sources' to export a TDS, switching the dropdown to TDSX to save a packaged version.
  • Dragging a TDS file into an open workbook adds it as a second connection and preserves the hierarchies and formatting you built previously, and you can still edit relationships afterwards.
  • A TDSX is a compressed zip of the hyper file plus the TDS, so it can appear smaller on disk than the uncompressed TDS due to that compression.

A TDS file stores just the metadata of a data source (connections, hierarchies, formatting, data types) while a TDSX packages that metadata together with the actual data, letting you reuse a fully-configured connection instead of rebuilding it every time.

Tim builds a connection to a Postgres database, adds formatting and a hierarchy, then saves it out as reusable data source files. He shows the same principle already at work behind Tableau's built-in Superstore Sales sample.

The Breakdown
  1. Why saved data sources matter 0:00

    Whenever you open a sample connection like Superstore Sales, you're actually opening a TDS file that carries hierarchies, field info and data types with it. If you connect to the same source repeatedly, saving it this way avoids rebuilding that setup each time.

  2. Do your prep before saving 1:02

    Before creating a TDS you need to do the initial setup on the live connection first — bring in your tables, let Tableau resolve relationships between them, and take an extract if you want faster performance. This groundwork has to happen before you save the data source, since the TDS captures whatever state you've built.

  3. Add formatting and hierarchies 2:17

    Set number formats (for example currency) on fields so they carry through wherever the field is used, and group related fields into a hierarchy via right-click > Hierarchy > Create Hierarchy so users can expand and collapse them in a view. Both of these get saved into the metadata.

  4. Save the TDS file 3:41

    Right-click the data source and choose 'Add to Saved Data Sources' to export a TDS; this also reveals the version-specific folder on your machine where all your saved sources live, which is why sample connections appear automatically on the start screen. You can save it there or to any location of your choosing.

  5. A TDS is just XML 5:09

    Open a TDS file in a code/text editor and you'll see it's plain XML holding all the metadata — connection details, groups, hierarchies, formatting. Power users can edit this directly to change connection info without rebuilding the source in Tableau.

  6. Reuse a TDS in a workbook 6:14

    Drag a TDS file into an open workbook to add it as a new connection, preserving whatever hierarchies and formatting you'd previously built. It only contains metadata, so you can still go in afterwards and edit the underlying relationships if needed.

  7. Package it as a TDSX to share data 7:27

    When someone doesn't have access to the original source, save a TDSX instead — it bundles the actual data (the hyper extract) with the TDS metadata into a single shareable, compressed zip file, while still retaining a reference to the original source for later reconnection.

Worth Knowing
  • A TDSX can look smaller on disk than the uncompressed TDS purely because the TDSX is compressed as a zip — compressing the TDS separately shows its true relative size.
  • Saved data source folders are version-specific, so files are organised per Tableau version on your machine.
  • Editing a TDS file's XML directly is possible and used by some to tweak connection metadata, but it's a manual, advanced approach.
Use It When

Reach for a TDS when you and your team repeatedly connect to the same source and want the formatting, hierarchies and relationships set up once and reused; reach for a TDSX when you need to hand the data itself to someone without access to the original source.

How this Rollup was made provenance & method

A Rollup is drafted by AI from the video's transcript, then reviewed and edited by Tim. Everything used to produce this one is listed below — the model, the exact prompt, and the source video — so the process is transparent and reproducible.

Transcription
On-device — NVIDIA Parakeet v3 for recent videos, OpenAI Whisper large-v3 for earlier ones. The transcript never leaves the machine or gets published.
Drafting
Claude Sonnet 5 in the cloud, from that transcript.
Prompt
The exact Rollup prompt (v2) — the full system prompt, unedited.
Source video
Watch on YouTube
Drafted
5 July 2026 at 09:38
Reviewed & edited
5 July 2026 at 09:41 · by Tim Ngwena

Model + prompt + video is everything you'd need to recreate a Rollup like this yourself. The one thing we don't share is the transcript.

Rights. The video and its transcript are the property of TN Media Ltd. Unauthorised use or download is prohibited. © TN Media Ltd.