Get in touch
Get in touch

Creating a Dataset

To create a Dataset click on the Create New Dataset tile on your current project's datasets page. You will be to select the classes of Concepts you want your Dataset to contain.

Each Dataset can hold concepts for as many classes of things in your domain as you wish.

The Dataset has no semantic value, but is important in how you organize and manage your data.

Typically you may name your Dataset after the types of things you want to store inside it.

You can store all or just a subset of your graph data in each Dataset. For example if you have a class Person you might define a Dataset called People and store all the instances of Person inside.

The other key benefits of Datasets is privacy and data security. A Dataset can be public or private, and this determines access rights to the data within via the Data Graphs API. A public Dataset can be queried and accessed just using an API key. A private Dataset can only be accessed with full machine-2-machine oAuth authentication.

Step 1: Dataset settings

Choose an appropriate name for the Dataset, an example would be to name it after the collection of Concepts that it will contain. You need to name it unambiguously. The namespace for the Dataset is a URN and is set automatically – urn:test:countries in the example below. The namespace is also important as this will be used as part of the API endpoint URL if you want to access this Dataset via the API.

Choose whether the Dataset is public or private with respect to API access. A public Dataset can be accessed using the API from any client on the internet using an API key. A private Dataset can only be accessed using the API with OAuth / OpenID authentication. 

When you are happy with the main settings, click Add Types to configure the Concept types you want the Dataset to contain.

Step 2: Adding classes

Next you must add one or more types of Concepts that you want to include in the Dataset. We call this the Dataset Schema. You don't have to be exhaustive at this point as you can edit your schema at any stage before you add your data.

Choose the first type you want to add, either selecting a type you have already defined or one of Data Graphs' own types, or create a brand new type. In the example below we are naming a new type Country as we want to include Country Concepts in the Dataset. When happy, click the Add Type button.