Add a BigQuery connection

Before you can create a connection, you must create a custom role. For more information, see Prerequisites.

To connect to BigQuery:

  1. Click Data in the top navigation bar.

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

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

    Add a GBQ connection
  4. Enter the connection details for your BigQuery data source using either OAuth or service account authentication.

    For OAuth authentication, do the following:

    1. Enter Project id, OAuth Client ID, and OAuth Client Secret.

      Enter connection details
    2. If you wish to provide the optional additional key-value pairs for your BigQuery connection, complete the procedure in step 5, and then click Continue. If not, click Continue.

    3. At the Google account sign-in screen, select your Google account.

    4. Allow access to your Google account by clicking Allow, and then go to step 7 to select tables for your connection.

      Using security passthrough may have implications for your Row Level Security. See About row level security (RLS) for more information.

    For service account authentication, do the following:

    • Enter Project id, and Service account.

      Enter connection details

      Refer to the BigQuery 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 BigQuery or customize additional JDBC parameters supported by BigQuery, by doing the following:

    1. Click the Advanced Config menu to reveal the Key and Value fields.

    2. Enter your key and value information. Refer to the GBQ JDBC documentation.

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

    Any key-value pairs that you enter must be defined in your BigQuery data source. Key-value pairs are case-sensitive.
  6. Click 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. Click Confirm.

    Once the connection is added, you can search your BiqQuery database right away by clicking Search now.

    The "Connection created" screen

    Your new connection appears on the Data > Connections page. You can click 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.

You can modify a BigQuery connection in the following ways:

See the Connection reference for details of connection parameters.