About Domino
Domino Data LabKnowledge BaseData Science BlogTraining

Connect to Palantir Foundry

Learn how to connect to Palantir Foundry from Domino. You must have network connectivity between Palantir and your Domino deployment.

Create a Palantir Foundry Data Source

The easiest and most secure way to connect to Palantir from Domino is to have your administrator create a Data Source for Palantir Foundry for users to access.

After your administrator has created the Data Source, you can use the Data Source as usual.

Note

You must specify the dataset path, obtained from the Dataset Preview in Palantir, in your query as shown in this example:

example res =  ds.query('SELECT * FROM "/namespace/project"."/namespace/project/path/to/your/dataset"')

Connect using individual user credentials

You can also choose to use individual user credentials to connect to Palantir. However, you should contact your Palantir admin to ensure this method is compliant with your organization’s governance policies.

To connect to Palantir Foundry using this method, you must have the following:

  • A Palantir Foundry account.

  • An access token.

  • A path to the Dataset.

Create an access token

  1. Sign in to Palantir Foundry.

  2. In the Foundry sidebar, click Account and select Settings.

  3. Under User settings, click Tokens.

    Palantir UI on the Tokens page

  4. Click Create token.

  5. Copy the user token and save the token string. You can store it as an environment variable in Domino.

Copy the dataset path

  1. In the Palantir Foundry application, go to the Project containing the dataset and select the dataset.

  2. In the About section, copy the Location attribute.

    Tip
    		 You can also copy and use the RID field as a permalink to this dataset.

  3. Save the location path or RID string to store as an environment variable in Domino.

Add environment variables to Domino

You can store your Palantir connection information securely in Domino as environment variables in your user or project settings.

  1. Sign in to Domino.

  2. Click User or Project settings.

  3. Click Environment Variables.

  4. Add the PALANTIR_TOKEN environment variable with the value of the user token you created in Foundry.

  5. Add the PALANTIR_HOSTNAME environment variable with the value of your Foundry instance hostname.

See Secure Credential Storage to learn more about Domino environment variables.

Add the Palantir-SDK package to your environment

Some Domino Workspace Environments have the palantir-sdk package installed by default. You can also add Dockerfile commands to the environment definition to add packages:

RUN pip install -user palantir-sdk

You can also create a cell at the top of a Jupyter Notebook and run the following:

pip install palantir-sdk

Run your code

You can now access your Palantir Foundry data through Python, from a Jupyter notebook or VS Code.

Jupyter notebook accessing a Palantir dataset and using the Palantir SDK

Next steps