JavaDB / Derby Installation

Zuerst müssen Sie ein ZIP oder TAR-Archiv von der Derby Home-Page herunterladen und in ein beliebiges Verzeichnis extrahieren. Im lib-Verzeichnis sind alle Derby-JARs untergebracht und im Verzeichnis javadoc die Dokumentation.

Derby braucht eine Java-Laufzeitumgebung. Damit Derby problemlos gestartet werden kann, ist es sinnvoll den Pfad zu dem bin-Verzeichnis der Java-Laufzeitumgebung in die Pfad-Umgebungsvariable aufzunehmen. Wenn der Pfad korrekt gesetzt ist, können Sie die Java-Version mit folgendem Befehl abfragen:

java -version

Wenn alles korrekt konfigiriert ist, erscheint folgende oder einen ähnliche Ausgabe:

java version "1.4.2_04"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_04-b05)
Java HotSpot(TM) Client VM (build 1.4.2_04-b05, mixed mode)


Damit die Hilfsprogramme ausgeführt werden können, müssen verschieden Java-Archive in den Klassenpfad aufgenommen werden. Wir gehen davon aus, dass Derby im Verzeichnis c:\derby installiert ist. Dies kann auf einer Windows-Maschine wie folgt gemacht werden:

set DERBY_INSTALL=c:\derby\lib
set CLASSPATH=%DERBY_INSTALL%\derby.jar;%DERBY_INSTALL%\derbytools.jar;%CLASSPATH%

Natürlich können Sie den Klassenpfad und die Umgebungsvariable "DERBY_INSTALL" fix in der Systemsteuerung unter System und Umgebungsvariabel Konfigurieren.

Wenn die Umgebungsvaribalen korrekt gesetzt sind, können Sie das Programm sysinfo aufrufen, welches diverse Informationen bezüglich Ihrer Konfiguration und Klassenpfade anzeigt.

java org.apache.derby.tools.sysinfo
------------------ Java Information ------------------
Java Version:    1.4.2_04
Java Vendor:     Sun Microsystems Inc.
Java home:       C:\j2sdk1.4.2\jre
Java classpath:  c:\derby\lib\derby.jar;c:\derby\lib\derbytools.jar
OS name:         Windows XP
OS architecture: x86
OS version:      5.1
Java user name:  user
Java user home:  C:\Documents and Settings\user
Java user dir:   C:\
--------- Derby Information --------
[C:\derby\lib\derby.jar] 10.0.2.1 - (106978)
[C:\derby\lib\derbytools.jar] 10.0.2.1 - (106978)
------------------------------------------------------
----------------- Locale Information -----------------
------------------------------------------------------

Ein weiteres Hilfsprogramm ist ij. ij ist ein interaktives JDBC-Scripting Werkzeug, mit welchem Sie direkt SQL-Befehle auf einer Datenbank absetzen können. ij können Sie wie folg aufrufen:

java -Dij.protocol=jdbc:derby: org.apache.derby.tools.ij

Hier eine kleine Beispielsitzung mit ij:

java -Dij.protocol=jdbc:derby: org.apache.derby.tools.ij
ij version 10.0
ij> connect 'jdbc:derby:testdb;create=true';
ij> create table mytable (name varchar(50));
0 rows inserted/updated/deleted
ij> insert into mytable values ('Derby');
1 row inserted/updated/deleted
ij> select * from mytable;
NAME
--------------------------------------------------
Derby

1 row selected
ij> exit;