Files
Jailer/docs/quicktour.htm

396 lines
16 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head>
<title>Jailer - Quick Tour</title><meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="keywords" content="Data Export Tool">
<meta name="description" content="data export referential integrity java jdbc dbms">
<link rel="shortcut icon" href="favicon.ico">
<link rel="stylesheet" type="text/css" href="architecture-Dateien/styles.css"></head>
<body left-margin="0" top-margin="0">
<div align="left">
<table style="text-align: left; position: absolute; left: 0pt; top: 0pt;" border="0" cellpadding="0" cellspacing="0" height="407" width="100%">
<tbody>
<tr>
<td colspan="2" class="bannerbackground" height="33" width="100%">
<table border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td><img src="architecture-Dateien/logo.png" hspace="10"></td>
<td class="slogan" width="100%">Database&nbsp;Subsetting&nbsp;Tool</td>
<td style="text-align: right; width: 100%;"><table border="0" cellpadding="0" cellspacing="0"><tbody><tr><td><a href="http://sourceforge.net/projects/jailer/"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=197260&amp;type=1" alt="SourceForge.net Logo" style="border: 0px solid ;"></a></td></tr><tr><td><a href="http://www.java.net"><img src="javanet_button_90.gif" alt="java.net Member Button: 90px wide" border="0" height="25" width="90"></a></td></tr></tbody></table></td>
</tr>
</tbody>
</table>
</td>
</tr>
<tr>
<td colspan="2" class="nav1background" height="33" width="100%">&nbsp;
<b><font color="#ffffff"><a href="home.htm" target="_self" class="tlink">Home</a> &nbsp;&nbsp;&nbsp; <a href="quicktour.htm" target="_self" class="tlinkA">Quick Tour</a> &nbsp;&nbsp;&nbsp;<a href="exporting-data.htm" target="_self" class="tlink">Tutorial</a> &nbsp;&nbsp;&nbsp;<a href="data-browsing.html" target="_self" class="tlink">Data Browser</a> &nbsp;&nbsp;&nbsp;<a href="faq.html" target="_self" class="tlink">FAQ</a> &nbsp;&nbsp;&nbsp;<a href="api.html" target="_self" class="tlink">API</a>
&nbsp;&nbsp;&nbsp; <a href="design.htm" target="_self" class="tlink">Documentation</a>
&nbsp;&nbsp;&nbsp; <a href="http://sourceforge.net/forum/?group_id=197260" target="_self" class="tlink">Forum</a>&nbsp;&nbsp;&nbsp; <a href="http://sourceforge.net/project/showfiles.php?group_id=197260" target="_self" class="tlink">Download</a>
&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;</font></b></td>
</tr>
<tr>
<td colspan="2" class="spacer" 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%"><br>
</td>
</tr>
</tbody>
</table>
</center>
</div>
<ul>
<li><a href="quicktour.htm" target="_self" class="llinkA">Quick
Tour</a></li>
</ul>
<table border="0" cellpadding="5" cellspacing="0" width="100%">
<tbody>
<tr>
<td class="content2background"><img style="width: 160px; height: 1px;" alt="" src="architecture-Dateien/vgradp.gif"></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%"><br>
</td>
</tr>
<tr>
<td class="content" height="520" valign="top" width="100%">
<small><small>&nbsp;</small></small><br>
A
quick tour through Jailer.<br>
<h4><br>
Extraction Model Editor</h4>
<img alt="" src="qt1.gif"><br>
<br>
<ol>
<li><span style="font-style: italic;">Subject
table.</span> </li>
<li><span style="font-style: italic;">Subject
condition.</span>
The export process starts with rows of subject table where this
condition
holds.</li>
<li><span style="font-style: italic;">Export format.</span></li>
<li><span style="font-style: italic;">Opens XML settings
dialog.</span></li>
<li><span style="font-style: italic;">Starts
export.</span></li>
<li><span style="font-style: italic;">Export
restrictions.</span> <br>
</li>
<li><span style="font-style: italic;">Focus table.</span>
<br>
</li>
<li><span style="font-style: italic;">Outline of
focus table.</span> <br>
</li>
<li><span style="font-style: italic;">Restrictions
editor. </span>Edit restriction on currently selected
association
here. <br>
</li>
<li><span style="font-style: italic;"></span> <span style="font-style: italic;">Xml mapping editor.</span> Define the XML
structure here.</li>
<li><span style="font-style: italic;">Xml sketch. </span>Gives
you a preview of how the XML will look like.<br>
</li>
<li><span style="font-style: italic;">Model-graph
panel.</span></li>
<ul>
<li><span style="font-style: italic;">Panning</span>.
Drag with left mouse-button.</li>
<li><span style="font-style: italic;">Zooming</span>.
Drag with right mouse-button on empty space.</li>
<li><span style="font-style: italic;">Zoom
in/out.</span> Mouse-wheel&nbsp;down/up.</li>
<li><span style="font-style: italic;">Zoom
to fit. C</span>lick with right mouse-button on empty space.</li>
<li><span style="font-style: italic;">Context
menu</span>. Click with right mouse-button on table.</li>
<li><span style="font-style: italic;">Select
association. C</span>lick with left mouse-button on association.</li>
<li><span style="font-style: italic;">Expand
table</span>. Double-click with right mouse-button on collapsed
table.</li>
<li><span style="font-style: italic;">Collapse
table</span>. Double-click with right mouse-button on expanded
table.</li>
<li><span style="font-style: italic;">Move
table</span>. Drag with left mouse-button on table.</li>
</ul>
<li><span style="font-style: italic;">Currently
selected
association.</span> <br>
</li>
<li><span style="font-style: italic;">Collapsed
table.</span>
Table with hidden associations.</li>
<li><span style="font-style: italic;">Subject
table.</span></li>
<li><span style="font-style: italic;">Aggregation. </span>The
XML render of PROJECT will be aggregated into the XML
render of PROJECT_PARTICIPATION.<br>
</li>
</ol>
<ol>
</ol>
<br>
<br>
<h4>XML Mapping Dialog</h4>
<img style="width: 450px; height: 313px;" alt="" src="qt6.gif"><br>
<br>
<br>
Map columns to XML elements and attributes here.<br>
<br>
<br>
<h4>Data Model Editor</h4>
<img style="width: 674px; height: 269px;" alt="" src="qt2.gif"><br>
<br>
<ol style="font-style: italic;">
<li>List of all tables.</li>
<li>List of all associations.</li>
</ol>
<br>
<br>
<h4>Table Editor</h4>
<p><img style="width: 600px; height: 357px;" alt="" src="qt3.gif"><br>
<br>
</p>
<ol>
<li style="font-style: italic;">Table name.</li>
<li style="font-style: italic;">Columns.</li>
<li><span style="font-style: italic;">Insert/Upsert
selection.</span> Use Upserts if exported rows may already exist
in
the database in which you want to import them.</li>
<li><span style="font-style: italic;">Exclude
from
deletion. </span>If switched-on, no delete-statements will be
generated for the rows of this table.</li>
<li><span style="font-style: italic;">Export
all rows. </span>If
switched-on, all rows of this table will be exported if the table is
directly or indirectly associated with the subject table. This is
essentially a performance optimization. Excluding tables with few rows
which are associated with many other rows can speed-up the
export-process a lot.<br>
</li>
</ol>
<br>
<h4>Association Editor</h4>
<p><img style="width: 476px; height: 224px;" alt="" src="qt4.gif"><br>
<br>
</p>
<ol>
<li style="font-style: italic;">Source table.</li>
<li><span style="font-style: italic;">Type.</span>
"associates", "depends on" and "has dependent".<br>
</li>
<li style="font-style: italic;">Destination
table.</li>
<li><span style="font-style: italic;">Cardinality.</span>
If you're not very sure what the cardinality of the association is, it
is better to leave this field blank!</li>
<li><span style="font-style: italic;">Join
Condition.</span>
Condition which is fulfilled by a pair of rows if and only if the two
rows are associated with each other.</li>
<li><span style="font-style: italic;">Name.</span>
Unique
name of association.<br>
</li>
</ol>
<br>
<h4>Data Export Dialog</h4>
<img alt="" src="qt5.gif"><br>
<br>
<ol>
<li><span style="font-style: italic;">Export
into.</span>
Name of SQL-script containing INSERT-statements for exported rows. If
the name ends with '.zip', then a zip-compressed file will be generated.</li>
<li><span style="font-style: italic;">Generate
delete-script.</span> Name of SQL-script containing
DELETE-statements
for rows to be deleted. If the name ends with '.zip', then a
zip-compressed file
will be generated.</li>
<li><span style="font-style: italic;">Upsert
all rows.</span>
Generate Upsert (Overwrite) Statements for all exported rows instead of
following the table-settings.</li>
<li><span style="font-style: italic;">Explain.</span>
Gerate an explain-log which shows the connection of each exported row
to a subject row. Note that explaining is very expensive. Don't use it
if you are already sure that there are no unintensionally exported rows.</li>
<li><span style="font-style: italic;">Thread.</span>
Number of thread/concurrent connections to be used for export-process.
Set this number to 1 if you encounter problems with concurrent
connections.</li>
<li><span style="font-style: italic;">Rows
per statement.</span>
Maximum number of rows to be inserted with singe INSERT-statement (if
your DBMS supports multi-row inserts).<br>
</li>
</ol>
<br>
<br>
<h4>Menu</h4>
<ul>
<li style="font-style: italic;">File</li>
<ul>
<li><span style="font-style: italic;">New
Model.</span>
Creates new empty extraction model.<br>
</li>
<li><span style="font-style: italic;">Load.</span>
Load
extraction model.<br>
</li>
<li><span style="font-style: italic;">Save.</span>
Saves. extraction model.</li>
<li><span style="font-style: italic;">Save
as...</span>
Asks for file name and saves extraction model.</li>
<li><span style="font-style: italic;">Connect
database.</span>
Connect or Re-connect to a database.<br>
</li>
<li><span style="font-style: italic;">Disconnect.</span>
Disconnect from database.<br>
</li>
<li><span style="font-style: italic;">Exit.</span><br>
</li>
</ul>
<li style="font-style: italic;">Restriction</li>
<ul>
<li><span style="font-style: italic;">Disable
all
associations.</span> Creates a "disabled"-restriction for each
association. Use this if you want to explicitly tell Jailer what you <span style="font-weight: bold;">want</span> to export,
instead of telling
him what you <span style="font-weight: bold;">don't want</span>.<br>
</li>
<li><span style="font-style: italic;">Remove
all
restrictions.</span> Removes all previously defined restrictions
from
model.<br>
</li>
</ul>
<li style="font-style: italic;">View</li>
<ul>
<li><span style="font-style: italic;">Collapse
all. </span>Collapses
all tables in model-graph panel.<br>
</li>
<li><span style="font-style: italic;">Expand
all. </span>Expands
all tables in model-graph panel.</li>
<li><span style="font-style: italic;">Fix
all. </span>Fix
the positions of all tables in model-graph panel.</li>
<li><span style="font-style: italic;">Unfix
all. </span>Unfix
the positions of all tables in model-graph panel.</li>
<li><span style="font-style: italic;">Reset. </span>Resets
model-graph panel so that only subject table is visible.<br>
</li>
<li><span style="font-style: italic;">Zoom
to fix. </span>Sets
zoom scale of model-graph panel so that all tables fits into display<span style="font-style: italic;">.</span><br style="font-style: italic;">
</li>
<li><span style="font-style: italic;">Show table details</span>.
Show/Hide column definitions.<span style="font-style: italic;"></span></li>
<li><span style="font-style: italic;">Show disabled
associations.</span> If enabled, don't show disabled association
and
dont expand over disables associations. You may use <span style="font-style: italic;">Reset</span> + <span style="font-style: italic;">Expand all</span> then to
see the closure
of the subject.<br>
</li>
<li><span style="font-style: italic;">Look&amp;Feel.</span>
Changes the GUI Look&amp;Feel.<br>
</li>
</ul>
<li style="font-style: italic;">Tools</li>
<ul>
<li><span style="font-style: italic;">Export
Data.</span>
Opens Export Data Dialog.<br>
</li>
<li><span style="font-style: italic;">Import
Data. </span>Imports
data into database.<br>
</li>
<li><span style="font-style: italic;">Analyze
Database</span>
Analyzes the database and opens data model editor.<br>
</li>
<li><span style="font-style: italic;">Data
Model Editor.</span>
Opens data model editor.</li>
<li><span style="font-style: italic;">Print
Data Model.</span>
Prints out data model as plain text.<br>
</li>
<li><span style="font-style: italic;">HTML
Rendering. </span>Generates
HTML pages for all tables showing restrictions and associations.<br>
</li>
</ul>
<li style="font-style: italic;">Help</li>
<ul>
<li><span style="font-style: italic;">Content.</span>
Opens web site in browser.<br>
</li>
<li><span style="font-style: italic;">Tutorial. </span>Opens
tutorial page in browser.<br>
</li>
<li><span style="font-style: italic;">Software
Update.</span>
Looks for software update at jailer.sourceforge.net.<br>
</li>
<li><span style="font-style: italic;">About.</span><br>
</li>
</ul>
</ul>
<br>
</td>
</tr>
</tbody>
</table>
</div>
<p><br>
</p>
</td>
</tr>
<tr>
<td height="12" valign="top" width="14%"><br>
</td>
<td><br>
</td>
</tr>
</tbody>
</table>
</div>
</body></html>