maven-dbdeploy-plugin插件的使用

dbdeploy 是一个工具，用来记录数据库开发留下修改历史。

利用Dbdeploy工具为我们带的好处
1、历史修改留痕，方便追溯或回滚某一时间数据库结构和数据
2、利用命令自动打包sql脚本
3、可利用历史记录快速复制干净的数据库，实现一人一库开发，数据隔离，不影响测试过程
4、防止开发人员在开发过程中随意在数据库上更改脚本

DBdploy插件使用
下载到插件后，可以找到这个目录里，对应找到创建changelog表的sql并在数据库里执行

maven中build示例

<build>
        <plugins>
            <plugin>
                <groupId>com.dbdeploy</groupId>
                <artifactId>maven-dbdeploy-plugin</artifactId>
                <version>3.0M3</version>
                <configuration>
                    <scriptdirectory>./sql</scriptdirectory>
                    <name>${dbchangefile.name}</name>
                    <encoding>UTF-8</encoding>
                    <lineEnding>lf</lineEnding>
                    <outputfile>./result/apply.sql</outputfile>
                    <undoOutputfile>./result/undo.sql</undoOutputfile>
                    <driver>com.mysql.jdbc.Driver</driver>
                    <url>${db.url}</url>
                    <userid>${db.usr}</userid>
                    <password>${db.pwd}</password>
                    <dbms>mysql</dbms>
                    <delimiter>/</delimiter>
                    <delimiterType>row</delimiterType>
                </configuration>
                <dependencies>
                    <dependency>
                        <groupId>com.dbdeploy</groupId>
                        <artifactId>dbdeploy-core</artifactId>
                        <version>3.0M3</version>
                    </dependency>
                    <dependency>
                        <groupId>mysql</groupId>
                        <artifactId>mysql-connector-java</artifactId>
                        <version>5.1.27</version>
                    </dependency>
                </dependencies>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-antrun-plugin</artifactId>
                <version>1.3</version>
                <executions>
                    <execution>
                        <id>ant-build</id>
                        <phase>prepare-package</phase>
                        <goals>
                            <goal>run</goal>
                        </goals>
                        <configuration>
                            <tasks>
                                <property name="db.driver" value="com.mysql.jdbc.Driver"/>
                                <property name="db.url" value="${db.url}"/>
                                <property name="db.username" value="${db.usr}"/>
                                <property name="db.password" value="${db.pwd}"/>
                                <property name="base.dir" value="dbdeploy-3.0M3"/>
                                <property name="compile_classpath" refid="maven.compile.classpath"/>
                                <property name="runtime_classpath" refid="maven.runtime.classpath"/>
                                <property name="test_classpath" refid="maven.test.classpath"/>
                                <property name="plugin_classpath" refid="maven.plugin.classpath"/>
                                <property name="artifactId" value="${project.artifactId}"/>
                                <property name="build.compiler" value="extJavac"/>
                                <ant antfile="dbdeploy-3.0M3/mysql/build.xml">
                                    <target name="create-changelog-table"/>
                                </ant>
                            </tasks>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

如果想更对数据库操作，不要直接操作数据库，
1、使用createNewDDLChangeFile.bat或createNewDMLChangeFile.bat自动生成 .sql文件
生成的文件路径： DB\src\main\sql/

2、将sql语句copy到文件里保存 如20180129140101_DML.sql

–xxx 增加上传文件的路径参数
insert into sy_parameter (PARAMETER_ID, NAME, MODULE, MANAGE_TYPE, NOTES)
values (‘uploadFolder’, ‘uploadFolder’, ‘产品合同’, ‘1’, ‘合同模板文件’)
/
insert into sy_parameter_value (PARAMETER_VALUE_ID, PARAMETER_ID, VALUE)
values (‘uploadFolder’, ‘uploadFolder’, ‘/home/www/’)
/

3、Jenkins打包发布的时候，会自动执行新添加的.sql文件。如果成功后，changelog表会有对应的文件名的一条记录，下次更新的就不会再执行该文件。
（或打开plsql的comand操作窗口。将sql粘贴，查看否执行成功，需要手动插入changelog表）
（或更改pom里面的配置信息，改成测试库信息，切记不能做reset操作）

4、生成汇总脚本
运行createApplyUndoScripts.bat
目标脚本为/DB/target/sql/apply.sql和/DB/target/sql/undo.sql
方便上线脚本一键打包，配合Jenkins更好用

createNewDDLChangeFile.bat里面的内容

mvn dbdeploy:change-script -Ddbchangefile.name=DDL

createNewDMLChangeFile.bat里面的内容

mvn dbdeploy:change-script -Ddbchangefile.name=DML

updateMyDb.bat里面的内容

call mvn clean verify
pause:

• 注意事项
  1.DDL文件中，只需要有一次DDL操作的语句，如新建两张表，必须新建两个ddl文件。
  2.sql语句最后以";“号结尾的地方要替换为”/"
  3.每个文件需要加注释，标识出谁添加，用来干什么
  4.生成apply.sql的时候，需要注意POM中指定生成的位置，通常会生成在target目录下，避免git当做新文件提交，但再Jenkins上因为会每天清空工作空间，所以需要注意target目录的生成。
  如果使用mvn clean install命令，则会直接执行DB。
  目前的解决方案在Jenkins里增加shell命令，每次执行前先保证traget目录的存在
  cd /jenkins/datajk/.jenkins/jobs/DBUtils_online/workspace/DB
  if [ ! -d target ];then
  mkdir -p target
  fi