Files
Jailer/docs/data-browsing.html
2018-10-30 10:02:22 +01:00

199 lines
8.5 KiB
HTML

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Jailer - Data Browsing</title>
<meta content="text/html; charset=us-ascii" http-equiv="Content-Type" />
<meta content="Data Export Tool" name="description" />
<link href="favicon.ico" rel="shortcut icon" />
<meta content="data export referential integrity java jdbc dbms" name="keywords" />
<link href="exporting-data-Dateien/styles.css" rel="stylesheet" type="text/css" />
</head>
<body left-margin="0" top-margin="0">
<div align="left">
<table border="0" cellpadding="0" cellspacing="0" height="407" style="left: 0pt; top: 0pt; text-align: left; position: absolute;" width="100%">
<tbody>
<tr>
<td class="bannerbackground" colspan="2" height="33" width="100%">
<table border="0" cellpadding="4" cellspacing="0" width="100%">
<tbody>
<tr>
<td><img hspace="10" src="exporting-data-Dateien/logo.png" /></td>
<td class="slogan" width="100%">Database&nbsp;Subsetting&nbsp;Tool</td>
<td style="width: 100%; text-align: right;">
<table border="0" cellpadding="4" cellspacing="0" width="100%">
<tbody>
<tr>
<td><a href="http://sourceforge.net/projects/jailer/"><img alt="SourceForge.net Logo" src="http://sflogo.sourceforge.net/sflogo.php?group_id=197260&amp;type=1" style="border: 0px solid currentColor; border-image: none;" /></a></td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
</td>
</tr>
<tr>
<td class="nav1background" colspan="2" height="33" width="100%">&nbsp; <b><font color="#ffffff"><a class="tlink" href="home.htm" target="_self">Home</a> &nbsp;&nbsp;&nbsp; <a class="tlink" href="quicktour.htm" target="_self">Quick Tour</a> &nbsp;&nbsp;&nbsp;<a class="tlink" href="exporting-data.htm" target="_self">Tutorial</a> &nbsp;&nbsp;&nbsp;<a class="tlinkA" href="data-browsing.html" target="_self">Data Browser</a> &nbsp;&nbsp;&nbsp;<a class="tlink" href="faq.html" target="_self">FAQ</a> &nbsp;&nbsp;&nbsp;<a class="tlink" href="api.html" target="_self">API</a> &nbsp;&nbsp;&nbsp; <a class="tlink" href="design.htm" target="_self">Documentation</a> &nbsp;&nbsp;&nbsp; <a class="tlink" href="http://sourceforge.net/forum/?group_id=197260" target="_self">Forum</a>&nbsp;&nbsp;&nbsp; <a class="tlink" href="http://sourceforge.net/project/showfiles.php?group_id=197260" target="_self">Download</a> &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;</font></b></td>
</tr>
<tr>
<td class="spacer" colspan="2" width="100%"></td>
</tr>
<tr>
<td class="lmenucontainer" height="100%" valign="top" width="14%">
<div align="center">
<center>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tbody>
<tr>
<td width="100%">&nbsp;</td>
</tr>
</tbody>
</table>
</center>
</div>
<ul>
<li><a class="llinkA" href="data-browsing.html" target="_self">Data Browser</a></li>
</ul>
<table border="0" cellpadding="5" cellspacing="0" width="100%">
<tbody>
<tr>
<td class="content2background"><img alt="" src="architecture-Dateien/vgradp.gif" style="width: 160px; height: 1px;" /></td>
</tr>
</tbody>
</table>
<p>&nbsp;</p>
</td>
<td class="contentbackground" height="418" valign="top" width="86%">
<div align="right">
<table border="0" cellpadding="0" cellspacing="0" height="542" width="98%">
<tbody>
<tr>
<td class="contentbackground" height="21" width="100%">&nbsp;</td>
</tr>
<tr>
<td class="content" height="520" valign="top" width="100%"><small><small>&nbsp;</small></small><br />
<span style="font-weight: bold;">Relational Data Browsing</span><br />
<br />
Navigate bidirectionally through the database by following foreign-key-based or user-defined relationships<br />
<br />
<img src="data-browser.gif" /><br />
<br />
&nbsp;
<h4>1. Connect with the Database</h4>
Start the Data Browser (<span style="font-family: monospace;">JailerDataBrowser.exe</span> or <span style="font-family: monospace;">jailerDataBrowser.bat</span> on windows platform)
<table border="0" cellpadding="0" cellspacing="0" style="width: 100%; text-align: left;">
<tbody>
<tr>
<td style="vertical-align: top; background-color: rgb(230, 255, 230);"><span style="font-family: monospace;">$ sh jailerDataBrowser.sh</span></td>
</tr>
</tbody>
</table>
<br />
and create a new data model. Press <span style="font-style: italic;">New</span> and enter &quot;Tutorial&quot; as the name for the new model.
<p><img alt="" src="screenshot4.1.gif" style="width: 697px; height: 280px;" /></p>
<p><br />
A data model holds information about the tables in the database and all associations between them.<br />
Most of the information can be retrieved automatically by analyzing the database schema.<br />
<br />
Click on <span style="font-style: italic;">Analyze Database</span>.<br />
You will be asked for the database connection information.</p>
<p><img alt="" src="screenshot4.2.gif" style="width: 655px; height: 328px;" /></p>
<p>Create a new connection.</p>
<p><img alt="" src="dbs1.gif" style="width: 409px; height: 316px;" /><br />
&nbsp;</p>
<p>Select the DBMS you are using from the displayed list, and fill out the following form:</p>
<img alt="" src="screenshot4.3.gif" style="width: 570px; height: 369px;" />
<p><br />
Finally click on <span style="font-style: italic;">Connect</span><span style="font-style: italic;">.</span> Jailer finds seven tables and five associations:<br />
<br />
<img src="exporting-data-Dateien/screen3.png" /><br />
<br />
<br />
Two associations are still missing:</p>
<ul>
<li>an employee is classified into a salary grade depending on his salary</li>
<li>employees may receive bonuses</li>
</ul>
<br />
Add the definitions manually (<big><span style="font-family: monospace;"><span style="font-family: mon;"><span style="font-style: italic;">Add</span>-</span></span></big>Button under <big><span style="font-family: monospace;"><font size="4">Associations</font></span></big>):<br />
<br />
<img src="exporting-data-Dateien/screen4.png" /><br />
<br />
<img src="exporting-data-Dateien/screen42.png" /><br />
<br />
The data model is&nbsp;now complete.
<p>&nbsp;</p>
<h4>3. Browse a Table</h4>
Select the menu item &quot;Open Table&quot; from &quot;File&quot; and choose &quot;EMPLOYEE&quot; as the table you want to browse:
<p>A Table Browser appears showing the&nbsp;rows of table EMPLOYEE.</p>
<p><img alt="" src="dbs6.gif" /></p>
<h4>&nbsp;</h4>
<h4><br />
<br />
3. Browse related Rows</h4>
Select the &quot;Children&quot; item from the &quot;Related Rows&quot; drop-down menu and choose &quot;EMPLOYEE on inverse-BOSS&quot;.<br />
<br />
<img alt="" src="dbs8.gif" /><br />
<br />
<br />
Another Table Browser appears showing the subordinates of each Employee (the&nbsp;inverse of the &quot;BOSS&quot; relationship)<br />
<br />
<img alt="" src="dbs7.gif" /><br />
<br />
<br />
<br />
&nbsp;
<h4>3. Generate SQL-Query</h4>
Within each table browser, a SQL-Query can be generated which selects exactly the browser&#39;s content.<br />
Essentially it&#39;s a join of all the tables&nbsp;in the navigation chain.
<p>Close the second &quot;EMPLOYEE&quot; browser, navigate from EMPLOYEE to PROJECT_PARTICIPATION, and from there to&nbsp;PROJECT.</p>
<p>Choose &quot;<span style="font-style: italic;">Query Builder</span>&quot; item from the &quot;<span style="font-style: italic;">SQL/Query</span>&quot; menu in the &quot;PROJECT&quot; browser:</p>
<p><img alt="" src="dbs9.gif" /></p>
<p><br />
The Query Builder form lets you save the query into a file, copy it to the clipboard &nbsp;or even execute it.<br />
Choose &quot;Execute&quot; to get a query-result browser:</p>
<img alt="" src="dbs10.gif" style="width: 990px; height: 667px;" />
<p><br />
Within this query-result browser, you can edit the query&nbsp;anyway you want.</p>
<p><img alt="" src="dbs11.gif" style="width: 810px; height: 519px;" /></p>
<p>&nbsp;</p>
</td>
</tr>
</tbody>
</table>
</div>
<p>&nbsp;</p>
</td>
</tr>
<tr>
<td height="12" valign="top" width="14%">&nbsp;</td>
<td>&nbsp;</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>