Getting Started with Stardog Cloud
Get jump-started with your private Stardog Cloud Instance
Page Contents
Stardog Cloud provides you with a dedicated Stardog Instance with a custom URL endpoint of your choosing. You get administrative access to manage your Instance. Your custom url will appear in the form https://[custom-name].stardog.cloud. Visit your endpoint to get started.
Logging in For the First Time
After receiving your invitation email with your private Stardog Cloud endpoint you will be able to log in for the first time to begin configuring and using your Stardog Knowledge Graph. If the email address you provided when signing up for the service supports Google Authentication then you can sign in directly using the ‘Sign in with Google’ button (more identity providers will be coming soon). Otherwise, you will be provided with a temporary password which will expire within 24 hours of receiving the invitation message. If you use the password method for your first time log in you will be required to change your password before it expires.
Signing in with Google Authentication
Click ‘Sign in with Google’ if your email account Supports Google OAuth
Signing in with username and password
Click ‘connect’ if you are signing in with a username and password.
Configuring your first users
After logging in for the first time you will be presented with the Stardog Studio Web Interface which will give you access to administer Stardog in addition to many other development and visualization 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.