Add an Azure Synapse connection

Configuring OAuth

If you plan to use OAuth with Synapse, you must configure it before you can create a connection. For details, see Configure OAuth for a Synapse connection.

Adding a Synapse connection

To add a connection to Synapse:

  1. Select Data in the top navigation bar.

  2. Click the Connections tab in the left navigation bar, and select the Synapse tile. Alternatively, select + Create new in the left navigation bar, select Connection, and select the Synapse tile.

  3. Create a name for your connection and a description (optional), then select Continue.

    Add a Synapse connection
  4. Select Use Service Account, or Use OAuth, and enter the connection details for your Synapse data source.

    To use SQL Server with your Synapse connection, select Use Service Account.
    Enter connection details

    For Service Account authentication, do the following:

    • Enter Host, Port, User, Password, and Database.

      SQL Server configuration

      If you are using SQL Server, do the following:

      • For Port, enter 1433.

      • For User, enter the login for your SQL Server database.

      For OAuth authentication, do the following:

      • Enter Host, Port, OAuth Client ID, OAuth Client Secret, Scope, Auth Url, Access token Url, and Database.

      Refer to the Synapse connection reference for more information on each of the specific attributes you must enter for your connection.

  5. (Optional) Provide additional key-value pairs that you need to set up your connection to Synapse or customize additional JDBC parameters supported by Synapse, by doing the following:

    • Select the Advanced Config menu to reveal the Key and Value fields.

    • Enter your key and value information. Refer to Synapse’s JDBC driver reference documentation for information on Synapse’s supported keys and values.

    • To add more keys and values, select the plus sign (+), and enter them.

    Any key-value pairs that you enter must be defined in your Synapse data source. Key-value pairs are case-sensitive.
  6. Select Continue.

  7. Select tables (on the left) and the columns from each table (on the right), and then click Create connection.

    Select tables and columns for your connection

    A message appears indicating the number of tables and columns that will be added to your connection.

  8. Select Confirm.

    After you add the connection, you can search your Synapse database right away by selecting Search now.

    The "Connection created" screen

    Your new connection appears on the Data > Connections page. You can select the name of your connection to view the tables and columns in your connection.

The connection you just created is a link to the external data source. If there are any joins in the selected tables of the external data source, those are imported into ThoughtSpot.

You can now perform a live query on the selected tables and columns of your connection. Because the selected tables and columns in your connection are linked, it may take a while to initially render the search results. This is because ThoughtSpot does not cache linked data. With linked data, ThoughtSpot queries the external database directly, which is slower than querying data that is stored in ThoughtSpot’s database.



Was this page helpful?