Getting Started with Stardog Cloud
Get jump-started with your private Stardog Cloud Instance
Page Contents
Stardog Cloud is our complete Enterprise Knowledge Graph Platform provided as a SaaS service. As a part of your subscription, you get a dedicated Stardog Instance and and your account will have administrative access to your new environment. For more information on Stardog Cloud please visit our website
Signing Up for Stardog
Before getting a Stardog Cloud environment, you need to create your Stardog Account. Simply go to here to get started. Creating an account is free and takes only a minute.
Subscribing to Stardog Cloud
Once you have a Stardog Account and have verified your email, you can begin associating Connections to Stardog Instances to your account. Select the “Add a new Connection” option from the Connection menu in the main navigation or head to our getting started page to purchase.
Logging in For the First Time
Once you have purchases 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 Account will be updated and your new Instance will be accessible.
Configuring your first users
Log into your Stardog Account and navigate to the server you wish to manage. From there, launch Stardog Studio our Knowledge Graph IDE which you can use to administer Stardog in addition to its many development-focused features. Your initial user will have administrative access to manage Stardog including:
- create new users and roles
- delete the users and roles that you have created
- create new databases
- write to existing databases
- delete databases
- manage 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
We recommend that for any programmatic access to Stardog Cloud you create dedicated service account users 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 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.
Accessing API Endpoint
In addition to the Stardog Studio Web Interface you can access your Stardog 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 endpoint. 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 stardog and stardog-admin commands can be used regardless of 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.
- What is a Knowledge Graph- 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
- Analyzing COVID-19 Data with SPARQL - analyze the New York Times open source COVID-19 dataset using Stardog Sandbox
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 trainings below. Additional trainings are available on our trainings page.
-
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
-
Reasoning with RDF Graphs and Ontologies
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 – customers should file a support ticket or work directly with their Customer Success Manager.
Community
Need some help? Want to be part of the Stardog Community? Our Community page is a great resource to discuss Stardog and Stardog Studio, make support requests, ask questions, etc.
Stardog Labs
Recently 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.