Create a Data Source

Admins can create, configure, and manage Data Sources. See Configure Data Source Authentication to learn how to enable methods of authentication other than basic authentication for Data Sources that support them.

Create a Data Source as an admin

Unlike regular users, Admins can expose their Data Sources to all or a subset of users. If you create a Data Source as a user, you must specify the users or organizations that can access the Data Source.

Go to Manage Resources > Data Sources.
Click Connect to External Data.
Select your Data Source.
Enter the configuration details for accessing your Data Source. The details vary depending on your Data Source type.
Select the 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. Data source credentials are stored securely in the Domino secret store which is backed by HashiCorp Vault.
  OAuth authentication is not supported for service accounts. End users are not distinguished by the Data Source itself upon usage, as the same credentials are used to authenticate all queries.
Enter your credentials for Data Source authentication.
Click Test Credentials to verify that authentication works, or click Skip for Now to continue.
Select whether Everyone can use this Data Source or just Specific users or organizations.
Click Finish Setup.

Starburst-powered Data Sources

Unlike other Data Sources, Starburst-powered Data Sources require an administrator to configure since they require an admin to restart the Starburst cluster in Domino. To enable Starburst-powered Data Sources in your Domino instance, add the following block to domino.yaml and agent.yaml.

release_overrides:
starburst-enterprise:
  installed: true

Configure Starburst-powered Data Sources has information about how you can configure Starburst-powered Data Sources (including MongoDB, Palantir Foundry, Tabular S3 with AWS Glue, Starburst JDBC, and Teradata) as an admin. For additional support in working with Starburst, please contact your Domino representative.

Starburst cluster restarts

You must restart the Starburst cluster in Domino after performing the actions including, but not limited to:

Creating the Data Source
Updating the Data Source configuration
Updating credentials

Domino notifies you to restart your Starburst cluster and provides a convenient link to trigger the restart. Restarting the Starburst cluster disrupts executions that interact with Starburst-powered Data Sources, so plan accordingly.

Starburst Data Source limitations

Your Domino representative must enable this feature. If you do not see these Data Source types in your deployment, contact your Customer Success engineer.
In a hybrid deployment, Starburst-powered Data Sources are only available from the local data plane.

Nexus hybrid Data Plane accessibility

Nexus hybrid deployments have a few caveats regarding data plane accessibility for Data Sources. Starburst-powered Data Sources can only be used in local data planes. The following table shows accessibility configuration settings for different Data Source types:

Data Source Type	Remote Data Plane(s)	Local Data Plane
Domino native Data Sources using individual credentials	Automatically accessible and unconfigurable.	Automatically accessible and unconfigurable.
Domino native Data Sources using service account credentials	Accessible with the ability to disable access from any or all remote data planes.	Accessible with the ability to disable access.
Starburst-powered Data Sources	Unsupported.	Supported.

You can disable adding a Data Source in remote workspaces. For more information, please reach out to Domino Support.