如果你正在執行一個專案，這個專案包含了一些開發人員在不同的分支上進行開發。你也許已經知道了最容易發生問題的地方，像是管理資料庫結構的變化。 幸運的是，大多數 framework 都已經配有 migration 工具，像是 rails (ruby)、django (python)、sequelize (nodejs)、laravel (php) 等，來保證其 framework 的靈活性。本次介紹的 Liquibase 也許你也會感興趣。

1. 使用 Liquibase 發展資料庫結構
Liquibase is 10 years old!!

2. Ref: Datical DB
• 高控制性
• 無法自動判斷變更的版本
• 需要依賴人工介入
• 很難處理不同版本的資料庫轉移
• 與程式碼的耦合度高
• 可以透過不同的 dialect 處理不同的資料庫
• 只能有條件的管理變更
• 很難處理資料的變更
SQL JPA

3. 最初的需求 (2006)
• 所有的變更都和程式碼一起保存在版本控制系統裡，
並且可以被分支與合併
• 每一個變更都可以容易的被產生，並且擁有獨一無二
的識別
• 每個資料庫知道要執行哪些變更來符合現在程式碼的
版本
Ref: Sundog Database Refactoring Tool Early Access Program Opens

4. 最初的需求 (2016)
• 支援多種資料庫，甚至能在不同的資料庫執行相同的
程式
• 支援多個開發人員、多個分支下的並行開發
• 安全的更新資料庫結構而不必擔心資料遺失
• 追蹤資料庫的變化
Ref: Happy Birthday! Here's to 10 Years of Liquibase

5. 支援
• Java 1.4 和 1.5
• MySQL, PostgreSQL, Oracle, Sql Server, Sybase,
DB2, Derby, HSQL, H2, Informix, Firebird, SQLite
• Command Line, Ant, Maven, Gradle, Spring-boot…
• XML, YAML, JSON, SQL

6. Ref: Datical DB

7. ChangeLog
ChangeSet
Change
1
*
1
*
必須能自動執
行
版本控制
結構

8. <databaseChangeLog xmlns=“…”>
<changeSet id="00000000000001" author=“steven">
<createTable tableName="user">
<column name="id" type="bigint" autoIncrement="true">
<constraints primaryKey="true" nullable="false"/>
</column>
<column name="name" type="varchar(100)"/>
</createTable>
<rollback>
drop table user
</rollback>
</changeSet>
</databaseChangeLog>

9. 兩個重要的 table
• DATABASECHANGELOG
• 用來追蹤哪些 ChangeSet 已經執行
• Author、ID、File
• DATABASECHANGELOGLOCK
• 避免衝突

10. 常用的指令
• update
• rollback
• diff
• tag
Ref: Liquibase Command Line

11. Best Practices
• 透過 master.xml 來管理所有的 ChangeSet
• 不更改已執行過的 ChangeSet
• 確保所有的 ChangeSet 都有 Rollback
Ref: Liquibase Best Practices

12. 常見的問題
• ChangeSet 的主要屬性：runAlways, runOnChange,
runInTransaction 的使用
• rollback 的問題
• generateChangeLog 指令

13. 練習資源
• Tutorial using Oracle
• http://www.liquibase.org/tutorial-using-oracle
• JCConf TW 2015 Database Continuous Integration
• https://github.com/wang-steven/jcconf-tw-2015