Join tables

Create joins between your tables to improve the accuracy of your Search.

With joins, you can make a single search retrieve rich data and dimensional information across multiple tables of your database.

If your database uses any table joins, they appear in ThoughtSpot.

About joins


Create a table join

  1. Select Data in the top menu and choose Tables.

  2. Find your table through browsing, Search, or selecting the appropriate Tag(s).

  3. To select the table for adding joins, click its name in the list. You will see the Columns view of the table.

    Generally, creating a many-to-one join from a fact table to a dimension table simplifies your search.
  4. Select the Joins tab. The list of existing joins from the table appears.

  5. Select + Add join.

    Click + Add join The Create join page appears.

    Create join page. There is a 1 next to the Connection dropdown
    Legend Action


    Choose your connection from the dropdown Connection menu. You can only create joins between data sources uploaded through the same connection.


    [Optional] Select Enter join name to name your join. Note that ThoughtSpot automatically names joins using the following syntax: [OriginDataSourceName]_to_[DestinationDataSourceName]. You can always enter a more meaningful join name, either when creating, or when editing the join.

    You cannot create range joins in the UI. You must use TML.
  6. Under Table 1, choose the table you want to create a join from (origin table).

  7. Under Table 2, choose the destination table or View for the other end of the join. This is usually a dimension table.

  8. Choose the matching columns under each table. These columns must use the same data type.

  9. [Optional] You can select multiple columns for the same join. To add another pair of matching columns to the join definition, select +Add columns.

  10. Specify the join type; see Join types.

  11. Specify the join cardinality; see Cardinality.

  12. Select Create join.

You can now see the updated view of the schema. You can also see the detailed information about all Joins. Note that after creating the join, you may change its name, type, or cardinality by selecting the edit icon. If you want to change the data source or column being joined, you must delete the join and create a new one.

Proceed to create all necessary table joins, to support your data requirements.

Congratulations! Your search can now pull data from all joined tables.

Next steps

Additional resources

As you develop your expertise with joins and schema, we recommend the following ThoughtSpot U course:

See other training resources at ThoughtSpot U.

Was this page helpful?