Getting Started with Stardog Cloud
Get jump-started with your private Stardog Cloud Instance
Page Contents
- Signing Up for Stardog Cloud
- Subscribing to Stardog Cloud
- Logging in For the First Time
- Configuring your first users
- Supported Data Sources
- Accessing API Endpoint
- Getting Stardog Cloud Service Status Information
- Getting Started Resources
- Blogs
- Tutorials
- Video Trainings
- Getting Support
- Community Forum
- Stardog Labs
Stardog Cloud is our complete Enterprise Knowledge Graph Platform provided as a service. As a part of your subscription, you get a dedicated Stardog instance and your account will have administrative access to your new environment. You also get easy access to the Stardog Applications: Explorer, Designer, and Studio. For more information on Stardog Cloud please visit our website
Signing Up for Stardog Cloud
Before getting a Stardog Cloud environment, you need to create your Stardog Cloud Account. Simply go to the Stardog Cloud Portal here to get started. Creating an account is free and takes only a minute.
Subscribing to Stardog Cloud
Once you have created a Stardog Cloud Account and have verified your email, you can create a connection to a Stardog instance. Select the “Add a new Connection” option from the Stardog Connections menu in the main navigation bar, or head to our getting started page.
On the getting started page, you can purchase an Essentials Stardog instance, or you can start your trial with a Free Stardog instance. Only one Free instance can be allocated per Stardog Cloud Account.
Logging in For the First Time
Once you have confirmed your subscription, the environment will be provisioned for you and associated with your account. As soon as the new instance is available for use, your Stardog Cloud Account will be updated and your new instance will be available in your list of connections on the Stardog Cloud Portal.
Configuring your first users
Log into your Stardog Cloud Account and click the connection to the Stardog instance you wish to manage. From there, launch Stardog Studio, our Knowledge Graph IDE. With Studio you can administer your Stardog instance and create users. Your initial user will have administrative access to manage Stardog including:
- creating new users and roles
- deleting the users and roles that you have created
- creating new databases
- writing to existing databases
- deleting databases
- managing virtual graphs
- and more
Stardog uses role based access control (RBAC) similar to many traditional databases. To grant additional team members access we recommend that you provision additional users with access that is limited appropriately. For example, you could provision a new user that has the role reader
(a role automatically configured by Stardog Cloud) for a new user you wish to be able to view data but not alter it.
Creating a new user
Note that a Stardog Server user in your instance is not related to the Stardog Cloud Account used to log in to the Stardog Cloud Portal. The former authenticates a user with the instance itself, while the latter allows access to the Stardog Cloud Portal, where you can configure connections to multiple Stardog Server instances.
After creating a Stardog Server user with Studio, you can provide the username, password, and URL for the instance to a person who has created a Stardog Cloud Account; that person can then create a connection to the Stardog Server instance using the username, password, and URL that you provided.
We recommend that for any programmatic access to your Stardog instance you create a dedicated service account user and then limit the service account access to the minimum required by the application.
We recommend reviewing the Stardog permissions model to fully understand what is possible.
Much of the Stardog security documentation refers to configuring Stardog Server Authentication securely for on-premises deployments. With Stardog Cloud your endpoint is configured by default to follow security best practices.
Supported Data Sources
Each Stardog instance running in Stardog Cloud is pre-configured with the client libraries needed to access the following data sources.
Database | Driver | License |
---|---|---|
AWS Athena | AthenaJDBC42_2.0.7.jar (*) | Apache 2.0 |
Databricks/Spark SQL | SparkJDBC42.jar | Custom |
MongoDB | mongo-java-driver-3.8.2.jar | Apache 2.0 |
MySQL & MariaDB | mysql-connector-java-8.0.25.jar | GPLv2 |
PostgreSQL | postgresql-42.2.5.jar | BSD 2 Clause |
Snowflake | snowflake-jdbc-3.13.25.jar (*) | Apache 2.0 |
Drivers marked with an asterisk (*) are included with each Stardog instance, and they are known to work with Stardog, but they are currently being Beta-tested in Stardog Cloud.
You can read more about using a data source with a Virtual Graph in Stardog here.
Accessing API Endpoint
In addition to using the Stardog Applications, you can access your Stardog instance via its REST API endpoint directly at:
https://[custom-name].stardog.cloud:5820
Access to the API endpoint is done via HTTP basic authentication over SSL. The API endpoint can be accessed via the administrative CLI tool stardog-admin
and data access CLI tool stardog
. For complete reference documentation on these tools refer to the Stardog Admin CLI Reference and Stardog CLI Reference. Once you have the CLI installed you can use it to manage your Stardog instance. For example to list databases:
$ stardog-admin --server https://[custom-name].stardog.cloud:5820 db list
CLI tools macOS Homebrew
To install Stardog via Homebrew, use the following command:
$ brew install stardog-union/tap/stardog
Homebrew will take care of the installation for you including adding Stardog’s /bin
folder to your PATH so that the stardog
and stardog-admin
commands can be used regardless of the current working directory.
CLI tools Debian Based Systems
To install Stardog CLI using apt-get
run the following commands:
$ curl http://packages.stardog.com/stardog.gpg.pub | apt-key add
$ echo "deb http://packages.stardog.com/deb/ stable main" >> /etc/apt/sources.list
$ apt-get update
$ apt-get install -y stardog[=<version>]
This will first add the Stardog gpg key to the systems and then fetch and install the latest Stardog deb package.
Stardog binaries should now be in the /opt/stardog
directory.
CLI tools RPM Based systems
To install Stardog using yum
run the following commands:
$ curl http://packages.stardog.com/rpms/stardog.repo > /etc/yum.repos.d/stardog.repo
$ yum install -y stardog[-<version>]
Stardog binaries should now be in the /opt/stardog
directory.
CLI tools Amazon Linux
Certain Amazon EC2 instances do not let you redirect output into /etc/yum.repos.d
as specified above. On such instances you can install Stardog like so:
$ sudo yum-config-manager --add-repo http://packages.stardog.com/rpms/stardog.repo
$ sudo yum-config-manager --enable stardog
$ yum install -y stardog[-<version>]
CLI tools for Windows
-
Download the distribution.
-
Unzip the file and open a command prompt. Tools are located in
bin/
directory
Getting Stardog Cloud Service Status Information
We provide a Stardog Cloud Service Dashboard at https://status.stardog.com. This dashboard displays information about the current service incidents and uptime history.
Getting Started Resources
Blogs
We’ve highlighted some of our foundational blogs below. Additional blog posts are available on our blogs page. While these blog posts are more high level in nature, Stardog Labs contains our engineering blog.
- How Knowledge Graphs Work - Provides the foundation for the problems Stardog aims to solve.
- Learning SPARQL with Interactive Tutorials - Provides an overview of the interactive tutorials embedded in Stardog Studio.
- Knowledge Graphs and Machine Learning - Provides an overview of using a Stardog Knowledge Graph to improve the results from your Machine Learning algorithms.
Tutorials
We’ve highlighted some of our foundational tutorials below. Additional tutorials are available on our tutorials page.
- RDF Graph Data Model - Learn about the RDF graph model used by Stardog.
- Learn SPARQL - Write Knowledge Graph queries using SPARQL with step-by-step examples. If you are not familiar with Stardog and Stardog Studio, we recommend reviewing the Getting Started Part 1: Introduction to SPARQL prior to completing this.
Getting Started Series
- Getting Started Part 0: Introduction to the Knowledge Graph - Learn foundational concepts about the Knowledge Graph.
- Getting Started Part 1: Introduction to SPARQL - Put Knowledge Graph concepts in-action using SPARQL.
- Getting Started Part 2: Six degrees of Kevin Bacon - Solve the classic Kevin Bacon problem using Stardog.
Video Trainings
We’ve highlighted some of the foundational training videos below. Additional trainings are available on our trainings page.
-
Getting Started with RDF & SPARQL
Learn about:
- The basics of the RDF graph model
- How to build a simple SPARQL query, step-by-step
- Stardog’s SPARQL extension to find shortest paths
- More advanced SPARQL features like optional values, negation and aggregation
-
Learn about:
- What reasoning means and how it relates to data modeling
- The basics of reasoning with RDFS and OWL ontologies
- How to use user-defined rules for inferring new types and edges in RDF graphs
- Using reasoning with SPARQL queries inside Stardog Studio
- How logical reasoning relates to statistical reasoning and machine learning
-
Learn about:
- The basics of RDF data validation
- The core features of the SHACL language
- How SHACL validation interacts with RDFS/OWL reasoning
- Stardog’s integrity constraint validation capability for validating SHACL constraints
Getting Support
Please use the appropriate channel to request support. Enterprise customers should file a support ticket or work directly with their Customer Success Manager. Free and Essentials customers can get support in our Stardog Community Forum.
Community Forum
Need some help? Want to be part of the Stardog Community? Our Community Forum is a great resource to discuss Stardog, Stardog Cloud, and the Stardog Applications (Designer, Explorer, and Studio), make support requests, ask questions, etc.
Stardog Labs
Launched in the Summer of 2020, Stardog Labs is a new hub of insight, news, and buzz about knowledge graph technology. The site features technical blogs, showcasing job opportunities focused on knowledge graph development, and curating research papers and open source projects.
While Stardog Labs will serve as our Engineering blog, it’s also designed for participation from our community of Stardog users, academic researchers, and knowledge graph enthusiasts.