OutsidesqlTestタスク
OutsidesqlTestタスクとは？
外だしsQLを 2Way-sQLとして実際にDBに実行 して、sQLのチェックを行うDBFluteタスクです。
ディベロッパーが実装した外だしsQLを気軽にチェックするという役割だけでなく、 外だしsQLへのDB変更時の影響を調べる のにも利用できます。
図 : OutsidesqlTestタスクの概念図
主な実行タイミング
- 外だしsQLの実装中 (ディベロッパー)
- DB変更の発生 (アーキテクト)
- DBFluteアップグレード直後 (アーキテクト)
- 本番運用後のDB変更 (アーキテクト)
実行コマンド
DBFluteクライアント配下の outsidesqltest.(bat|sh) をコマンドから実行します。
環境構築
DBFluteのセットアップが終わった時点から利用できます。
処理概要
OutsidesqlTestタスクを実行すると処理が始まります。
1. 外だしsQLを参照
sQLの読み込み対象は、sql2Entityタスクと同じです。
2. パラメータコメントをチェック
パラメータコメントの文法チェックを行います。 簡易なチェックだけではありますが、アプリケーションを実行してからの画面実行経由での発見よりもずっとコストは下がります。
sql2Entityマークのチェック
sql2Entityマークのケアレスミスなどをチェックします。例えば、コロンがセミコロンになっていたり、m が n になっていたり、ありがちなチェックをしています。
パラメータコメントのパース可否
パラメータコメントがパース可能かどうかをチェックします。主に IFコメントのケアレスミス や ENDコメントの不足 を検知します。
外だしsQLのタイトル (オプション)
外だしsQLのタイトル が記述されているか否かをチェックします。これは outsidesqlDefinitionMap.dfprop で設定するオプションであり、プロジェクトのポリシーとして外だしsQLのタイトルを必須にしたい場合 に有効です。
外だしsQLの説明 (オプション)
外だしsQLの説明 が記述されているか否かをチェックします。これは outsidesqlDefinitionMap.dfprop で設定するオプションであり、プロジェクトのポリシーとして外だしsQLの説明を必須にしたい場合 に有効です。
3. 外だしsQLを(2Way-sQLとして)実行
読み込んだsQL(select文)を そのまま実行 します。よって、実行されるsQLは 2Way-sQL 形式となっていなければなりません(2Way-sQLになっているかのチェックにもなっています)。
sQLエラーがあっても中断はせず、全てのsQLが実行されて、最後にログに結果が一覧として表示されます。 一つでもsQLエラーがあればタスクはFAILUREとして終了します。 sQLに不具合がある場合は、タスクの実行ログで原因を確認して修正してから 再度実行して下さい。
また、全てトランザクション内の実行で必ずロールバックされます。
実行対象外sQL
デフォルトでは読み込まれた全てのsQLが実行されますが、どうしてもOutsidesqlTestで実行されてほしくないsQLがある場合に、特別に OutsidesqlTestでの実行対象から外すマークがあります。
sql2EntityマークのCustomizeEntityマークの形式で、クラス名部分に df:x と指定すると、OutsidesqlTestでの実行対象外になります。これを OutsidesqlTest除外マーク と呼びます。
e.g. ある外だしsQLをOutsidesqlTestでの実行対象外にする @sQL-File
-- #df:x#
truncate table MEMBER;
同時にsql2EntityタスクでもこのsQLが実行されることはありません。
トランザクションでロールバックできないsQLに有効です。例えば、truncate文やcreate文です。
様々なオプション
sql2Entityタスクと同様に様々なオプションがあります。
