Quick Start

A quick start to the RKGMS using the RAI Console.

This quick start guide describes how you can begin working with our Relational Knowledge Graph Management System (RKGMS) using the RelationalAI Console. The Console has everything you need to use the RKGMS.

Logging into the RAI Console

Before beginning this tutorial, the account manager needs to setup an user account for you. Once this is done, you need only access to your registered email account.

To access the Console:

  1. Go to https://console.relationalai.com/ and click Login.
  2. In the page that opens, enter your email address.
  1. Confirm your email credentials. This is normally just the password of your email account, but may vary depending on your organization.

    1. The first time you access the RAI Console, you will need to set up a two-step verification process and enter a code generated by your one-time password application (like Duo Mobile or Google Authenticator). On this first use, you will need to open the authentication application and point your phone’s camera at the QR code on the screen.

    2. Once you do so, your authentication application will give you a code that you must enter to finish the setup process for your two-step verification. (This is separate from confirming your credentials on the RAI Console.)

  2. Enter the one-time password code from your two-step verification application to complete the login process.

The first time you login, you will receive an email asking that you verify your RAI account.

  1. Open the email and click Verify Your Account

  2. Return to https://console.relationalai.com/

After you have completed logging in, the RAI Console homepage opens:

The homepage lists any databases that have been previously created under this account. Note, multiple users can have access to the same account.

Choosing or Creating an Engine

The RKGMS separates data storage from computation to achieve unlimited scaling. In the RAI Console, data storage is represented by databases, and computation by engines. A engine is a virtual machine running in a cloud service provider (such as Microsoft Azure), which executes your database transactions. At the top of the Console, you can see your RAI account(s) along with all currently available engines.

All databases require an engine to run. To create or use a database, you must choose or create an engine.

To choose an engine, select it from the pull-down menu at the top of the RAI Console homepage. If no engine is available, you need to create one.

To add a new engine:

  1. Click the Engine icon on the left side of the RAI Console homepage.
  2. On the page that opens, enter a name for the new engine, select XS for size, and click Create.

A engine is ready to use once it is successfully provisioned.

Creating a Database

Now that you have chosen or created an engine, you can open or create a database.

Databases are containers for both data and logic. Databases also contain notebooks, which can be used to write reactive Rel programs in a web browser, with no software required other than the browser itself.

To open an existing database, click its name on the homepage.

To create a new database:

  1. Click the Database icon on the left side of the RAI Console homepage.
  2. On the page that opens, click Create.
  3. Enter a name for the new database.
  4. Select an engine from the Engine pull-down menu at the top right of the RAI Console homepage. (If no engines are available, you need to create one following the steps above.)
  5. Click Create.

Once the database is successfully created, it will be listed in the Database tab with the status CREATED.

Creating a Notebook

Finally, you need to open or create a notebook.

To create a notebook:

  1. Click the Database icon on the left side of the RAI Console homepage.
  2. Select an engine from the Engine pull-down menu at the top right of the RAI Console homepage. (If no engines are available, you need to create one following the steps above.)
  3. In the page that opens, click the name of a database to open it. (If no databases are listed, you need to create one following the steps above.)
  4. Enter a name for the new notebook.
  5. Click Create.

The notebook opens and you can begin working in Rel.

Start Modeling in Rel

You can test the notebook by entering the following code in the first cell and clicking the Run button (the triangle at the right of the input pane) or pressing SHIFT + ENTER.

query
def k = 1; 2; 3
def output = k

You should see the output below.

That should be all you need to get started with the RAI Console.