Wagby はさまざまなデータベースを利用することができます。本ガイドでは、各データベース利用時の注意点やトラブルシューティングについて説明します。
各データベースベンダーから提供されているデータベースドライバファイルを次のフォルダに保存します。
$(DEVHOME)/customize/tomcat/lib
例えば Oracle 利用時は、Wagby-8.x.x/customize/tomcat/lib/ojdbc7.jar というファイルがコピーされている必要があります。
利用するデータベースによって「データベースのURL」項目が補完されます。
「[ホスト名]」の文字列部分をデータベースサーバのホスト名もしくはIPアドレスに、「[DB名]」の文字列部分を(予め用意した)データベースの名前に変更します。
Webサーバとデータベースサーバを同一のマシンにインストールする場合は「ホスト名」の部分は「localhost」と指定します。
ホスト名 "localhost", データベース側に用意したデータベース名 "sampledb" とした場合の、各データベースへの接続URL記述方法は次のとおりです。
| データベース | URL |
|---|---|
| HSQLDB | jdbc:hsqldb:sampledb |
| PostgreSQL | jdbc:postgresql://localhost/sampledb |
| MySQL | jdbc:mysql://localhost/sampledb?useUnicode=true&relaxautoCommit=true |
| Oracle 9i/10g/11g/12c | jdbc:oracle:thin:@localhost:1521:sampledb |
| SQLServer 2012/2014/2016 | jdbc:sqlserver://localhost;databasename=sampledb |
| DB2 | jdbc:db2://localhost:50000/sampledb |
| DB2 AS/400 | jdbc:as400://localhost/wagbydb |
| Firebird | jdbc:firebirdsql://localhost/wagbydb?charSet=UTF-8 |
データベースを切り替える場合、フルビルドが必要です。
(フルビルドはデータベースを切り替えた最初の一回だけ必要です。データベースを切り替えた後は、通常の差分ビルドをお使いいただけます。)
Wagbyの「ビルド」処理によるテーブルの作成は次のようになっています。
"環境>データベース" に "HSQLDB" を選択すると、内蔵データベースが利用されます。トライアルキットや評価用ライセンス利用時は常に内蔵データベースです。
この場合、フルビルドまたはテーブルの変更を伴うモデル定義の修正(項目の追加や削除、改名など)時、現在のテーブルは破棄(drop)され、再作成(create)されます。
開発者はテーブル定義変更前のデータを手動でエクスポートしておき、ビルド後にデータのインポートを行ってください。
init_dbスクリプトを実行すると、テーブルの作成(create) が行われます。 内蔵データベース利用時とは異なり、ビルドのたびに自動的にテーブルを作成することはありません。開発者が必要なタイミングで、init_db スクリプトを実行してください。
最初のテーブルを作成後、テーブルの変更を伴うモデル定義の修正(項目の追加や削除、改名など)を行った場合は、次のいずれかの方法で対応します。
この方法は確実に変更を反映させることができますが、データ量によって処理時間がかかります。
現在のテーブル定義をベースに、変更に関する SQL 命令 (alter) を発行します。処理時間を短縮できますが、変更箇所の漏れがないよう留意してください。
利用するデータベースによって、型の変換ルールが異なります。またデータベース固有の制約もあります。詳細は以下の内容をお読みください。
ビルドしたアプリケーションは Tomcat が提供するコネクションプーリング機構を使っています。
init_dbスクリプトやimport_dbスクリプトが途中で失敗した場合、DDL命令が中途半端に実行された可能性があります。
その後、テーブルの削除をdrop_dbスクリプトで行っても、必要なテーブルや制約がそろっていないために削除も失敗します。結果としていくつかのテーブルが削除できない不正な状態になります。
この場合は各データベースのツールを用いて、テーブルの削除作業を手動で行ってください。詳細は各データベースが提供しているツールの使い方をお読みください。
アプリケーションの入れ替えでは、旧版でexport_dbとdrop_dbを実行し、入替え後の新版でimport_dbを行う必要があります。
例えば旧版では存在したが、新版では存在しないモデルがあった場合は、旧版のdrop_dbを使わないとテーブルを削除することはできません。
Wagbyアプリケーションを起動する前に、データベースは起動しておくようにしてください。この順序が逆の場合、Wagbyアプリケーションはデータベースと接続することができません。[参考 データベース環境 > データベースの自動再接続を有効にする]
外部データベース利用時にエラーが発生した場合、次の手順で切り分けてください。
可能です。詳細は「Wagby Developer Network > 設定ファイル > ログの扱いその他のツールのログ > データベース操作用スクリプトのログ」をお読みください。