Tutorial — Relational Data Browsing

navigate bidirectionally through the database by following foreign-key-based or user-defined relationships with jailer.

the jailer tool can be found at:

• https://github.com/wisser/jailer
• https://sourceforge.net/projects/jailer

you might also like: why you should use a relational database instead of nosql for your iot applications

1. connect with the database

start the data browser (jailerdatabrowser.exe or jailerdatabrowser.bat on windows platform)

$ sh jailerdatabrowser.sh

and create a new data model. press new and enter "tutorial" as the name for the new model.

most of the information can be retrieved automatically by analyzing the database schema.

click on analyze database .

you will be asked for the database connection information.

create a new connection.

select the dbms you are using from the displayed list and fill out the following form:

finally, click on connect . jailer finds seven tables and five associations:

two associations are still missing:

• an employee is classified into a salary grade depending on his salary
• employees may receive bonuses

add the definitions manually (add-button under associations):

2. browse a table

select the menu item "open table" from "file" and choose "employee" as the table you want to browse.

a table browser appears showing the rows of table employee.

3. browse related rows

select the "children" item from the "related rows" drop-down menu and choose "employee on inverse-boss".

another table browser appears showing the subordinates of each employee (the inverse of the "boss" relationship).

4. generate sql-query

within each table browser, a sql-query can be generated which selects exactly the browser's content.
essentially it's a join of all the tables in the navigation chain.

close the second "employee" browser, navigate from employee to project_participation, and from there to project.

choose "query builder" item from the "sql/query" menu in the "project" browser:

the query builder form lets you save the query into a file, copy it to the clipboard or even execute it.
choose "execute" to get a query-result browser:

within this query-result browser, you can edit the query anyway you want.