Connect to Stardog

The Stardog Enterprise Knowledge Graph Platform provides a foundation for a flexible semantic data layer designed to answer complex queries across data silos.

You can integrate your Databricks SQL warehouses (formerly Databricks SQL endpoints) and Databricks clusters with Stardog.

Connect to Stardog using Partner Connect

Note

Partner Connect only supports integrating SQL warehouses with Stardog. To integrate a cluster with Stardog, connect to Stardog manually.

To connect to Stardog using Partner Connect, do the following:

  1. Connect to semantic layer partners using Partner Connect.

  2. In your Stardog account, follow the prompt to update your Stardog profile. Check the boxes to agree to the Stardog terms of use and privacy policy, then click Update.

  3. Click Get a Stardog Cloud Instance.

  4. Click Start Free, check the box to agree to the Stardog terms of service, then click Checkout.

  5. Under Action, click the three-dot menu, then click Create datasource.

    The Manage Databricks Datasource dialog opens.

  6. Optionally edit the data source name, then click Create Datasource.

    You can find videos about how to use starter kits with sample data in your Stardog account, or you can click your Databricks connection to access Stardog applications to start modeling your data.

Connect to Stardog manually

This section describes how to connect to Stardog manually.

Note

You can use Partner Connect to simplify the connection experience for a SQL warehouse.

Requirements

Before you connect to Stardog manually, you need the following:

  • A cluster or SQL warehouse in your Databricks workspace.

  • The connection details for your cluster or SQL warehouse, specifically the Server Hostname, Port, and HTTP Path values.

  • A Databricks personal access token. To create a personal access token, do the following:

    1. In your Databricks workspace, click your Databricks username in the top bar, and then select User Settings from the drop down.

    2. Click Developer.

    3. Next to Access tokens, click Manage.

    4. Click Generate new token.

    5. (Optional) Enter a comment that helps you to identify this token in the future, and change the token’s default lifetime of 90 days. To create a token with no lifetime (not recommended), leave the Lifetime (days) box empty (blank).

    6. Click Generate.

    7. Copy the displayed token to a secure location, and then click Done.

    Note

    Be sure to save the copied token in a secure location. Do not share your copied token with others. If you lose the copied token, you cannot regenerate that exact same token. Instead, you must repeat this procedure to create a new token. If you lose the copied token, or you believe that the token has been compromised, Databricks strongly recommends that you immediately delete that token from your workspace by clicking the trash can (Revoke) icon next to the token on the Access tokens page.

    If you are not able to create or use tokens in your workspace, this might be because your workspace administrator has disabled tokens or has not given you permission to create or use tokens. See your workspace administrator or the following:

    Note

    As a security best practice when you authenticate with automated tools, systems, scripts, and apps, Databricks recommends that you use OAuth tokens.

    If you use personal access token authentication, Databricks recommends using personal access tokens belonging to service principals instead of workspace users. To create tokens for service principals, see Manage tokens for a service principal.

Steps to connect

To connect to Stardog manually, do the following:

  1. Create a Stardog account.

  2. In your Stardog account, follow the prompt to update your Stardog profile. Check the boxes to agree to the Stardog terms of use and privacy policy, then click Update.

  3. Follow the prompt to verify your email address.

  4. Click Get a Stardog Cloud Instance.

  5. Click Start Free, check the box to agree to the Stardog terms of service, then click Checkout.

  6. Click your Databricks connection.

  7. Click Stardog Studio.

    Stardog Studio opens in a new tab.

  8. Click Data.

  9. Click + Data source.

  10. In the Add Data Source dialog box, enter a name for your data source.

  11. For Data Source Type, select Databricks and Spark SQL from the drop-down list.

  12. For JDBC Connection URL, enter the connection details from the requirements.

  13. For JDBC Username, enter token.

  14. For JDBC Password, enter the personal access token from the requirements.

  15. For JDBC Driver Class, enter com.simba.spark.jdbc.Driver.

  16. Click Add.

Next steps

  1. Create Knowledge Graph models in Stardog Designer.

  2. Visualize models in Stardog Explorer.

Additional resources

Explore the following Stardog resources: