evitaDB - Fast e-commerce database
logo
page-background

Query our dataset

This article will show you how to connect to our demo instance or spin up a demo instance on your own hardware and experiment with the evitaDB query language.

While it is much better to play with the schema and data that suits your own e-commerce use case, we believe that many of you will want to test the Query API without too much work. Therefore, we have created a sample schema of the virtual e-commerce store with data for more than a thousand products for you to play with right away.

There are two ways in which you can play with this data set:

  1. simple but limited: use our evitaDB.io server instance
  2. more difficult, but without limits: run your own evitaDB server with our dataset

Use our evitaDB.io server instance

We host the demo dataset directly on the evitadb.io site, but to make sure it works reliably for all of you, we had to make it read-only. So you cannot make any changes to it. But you can still use it to test all our web APIs and all supported drivers.
The next limitation is that the server is hosted on cheap shared infrastructure of Contabo hosting (which has been known to buy old servers to provide low-cost hosting services) with following specs:
Server specs
If you experience slow responses, let us know and try evitaDB on your hardware instead.

You can access all our APIs on these addresses:

Run your own evitaDB server with our dataset

This option requires more work, but you will have control over the performance, and you will be able to modify any data in the set. To access the dataset on your hardware, you need to:

  1. download the archive with the dataset
  2. unzip the contents to the data folder

  3. pull the evitaDB docker image

  4. start the evitaDB server

When this procedure is completed you should see the similar output in the console:

It means that your evitaDB server is up and running, and also that it has loaded the evita catalog dataset with some thousands of products.

Connect the Java client

Open your Java IDE and add the following dependency to your project:

Then, create an instance:
After that you can create a new session and try any of the evitaQL queries described in the reference documentation:
For complete instructions on setting up a Java client, see the Java drivers chapter. If you need more hints for querying the data, try the query API chapter.

Author: Ing. Jan Novotný

Date updated: 17.1.2023

Documentation Source