> ## Documentation Index
> Fetch the complete documentation index at: https://docs.domino.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Starburst-powered Data Sources

These Data Source types are powered by Starburst and require an administrator to configure. See [Create a Data Source](/6.3/admin/data-administration/external-data/create-data-sources) to enable Starburst-powered Data Sources in your Domino instance before following the steps for a specific connector below.

<Tabs>
  <Tab title="MongoDB">
    Create a Data Source for [MongoDB](https://www.mongodb.com/) that your Domino users can access. Only administrators can create this type of Data Source.

    ## Prerequisites

    * Starburst needs to be enabled in the deployment. If not enabled, please follow the instructions to [enable Starburst-powered Data Sources](/6.3/admin/data-administration/external-data/create-data-sources#starburst-powered-data-sources).

    * You must have network connectivity between MongoDB 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 MongoDB Data Source

    1. Go to **Manage Resources** > **Data Sources**.

    2. Click **Connect to External Data**.

    3. In the New Data Source window, select **MongoDB**.

    4. Enter your MongoDB hostname or IP address.

    5. Optional: Enter the **Port**.

    6. Enter a **Name** and **Description** for this Data Source.

    7. Click **Next** twice.

    8. Enter your MongoDB credentials.

    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 to restart the cluster.

            <Tip>
              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.
            </Tip>

    12. Click **Click here to trigger a restart**.

    13. When prompted to confirm the cluster restart, click **Restart Cluster**. The restart takes approximately 5-10 minutes. When the restart is complete, Domino users can use the MongoDB Data Source.
  </Tab>

  <Tab title="Palantir">
    Create a Data Source for [Palantir Foundry](https://www.palantir.com/platforms/foundry/) that your Domino users can access.

    <Note>
      Only administrators can create this type of Data Source.
    </Note>

    ## Prerequisites

    * [Starburst needs to be enabled in the deployment](/6.3/admin/data-administration/external-data/create-data-sources#starburst-powered-data-sources).

    * 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

    To 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.

           <Note>
             Individual Credentials can only use **OAuth Tokens** to authenticate.
           </Note>

    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.

    The restart takes approximately 5-10 minutes. When the restart is complete, Domino users can [use the Palantir Data Source](/6.3/platform-capabilities/core-concepts/data/data-source-connectors/connect-to-palantir).

    ## Get Palantir Client Credentials

    To connect to Palantir using a Service Account with Client Credentials you will need to retrieve your Palantir client ID and client secret:

    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](https://www.palantir.com/docs/foundry/platform-security-third-party/register-3pa/index.html). 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.

    If your Domino-Palantir integration has already been created and you cannot see your client secret, contact your Palantir administrator.

    ## Generate Palantir OAuth token

    To connect to Palantir using a OAuth token, generate a new [Palantir token](https://www.palantir.com/docs/foundry/platform-security-third-party/user-generated-tokens/#generation).

    ## Next steps

    After your Domino administrator creates the Data Source, learn how to [connect to Palantir as a user](/6.3/platform-capabilities/core-concepts/data/data-source-connectors/connect-to-palantir).
  </Tab>

  <Tab title="Tabular S3 with AWS Glue">
    You can create a Data Source for [tabular S3 with AWS Glue](https://docs.aws.amazon.com/athena/latest/ug/data-sources-glue.html) that your Domino users can access. Only administrators can create this type of Data Source, and only service accounts are supported.

    ## Prerequisites

    * Starburst needs to be enabled in the deployment. If not enabled, please follow the instructions to [enable Starburst-powered Data Sources](/6.3/admin/data-administration/external-data/create-data-sources#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.

            <Tip>
              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.
            </Tip>

    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.
  </Tab>

  <Tab title="Starburst JDBC">
    Domino Data Sources can leverage the vast capabilities of Starburst’s JDBC connection to connect to any Starburst-JDBC data entity. Enjoy all the benefits of [Domino Data Sources](/6.3/platform-capabilities/core-concepts/data/data-source-connectors) with expanded connectivity through Starburst JDBC.

    The following Starburst JDBC-based data entities are enabled by default:

    * IBM DB2

    * IBM Netezza

    * SAP HANA

    ## Prerequisites

    Starburst needs to be enabled in the deployment. If not enabled, please follow the instructions to [enable Starburst-powered Data Sources](/6.3/admin/data-administration/external-data/create-data-sources#starburst-powered-data-sources).

    ## Create a Starburst JDBC-powered Data Source

    To create a Starburst JDBC-powered Data Source, you must have network connectivity between the data platform and your Domino deployment.

    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.

            <Tip>
              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.
            </Tip>

    ## Add Starburst JDBC data entities

    Not all JDBC-powered data entities are available by default. You can enable additional JDBC data entities such as the following:

    * ClickHouse

    * Druid

    * Greenplum

    * MariaDB

    * Ignite

    * SingleStore (MemSQL)

    * Synapse

    * Vertica

    * Generic JDBC capability provided by Starburst

    <Note>
      You may need to contact your Customer Success engineer for assistance to add some additional JDBC data entities.
    </Note>

    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:

       ```console theme={null}
       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.

    You should now be able to see the newly added data entity in the drop-down list.
  </Tab>

  <Tab title="Teradata">
    You can create a Data Source for [Teradata](https://www.teradata.com/) that your Domino users can access. Only administrators can create this type of Data Source.

    ## Prerequisites

    * Starburst needs to be enabled in the deployment. If not enabled, please follow the instructions to [enable Starburst-powered Data Sources](/6.3/admin/data-administration/external-data/create-data-sources#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.

            <img src="https://mintcdn.com/dominodatalab-e871cec4/O7LjTllMke2wnkZN/images/5.3/starburst-cluster-restart-prompt.png?fit=max&auto=format&n=O7LjTllMke2wnkZN&q=85&s=7920f3558fee44c7aca9937c5d4ef1c4" alt="Starburst cluster restart prompt" width="852" height="64" data-path="images/5.3/starburst-cluster-restart-prompt.png" />

            <Tip>
              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.
            </Tip>

    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.

    <Note>
      Users must specify the database name in their queries, as in this example where `td_demo` is the database name and `yellow_cab` is the table name:

      ```
      example res = ds.query("select * from td_demo.yellow_cab")
      ```
    </Note>
  </Tab>
</Tabs>

## Next steps

* Learn about the general admin flow in [Create a Data Source](/6.3/admin/data-administration/external-data/create-data-sources).

* Learn how to enable other authentication methods in [Configure Data Source Authentication](/6.3/admin/data-administration/external-data/configure-ds-auth).
