Configure Starburst-powered Data Sources

​

Prerequisites

• Starburst needs to be enabled in the deployment.
• You must have network connectivity between Palantir and your Domino deployment.
• Domino must enable this feature. If you do not see this Data Source type in your deployment, contact your Customer Success Manager.

​

Create a Palantir Data Source

1. Go to Manage Resources > Data Sources.
2. Click Connect to External Data.
3. In the New Data Source window, select Palantir.
4. Enter a Name, Description, Palantir hostname or IP address. Optionally: Enter the Port.
5. Select between Individual or Service Account Credential type.
   • Individual - each user, when they are granted access to the Data Source, must provide their own credentials before using a Data Source.
   • Service Account - Domino administrators provide a set of static credentials that will be automatically applied on behalf of all users with permissions to a given Data Source. End users cannot access or extract the credentials, nor can they manage user-level permissions on such Data Sources.
6. Select between Client Credentials and OAuth Token for authenticating to Palantir.
   Individual Credentials can only use OAuth Tokens to authenticate.
7. Enter your Palantir credentials. See the following section to learn how to retrieve your Client Credentials.
8. Select whether Everyone can access this Data Source or just Specific users or organizations.
9. Domino alerts you to restart the cluster. Click Click here to trigger a restart > Restart Cluster. You must restart your Starburst cluster after any configuration changes. Perform the restart when no executions are running that interact with Starburst-powered Data Sources.

​

Get Palantir Client Credentials

1. Go to your Palantir instance.
2. Navigate to Control Panel > Third-party applications. If a Domino integration already exists you will see it here.
3. Next to the Domino integration, select Actions > Manage application to find your client ID. If a Domino integration does not exist, register Domino as a third-party application. Make sure you choose Confidential client as the client type and save the client secret. You will not be able to view your secret again, so store your secret securely.

​

Generate Palantir OAuth token

​

Next steps

​

Prerequisites

• Starburst needs to be enabled in the deployment. If not enabled, please follow the instructions to enable Starburst-powered Data Sources.
• You must have network connectivity between S3 and your Domino deployment.
• Domino must enable this feature. If you do not see this Data Source type in your deployment, contact your Customer Success Manager.

​

Create a Data Source for S3 with AWS Glue

1. Go to Manage Resources > Data Sources.
2. Click Connect to External Data.
3. In the New Data Source window, select Tabular S3 with AWS Glue.
4. Enter your S3 account ID, database, and region.
5. Enter a name for this Data Source.
6. Click Next. In the Credential Type screen, Service Account is pre-selected. Individual accounts are not supported for this type of Data Source.
7. Click Next.
8. Enter your S3 service account access key ID and secret access key.
9. Click Next.
10. Select whether Everyone can access this Data Source or just Specific users or organizations.
11. Click Finish Setup. Domino alerts you that a cluster restart is needed.
    You must restart your Starburst cluster after any configuration changes. Perform the restart when no executions are running that interact with Starburst-powered Data Sources.
12. Click Click here to trigger a restart. Domino prompts you to confirm that you want to restart the cluster.
13. Click Restart Cluster. The restart takes approximately 5-10 minutes. When the restart is complete, Domino users can use the new Data Source.

• IBM DB2
• IBM Netezza
• SAP HANA

​

Prerequisites

​

Create a Starburst JDBC-powered Data Source

1. Go to Manage Resources > Data Sources.
2. Click Connect to External Data.
3. Select the data entity you want to connect to under the Powered by Starburst JDBC section.
4. Enter the appropriate connection parameters.
5. Enter the Data Source Name and optionally provide a Description to explain the purpose of the Data Source to others.
6. Select the credential type.
7. Optionally, enter your credentials. You can choose to enter these later.
8. Click Next.
9. Select whether Everyone can access this data source or just Specific users or organizations.
10. Click Finish Setup. To finish setup, you must restart the cluster. Domino will alert you that a cluster restart is needed and provide a link to restart the cluster.
    The restart takes approximately 5-10 minutes and disrupts any interactions with Starburst-powered Data Source. Plan on performing the restart when no executions are running that interact with Starburst-powered data sources.

​

Add Starburst JDBC data entities

• ClickHouse
• Druid
• Greenplum
• MariaDB
• Ignite
• SingleStore (MemSQL)
• Synapse
• Vertica
• Generic JDBC capability provided by Starburst

1. Go to Admin > Platform settings > Configuration records.
2. Add or edit the following config option com.cerebro.domino.datasource.starburstJdbc.enabledConnectors.
3. Add a comma-separated list of data-entity names as the value for the config option:
   clickhouse,druid,db2,synapse,greenplum,ignite,mariadb,singlestore,vertica,generic_jdbc,sap_hana,netezza
   
4. Restart the Domino services to apply the new setting, following the prompt on the admin page.

​

Prerequisites

• Starburst needs to be enabled in the deployment. If not enabled, please follow the instructions to enable Starburst-powered Data Sources.
• You must have network connectivity between Teradata and your Domino deployment.
• Domino must enable this feature. If you do not see this Data Source type in your deployment, contact your Customer Success Manager.

​

Create a Teradata Data Source

1. Go to Manage Resources > Data Sources.
2. Click Connect to External Data.
3. In the New Data Source window, select Teradata.
4. Enter your Teradata hostname or IP address.
5. Enter a name for this Data Source.
6. Click Next.
7. Select the credential type.
8. Optionally, enter your Teradata credentials. You can choose to enter these later.
9. Click Next.
10. Select whether Everyone can access this Data Source or just Specific users or organizations.
11. Click Finish Setup. Domino alerts you that a cluster restart is needed.
    You must restart your Starburst cluster after any configuration changes. Perform the restart when no executions are running that interact with Starburst-powered Data Sources.
12. Click Click here to trigger a restart. Domino prompts you to confirm that you want to restart the cluster.
13. Click Restart Cluster. The restart takes approximately 5-10 minutes. When the restart is complete, Domino users can use the new Data Source.

example res = ds.query("select * from td_demo.yellow_cab")