Skip to main content
Version: 0.5.1

How to use relational backend storage


Before the version 0.5.0, Gravitino only supports KV backend storage to store metadata. Since RDBMS is widely used in the industry, starting from the version 0.5.0, Gravitino supports using RDBMS as relational backend storage to store metadata. This doc will guide you on how to use the relational backend storage in Gravitino.

Relational backend storage mainly aims to the users who are accustomed to using RDBMS to store data or lack available a KV storage, and want to use Gravitino.

With relational backend storage, you can quickly deploy Gravitino in a production environment and take advantage of relational storage to manage metadata.

What kind of backend storage are supported

Currently, relational backend storage supports the JDBCBackend, and uses MySQL as the default storage for JDBCBackend.

How to use


  • MySQL 5.7 or 8.0.
  • Gravitino distribution package.
  • MySQL connector Jar (Should be compatible with the version of MySQL instance).

Step 1: Get the initialization script

You need to download and unzip the distribution package firstly, please see How to install Gravitino.

Then you can get the initialization script in the directory:


The script name is like schema-{version}-mysql.sql, and the version depends on your Gravitino version. For example, if your Gravitino version is 0.6.0, then you can choose the latest version script file that is equal or smaller than 0.6.0, you can choose the schema-0.5.0-mysql.sql script.

Step 2: Initialize the database

Please create a database in MySQL in advance, and execute the initialization script obtained above in the database.

Step 3: Place the MySQL connector Jar

You should download the MySQL connector Jar for the corresponding version of MySQL you use (You can download it from the maven-central-repo), which is name like mysql-connector-java-{version}.jar.

Then please place it in the distribution package directory:


Step 4: Set up the Gravitino server configs

Find the server configuration file which name is gravitino.conf in the distribution package directory:


Then set up the following server configs: = relational = JDBCBackend = ${your_jdbc_url} = ${your_driver_name} = ${your_username} = ${your_password}

Step 5: Start the server

Finally, you can run the script in the distribution package directory to start the server:

./${GRAVITINO_HOME}/bin/ start