Wagby はさまざまなデータベースを利用することができます。本ガイドでは、各データベース利用時の注意点やトラブルシューティングについて説明します。
各データベースベンダーから提供されているデータベースドライバファイルを次のフォルダに保存します。
$(DEVHOME)/customize/tomcat/lib
例えば Oracle 利用時は、Wagby-7.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 2005/2008/2012/2014 | jdbc:sqlserver://localhost;databasename=sampledb |
| DB2 | jdbc:db2://localhost:50000/sampledb |
| DB2 AS/400 | jdbc:as400://localhost/wagbydb |
| DBMaster | jdbc:dbmaster:sampledb |
データベースを切り替える場合、フルビルドが必要です。
(フルビルドはデータベースを切り替えた最初の一回だけ必要です。データベースを切り替えた後は、通常の差分ビルドをお使いいただけます。)
check_dbスクリプトを使って、外部データベースに正しく接続できることを確認できます。
R7.0〜R7.3.1をお使いの方は、データベースドライバを配置後、以下の命名規則に従ってファイル名を変更してください。
| データベース | データベースドライバファイル名(改名後) |
|---|---|
| PostgreSQL | postgresql.jar |
| MySQL | mysql-connector-java.jar |
| Oracle 9i/10g/11g/12c | ojdbc14.jar (※ ojdbc5.jar/ojdbc6.jar/ojdbc7.jar ではなく ojdbc14.jar に改名してお使い下さい) |
| SQLServer 2005/2008/2012/2014 | sqljdbc.jar (※ sqljdbc4.jar を sqljdbc.jar に改名してお使い下さい) |
| DB2 |
db2jcc.jar (db2jcc4.jar を db2jcc.jar に改名してお使い下さい)
db2jcc_license_cu.jar (ホストへの接続などDB2 Connectを使用する場合) |
| DB2 AS/400 | jt400.jar |
R7.3.2 以降のWagbyでは、ここで説明した「ファイル名を改名する」手順は不要です。
利用するデータベースによって、型の変換ルールが異なります。またデータベース固有の制約もあります。詳細は以下の内容をお読みください。
ビルドしたアプリケーションは Tomcat が提供するコネクションプーリング機構を使っています。
Commons DBCP については、こちらのサイトが参考になります。
http://www.limy.org/program/java/commons_dbcp.html
コネクションプーリングを Tomcat JDBC Pool に変えることができます。この場合、Wagbyのリポジトリに設定した値ではなく、カスタマイズして保存された設定ファイル (server.xml) に記載される値が有効になります。
参考文献「Commons DBCPを超えるTomcat JDBC Poolとは」
http://www.atmarkit.co.jp/ait/articles/1111/07/news212_2.html
init_dbスクリプトやimport_dbスクリプトが途中で失敗した場合、DDL命令が中途半端に実行された可能性があります。
その後、テーブルの削除をdrop_dbスクリプトで行っても、必要なテーブルや制約がそろっていないために削除も失敗します。結果としていくつかのテーブルが削除できない不正な状態になります。
この場合は各データベースのツールを用いて、テーブルの削除作業を手動で行ってください。詳細は各データベースが提供しているツールの使い方をお読みください。
アプリケーションの入れ替えでは、旧版でexport_dbとdrop_dbを実行し、入替え後の新版でimport_dbを行う必要があります。
例えば旧版では存在したが、新版では存在しないモデルがあった場合は、旧版のdrop_dbを使わないとテーブルを削除することはできません。
Wagbyアプリケーションを起動する前に、データベースは起動しておくようにしてください。この順序が逆の場合、Wagbyアプリケーションはデータベースと接続することができません。[参考 データベース環境 > データベースの自動再接続を有効にする]
外部データベース利用時にエラーが発生した場合、次の手順で切り分けてください。
可能です。詳細は「Wagby Developer Network(R7) > 設定ファイル > ログの扱いその他のツールのログ > データベース操作用スクリプトのログ」をお読みください。