Skip to content

Quickstart

Follow the following steps to start predicting in SQL straight away. Check out our Getting Started Guide for trying MindsDB with your data or model.

1. Create an Account

Create your free MindsDB Cloud account.

Local Installation

Follow our Docker instructions. if you prefer to proceed with a local installation.

2. Connect MindsDB to a MySQL Client

You can use the MindsDB SQL Editor or open your preferred MySQL client and connect it to MindsDB.

Just log in to your account, and you will be automatically directed to the Editor.

To connect to MindsDB from another SQL client use cloud.mindsdb.com as a host, 3306 port and your MindsDB Cloud credentials for username/password. 

  "user":[your_mindsdb_cloud_username],
  "password:"[your_mindsdb_cloud_password]",
  "host":"cloud.mindsdb.com",
  "port":"3306"

If you do not already have a preferred SQL client, we recommend DBeaver Community Edition.

3. Connecting a Database CREATE DATABASE

For this quickstart, we have already prepared some example data for you. To add it to your account, use the CREATE DATABASE syntax by copying and pasting this command into your SQL client:

CREATE DATABASE example_data
WITH ENGINE = "postgres",
PARAMETERS = { 
  "user": "demo_user",
  "password": "demo_password",
  "host": "3.220.66.106",
  "port": "5432",
  "database": "demo"
}

On execution, you should get:

Query OK, 0 rows affected (3.22 sec)

4. Previewing Available Data

You can now preview the available data with a standard SELECT. To preview the Home Rentals dataset, copy and paste this command into your SQL client:

SELECT * 
FROM example_data.demo_data.home_rentals
LIMIT 10;

On execution, you should get:

+-----------------+---------------------+------+----------+----------------+---------------+--------------+--------------+
| number_of_rooms | number_of_bathrooms | sqft | location | days_on_market | initial_price | neighborhood | rental_price |
+-----------------+---------------------+------+----------+----------------+---------------+--------------+--------------+
| 0.0             | 1.0                 | 484  | great    | 10             | 2271          | south_side   | 2271         |
| 1.0             | 1.0                 | 674  | good     | 1              | 2167          | downtown     | 2167         |
| 1.0             | 1.0                 | 554  | poor     | 19             | 1883          | westbrae     | 1883         |
| 0.0             | 1.0                 | 529  | great    | 3              | 2431          | south_side   | 2431         |
| 3.0             | 2.0                 | 1219 | great    | 3              | 5510          | south_side   | 5510         |
| 1.0             | 1.0                 | 398  | great    | 11             | 2272          | south_side   | 2272         |
| 3.0             | 2.0                 | 1190 | poor     | 58             | 4463          | westbrae     | 4124         |
| 1.0             | 1.0                 | 730  | good     | 0              | 2224          | downtown     | 2224         |
| 0.0             | 1.0                 | 298  | great    | 9              | 2104          | south_side   | 2104         |
| 2.0             | 1.0                 | 878  | great    | 8              | 3861          | south_side   | 3861         |
+-----------------+---------------------+------+----------+----------------+---------------+--------------+--------------+

5. Creating a Predictor CREATE PREDICTOR

Now you are ready to create your first predictor. Use the CREATE PREDICTOR syntax by copying and pasting this command into your SQL client:

CREATE PREDICTOR mindsdb.home_rentals_predictor
FROM example_data
  (SELECT * FROM demo_data.home_rentals)
PREDICT rental_price;

Query OK, 0 rows affected (9.79 sec)

6. Checking the Status of a Predictor

A predictor may take a couple of minutes for the training to complete. You can monitor the status of your predictor by copying and pasting this command into your SQL client:

SELECT status
FROM mindsdb.predictors
WHERE name='home_rentals_predictor';

On execution, you should get:

+----------+
| status   |
+----------+
| training |
+----------+
Or:

+----------+
| status   |
+----------+
| complete |
+----------+

Predictor Status Must be 'complete' Before Making a Prediction

7. Making a Prediction via SELECT

The SELECT syntax will allow you to make a prediction based on features. Make your first prediction by copying and pasting this command into your SQL client:

SELECT rental_price
FROM mindsdb.home_rentals_predictor
WHERE number_of_bathrooms=2 AND sqft=1000;

On execution, you should get:

+--------------+
| rental_price |
+--------------+
| 1130         |
+--------------+

Congratulations

If you got this far, you have trained a predictive model using SQL and have used it to tell the future!