dbmaintian

dbmaintain的应用

 

参考文件：http://www.dbmaintain.org/overview.html。

 

项目中想用dbmaintain来自动管理数据库脚本，但网上相关资料太少，除了官方http://www.dbmaintain.org/overview.html。 所以本人根据官方网站，把自己的尝试经验给分享一下，请多多指正。好了，废话少说，创建一个例子，然后再说明细节以及注意的地方。

一创建例子(在这里我选用java代码来做，除此之外还有ant, 命令行)
1， 巧妇难为无米之炊，先下载需要用到的jar包，https://sourceforge.net/projects/dbmaintain/files/ 目前最新版本dbmaintain-1.0.1-src.zip 解压缩之后就可看到一个lib目录，里面的两个jar包等下就是我们要用的。

2， 创建一个web project（当然java project也一样），导入上面提到的两个jar包commons-logging-1.1.1.jar and dbmaintain-1.0.1.jar，另外，还需要额外导入一个jdbc的jar包，别忘了，我们是要操作数据库。在这个我用的是mysql-connector-java-5.1.7-bin.jar.

3, 配置 dbmaintain.properties，这个比较多一点，见附件，里面做了说明。（我的意思很简单，先运行起来再说）。当然，你可以有两个地方找到这个文件，一种是到官网 http://www.dbmaintain.org/configuration.html 复制下来，(我是用这个，因为是简洁版）。另一个是在我们上面下的压缩包里（注意只有含源文件包里才有），解压缩后的目录dbmaintain-1.0.1-src\src\resources\dbmaintain-default.properties。

4，组织sql scripts,这是重点，四种脚本类型（Incremental Repeatable Postprocessing Patches），下面一一道来。

先看组织方式，混个脸熟
 
scripts/incremental/01_v1.0/01_products_and_orders.sql
                                                    02_users.sql
                                                    03_#PATCH_add_status.sql
                               02_v1.1/01_add_barcode_column.sql
                                             02_drop_itemcode_column.sql
          repeatable/proc_purge_old_orders.sql
                              proc_disactivate_inactive_users.sql
   postprocessing/01_compile_all.sql
                                 02_grant_select_to_read_user.sql
                      
  1） Incremental，顾名思义，增量式的，有顺序的。说明：scripts是所有脚本的总目录，随便你怎么命名，下面有三个目录，分别对应三种脚本类型，Patches除外。incremental放增量式脚本的目录，目录名字可以任取。下面可以再定义文件夹，此时文件夹就有序号了（index number）,这里的两个文件夹是体现两个版本的。
                   
  注意：这种脚本时会按顺序执行（从小到大），且每个脚本只执行一次。
 
  2） Repeatable，顾名思义，可重复执行的,为什么要弄个可重复执行呢？因为我们有经常要修改的脚本，如function ，procedure，views，每次修改完之后，就会执行一遍。
     
  注意：这种脚本不可以有编号, 不可以放到有编号的目录下,否则会报错。
 
  3） Postprocessing, 我给的理解是后置执行，也就是等所有的脚本都执行完了之后，才执行。但它也不是每次都执行，什么时候会被执行呢？当脚本有变动，包括Postprocessing目录下的脚本，则所有的postprocessing脚本都会执行一遍。比如我们修改了repeatable/proc_purge_old_orders.sql,
     
  注意：目录名必须是postprocessing, 如果不是则被认为是Incremental脚本。可以有index number（序号），如果有序号则会按顺序执行。
 
  4） Patches，补丁。什么情况才算是补丁呢？用官方的话说就是：当你要增加一个脚本，而它的序号低于已经执行过的脚本的序号时，这个脚本就必须是补丁形式，否则会报错。比如上面的 03_#PATCH_add_status.sql 是新加进去的，（补丁的组织形式就是在序号后面加上#PATCH就行，如例子），我们的脚本已经执行到了文件夹02_v1.1里面了，很明显，这个序号高于01_v1.0下的所有序号，满足打补丁的情况。
 
5，创建数据库，dbmaintain，dbmaintain2，创建两个是为了说明同时管理多个数据库的情况。参考附件，多数据库组织方式1.jpg （对脚本文件区分）;  多数据库组织方式2.jpg（用文件夹区分,建议使用）， 配置在配置文件里有说明，只要把对应的参数改过来就行。

6，建一个类DBMaintain.java，看附件，里面有对主要命令的说明。完毕

总结，搭建好环境之后，就是组织脚本格式，和配置dbmaintain.properties就可行了。