Getting started

This guide will teach you how to authenticate with Foundry via Tableau, select a dataset, and get started building your first interactive dashboard.

Select Foundry as your data source in Tableau

1. Launch Tableau and select Connect to Data.
2. Under To a Server, click More.
3. Search for and select Foundry by Palantir.

Enter your Foundry URL

In the Foundry by Palantir dialog box, enter your Foundry URL in the Server field. You can find your Foundry URL by logging in, copying the URL, and deleting the https:// prefix as well as anything after .com.

For example, if your Foundry hyperlink is https://myfoundrylink.palantir.com/workspace/home, you should input myfoundrylink.palantir.com into the Tableau prompt.

Authenticate with Foundry

There are two options for authenticating with Foundry: Foundry OAuth or Foundry Token. In most circumstances, we recommend using OAuth for a simpler authentication process.

Foundry OAuth authentication (recommended)

1. Under the Authentication dropdown, select Foundry OAuth.
2. In the OAuth URL field, enter https:// followed by the same URL you entered in the Server field.
3. Select Sign In, and you will be redirected to a login window in your browser.
4. Log in, and then select Allow to authorize Tableau to connect using your Foundry account.
5. Once you are redirected to a webpage with the message "Tableau created this window to authenticate. It is now safe to close it", close the window and return to Tableau Desktop.

Publish a report with OAuth

If you intend to publish your report to Tableau Server with embedded credentials when using OAuth, you first need to configure credentials on Tableau Server by navigating to My Account Settings > Saved Credentials for Data Sources in Tableau Server. Refer to the Tableau documentation on Manage saved credentials for data connections ↗ for more information.

Foundry token authentication

1. Under the Authentication dropdown, select Foundry Token.
2. In the Token field, enter a unique user-generated token.
3. Click Sign In.

After following these instructions, you should now see your Foundry environment listed under Connections in the left sidebar.

Select your dataset

To start working with a specific dataset, use the navigation options in the left sidebar. Under the Database section, select a Foundry Project from the dropdown menu. Then under the Table section, use the search field to find a dataset by its name or full path.

Once you have loaded your dataset, choose the Connection mode (Live or Extract) and continue creating your Tableau dashboard as usual.

High data scale and Tableau Data Extracts

Higher data scale can be processed by using Tableau Data Extracts ↗, and ensuring that queries are "direct read eligible" when processed by Foundry SQL Server. See Architecture for details about direct read functionality.