Notes de version de Sun Java System Application Server 9.1

Utilisation de la base de données Java DB intégrée

Cette section décrit des instructions d'implémentation de la base de données Java DB intégrée à Application Server 9.1. Java DB est basée sur la base de données Apache Derby.

Ouverture et fermeture de la base de données Java DB

Sun Java System Application Server 9.1 introduit deux nouvelles commandes asadmin pour démarrer et arrêter le serveur réseau Java DB.

Scripts d'utilitaire Java DB


Remarque –

Ces scripts ont été désapprouvés sous Application Server 9.1.


La configuration de Java DB proposée avec Application Server 9.1 comprend également plusieurs scripts utiles vous permettant d'utiliser Java DB. Les scripts suivants sont disponibles dans le répertoire <rép_install_appserver> /javadb/frameworks/NetworkServer/bin :

ProcedurePour configurer l'environnement d'exécution de scripts de l'utilitaire Java DB

  1. Définissez la variable d'environnement DERBY_INSTALL pour que celle-ci pointe vers le répertoire <rép_install_appserver>/javadb.

  2. Annulez le paramétrage de la variable d'environnement CLASSPATH.

  3. Facultativement, vous pouvez également paramétrer les propriétés suivantes :

    1. DERBY_SERVER_HOST sur l'hôte écouté par le serveur réseau.

      Cette propriété peut également être paramétrée sur 0.0.0.0 afin d'activer tous les listener.

    2. DERBY_SERVER_PORT sur le numéro de port écouté par le serveur réseau.

Voir aussi

Pour plus d'informations sur ces utilitaires, reportez-vous aux guides Tools et Admin de Derby.

Exportation de tables de Pointbase vers Java DB

Cet exemple illustre la procédure de capture du DDL pour une table Pointbase sous Commander et de création de la même table sous Java DB à l'aide de NetBeans 5.0. Vous pouvez également utiliser l'outil Commander et la commande unload database :

./startcommander.sh
Do you wish to create a new Database. (Yes (Y) or No (N))? [default: N]: 
Enter product to connect with: (Embedded (E) or Server (S))? [default: E]: e
Enter driver to use? [default: [com.pointbase.jdbc.jdbcUniversalDriver]: 
Enter database URL? [default: [jdbc:pointbase:embedded:sample]: 
Enter Username? [default: PBPUBLIC]: 
Enter Password? [default: PBPUBLIC]: 

PointBase Commander 5.2 ECF build 294 size restricted version EMBEDDED

Interactive SQL command language. SunOS/5.9

(C) Copyright 2004 DataMirror Mobile Solutions, Inc. All rights reserved.

Licensed to: Sun_customer_demo_use
For commercial version contact PointBase at: 
pointbase.com
PHONE: 1-877-238-8798 (US & CANADA)
       1-408-961-1100 (International)
WEBSITE: www.pointbase.com

SQL>unload database sampledb.sql;
SQL> unload database sampledb.sql;
SQL> 13 Row(s) Unloaded. (PBPUBLIC.CUSTOMER_TBL)
SQL> 4 Row(s) Unloaded. (PBPUBLIC.DISCOUNT_CODE_TBL)
SQL> 30 Row(s) Unloaded. (PBPUBLIC.MANUFACTURE_TBL)
SQL> 11 Row(s) Unloaded. (PBPUBLIC.MICRO_MARKETS_TBL)
SQL> 9 Row(s) Unloaded. (PBPUBLIC.OFFICE_TBL)
SQL> 4 Row(s) Unloaded. (PBPUBLIC.OFFICE_TYPE_CODE_TBL)
SQL> 15 Row(s) Unloaded. (PBPUBLIC.ORDER_TBL)
SQL> 6 Row(s) Unloaded. (PBPUBLIC.PRODUCT_CODE_TBL)
SQL> 30 Row(s) Unloaded. (PBPUBLIC.PRODUCT_TBL)
SQL> 10 Row(s) Unloaded. (PBPUBLIC.SALES_REP_DATA_TBL)
SQL> 10 Row(s) Unloaded. (PBPUBLIC.SALES_REP_TBL)
SQL> 52 Row(s) Unloaded. (PBPUBLIC.SALES_TAX_CODE_TBL)
SQL> 12 Table(s) Unloaded.
SQL> quit;

Les résultats de la commande unload database de l'exemple ci-dessus sont renvoyés dans le fichier sampledb.sql. Ce fichier sampledb.sql contient l'ensemble du LDD nécessaire pour créer des tables et index. Il contient également le DML permettant de retransférer les données dans la base de données. La commande RUN vise à importer les données d'une autre base de données Pointbase à l'aide du script généré. Voici un exemple d'affichage des instructions INSERT et des données associées dans le fichier généré :

INSERT INTO "ADVENTURE"."CATEGORY" (
"CATID", "LOCALE", "NAME", "DESCRIPTION", "IMAGEURI" )
VALUES( ?, ?, ?, ?, ? );
{
'ISLAND              ','en_US','Island Adventures','Experience an island /
paradise in a way fit for your needs.','Island_Adventures.gif'
'JUNGLE              ','en_US','Jungle Adventures','Experience a jungle /
paradise in a way fit for your needs.','Jungle_Adventures.gif'
'MOUNTAIN            ','en_US','Mountain Adventures','Experience an /
elevated paradise with a view.','Mountain_Adventures.gif'
'ORBITAL             ','en_US','Orbital Adventures','Experience a vacuum /
paradise with a beautiful view and where no one can hear you scream.', /
'Space_Adventures.gif'
'WESTERN             ','en_US','Western Adventures','Enjoy the Wild West. /
','Western_Adventures.gif'
'SOUTH_POLE          ','en_US','South Pole Adventures','Experience a /
frozen paradise in a way fit for your needs.','SouthPole_Adventures.gif'
};

Vous pouvez aisément modifier le fichier généré à l'aide de la commande unload database afin qu'il ne comporte que le LDD (il serait ainsi simple de développer un programme capable de traiter les instructions insert, par exemple). Pour simplifier, utilisons la commande unload database sur la base de données sample Pointbase, puis modifions le script généré en apportant les modifications suivantes :

Un script Ant simple est ensuite utilisé pour exécuter le LDD avec la cible sql . Enfin, la même expérience est répétée sur la base de données sun-appserv-samples pour laquelle les modifications supplémentaires suivantes doivent être apportées au fichier SQL généré :

La conversion de procédures Java Pointbase pour fonctionner avec Java DB nécessite l'apport de modifications au code Java et aux instructions CREATE PROCEDURE. Des informations sur la création de procédures Java Java DB sont disponibles dans le Manuel de référence Derby. Le type de données Boolean sera pris en charge dans la prochaine version de Java DB.