外部データベース利用時には、ここに示すスクリプトを使ってテーブル管理を自動化できます。Windows OS は拡張子 ".bat" を、Unix OS は拡張子 ".sh" を使ってください。
ビルドしたアプリケーションであるwagbyapp/binフォルダに用意されています。
次のコマンドを入力することで、外部データベースとの接続テストを行うことができます。
> check_db.bat
コマンドの結果は同一フォルダ内の check_db.txt に出力されます。同ファイルの内容をチェックしエラーが発生していないことを確認してください。
接続テストが成功すれば check_db.txt 内に次のようなデータベース及びJDBCドライバの情報が出力されます。
... getDatabaseProductName=HSQL Database Engine getDatabaseProductVersion=2.0.0 ... getDriverName=HSQL Database Engine Driver getDriverVersion=2.0.0 ...
ビルドしたアプリケーションであるwagbyapp/binフォルダに用意されています。
次のコマンドを入力することで、テーブルの作成ならびに初期データの登録を行うことができます。
> init_db.bat
コマンドが正常に実行されると、次のように表示されます。
Command: auto All table enabled Config File:.\conf\initdb.xml Log4j Property File: default file. import seq 11/11 at 0 sec. process 11 at 0 sec. ... ...(省略) import juser 2/2 at 0 sec. process 2 at 0 sec. ...
ビルドしたアプリケーションであるwagbyapp/binフォルダに用意されています。
次のコマンドを入力することで、現在のテーブルの値をエクスポート(外部ファイルとして出力)することができます。
> export_db.bat ..\..\export\data_xxxx
出力先は $(APPHOME)/export フォルダ以下になります。
ビルドしたアプリケーションであるwagbyapp/binフォルダに用意されています。
次のコマンドを入力することで、外部データベース上の(Wagbyに関する)データ及びテーブル定義を削除します。
> drop_db.bat
$(APPHOME)/binフォルダに用意されています。
次のコマンドを入力することで、テーブルの作成ならびに、エクスポートフォルダ内のデータ一式を外部データベースに読み込むことができます。
> import_db.bat ..\..\export\data_xxxx
migrate_db コマンドは、スキーママイグレーション機能を提供します。(内部では flyway を使っています。)
現在、稼働しているデータベースのテーブル定義(旧)と、入れ替えようとしているアプリケーション wagbyapp に含まれるテーブル定義(新)の差分をとり、差を埋めるための SQL (alter table 命令) を発行します。
"環境 > データベース > メイン > 環境" の "列にデフォルト値を設定する" を有効にしてください。(サブデータベースでも利用する場合、同様にサブデータベースの "列にデフォルト値を設定する" を有効にしてください。)
wagbyapp/bin フォルダに含まれる migrate_db.bat を実行します。次の処理が行われます。
リポジトリを変更し、ビルドすると新しい wagbyapp が用意されます。その後に再度 migrate_db.bat を実行すると、テーブル定義の差分が自動適用されます。
本機能は MySQL (5.7以上) と PostgreSQL (9.4以上) で利用できます。それ以外のデータベースではご利用いただけません。
R8.5.0 以降の Wagby で対応しています。
flyway での履歴管理をやめる場合は次のコマンドを入力します。
> migrate_db.bat clean
これにより $(DEVHOME)/migratedb 及び flyway_schema_history テーブルが削除されます。
必須項目には自動的にデフォルト値がセットされます。Wagbyが生成するDDL(create table)のカラムに定義されたデフォルト値が使われます。
"新" の方に順序が新しく用意された場合、マイグレーションによって順序も作成されます。
各スクリプト実行時に "Out Of Memory" (メモリ不足) というエラーメッセージが表示されることがあります。この場合、次のように対応します。
-Xmx512m標準では "512m" (512メガバイト)となっています。この値を大きくし、ファイルを保存します。(例 1024m とする。)