Mình đã giới thiệu với các bạn về database migration sử dụng Liquibase. Flyway cũng làm được điều tương tự, giúp chúng ta có thể quản lý version của database structure. Nó record thông tin migration trong một table schema history và sử dụng database locking để prevent concurrent migration processes. Cụ thể như thế nào? Hãy cùng nhau tìm hiểu trong bài viết này, các bạn nhé!
Đầu tiên, mình sẽ tạo mới một Maven project để làm ví dụ:

với Flyway và PostgreSQL JDBC driver dependencies như sau:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
<dependencies> <dependency> <groupId>org.flywaydb</groupId> <artifactId>flyway-core</artifactId> <version>${flyway-version}</version> </dependency> <dependency> <groupId>org.flywaydb</groupId> <artifactId>flyway-database-postgresql</artifactId> <version>${flyway-version}</version> <scope>runtime</scope> </dependency> <dependency> <groupId>org.postgresql</groupId> <artifactId>postgresql</artifactId> <version>42.7.14</version> </dependency> </dependencies> |
Với:
|
1 2 3 4 5 |
<properties> ... <flyway-version>13.12.2</flyway-version> </properties> |
Ở đây dependency flyway-core cung cấp core Flyway engine còn dependency flyway-database-postgresql cung cấp support cho PostgreSQL database, các bạn nhé!
Mình cũng sử dụng Java 25 cho ví dụ này:
|
1 2 |
<maven.compiler.source>25</maven.compiler.source> <maven.compiler.target>25</maven.compiler.target> |
Với Flyway thì chúng ta có thể sử dụng tập tin SQL hoặc code Java để hiện thực hóa database migration, thông thường thì mình sử dụng tập tin SQL vì đơn giản hơn rất nhiều. Trong bài viết này, mình sẽ sử dụng tập tin SQL để làm ví dụ. Các bạn muốn sử dụng code Java thì có thể tham khảo thêm ở đây nhé.
Với tập tin SQL thì Flyway, sau khi có connection tới database, sẽ đọc các tập tin SQL này ở một thư mục mà chúng ta cấu hình, mặc định là thư mục src/main/resources/db/migration để làm migration.
Tên của các tập tin SQL cần phải đặt theo một naming convention nhất định, các bạn nhé!
Flyway hỗ trợ chúng ta có thể migrate lên một version mới cho database structure bằng một tập tin SQL mới với versioned migration. Các bạn cũng có thể sử dụng chỉ duy nhất một tập tin SQL với repeatable migration. Trong trường hợp các bạn đã có V1, V2, V3 của một database structure, các bạn có thể định nghĩa một baseline migration version B3 để khi deploy ứng dụng của chúng ta lên một môi trường mới, Flyway chỉ pickup từ version này trở đi mà thôi, không cần chạy các script migration V1, V2, V3 nữa. Ngoài ra thì Flyway còn hỗ trợ undo migration nhưng chỉ available cho phiên bản Flyway Teams edition các bạn nhé!
Dưới đây là một ví dụ về tên của tập tin SQL:
- V2026.11.21.00000__Init.sql nếu thêm version mới
- R__People_view.sql nếu là repeatable migration
- B2026.11.21.00000__Baseline.sql nếu là baseline migration.
- U2026.11.21.00000__Init.sql nếu là undo migration.
Tên tập tin sẽ bắt đầu bằng ký tự V hoặc R hoặc B hoặc U tùy theo cách mà các bạn muốn làm migration như ví dụ trên. Tiếp theo sẽ là version. Naming convention cho version thì các bạn có thể tham khảo tại đây. Mình thì thường sử dụng version theo ngày tháng năm như ví dụ trên.
Ngăn cách giữa 2 phần trong tên của tập tin SQL là 2 ký tự gạch dưới “__”; phần phía sau 2 dấu gạch dưới này là mô tả về thay đổi mà các bạn làm trong tập tin SQL này.
Cho repeatable migration, baseline migration và undo migration, mình sẽ đề cập trong những bài viết khác, các bạn nhé!
Để làm ví dụ cho bài viết này, mình sẽ tạo mới một tập tin SQL với tên là V2021.08.07.00000__Init với nội dung tạo mới table student như sau:
|
1 2 3 4 |
CREATE TABLE student ( ID INT PRIMARY KEY, name VARCHAR(250) NOT NULL ); |
Bây giờ, mình sẽ tạo mới một main class để xem cách làm việc của Flyway như thế nào các bạn nhé.
Nội dung của class này ban đầu như sau:
|
1 2 3 4 5 6 7 8 9 |
package com.huongdanjava.flyway; public class Application { public static void main(String[] args) { } } |
Chúng ta sẽ sử dụng đối tượng của class Flyway, khởi tạo nó cùng với thông tin DataSource kết nối tới database để chuẩn bị làm migration, như sau:
|
1 2 3 |
Flyway flyway = Flyway.configure() .dataSource("jdbc:postgresql://localhost:5432/student", "postgres", "123456") .load(); |
Nếu các bạn đã có thông tin DataSource rồi thì cũng có thể sử dụng một phương thức overload khác để sử dụng DataSource này:

không cần phải khai báo databaseURL, username và password như mình.
Để chạy migration, chúng ta sẽ gọi phương thức migrate() của đối tượng Flyway như sau:
|
1 |
flyway.migrate(); |
Bây giờ, nếu chạy ví dụ này, rồi kiểm tra database, các bạn sẽ thấy kết quả như sau:

Ngoài table student mà chúng ta đã khai báo trong tập tin SQL, Flyway còn tạo một table khác tương tự như Liquibase để quản lý tất cả các version mà chúng ta đã chạy. Table này tên là flyway_schema_history dùng để keep track history:

Một số thông tin được record trong table flyway_schema_history như sau:
- Migration version
- Description
- Migration type
- Script
- Checksum
- Execution timestamp
- Execution status
Flyway sẽ extract thông tin về version từ tên của tập tin SQL. Nó còn sử dụng một column để lưu trữ checksum của tập tin SQL để kiểm tra tập tin SQL nào đã chạy, tập tin nào chưa. Các bạn không được thay đổi nội dung của những tập tin mà Flyway đã chạy migration. Nếu có bất kỳ thay đổi nào thì Flyway sẽ báo lỗi ngay.
Nếu các bạn muốn thêm một version mới thì cứ tạo mới tập tin SQL theo naming convention mà mình đã nói ở trên là được nhé!
Ví dụ mình thêm mới cột address cho student thì mình sẽ tạo mới tập tin SQL với tên V2021.08.07.00001__add_student_address.sql và nội dung như sau:
|
1 2 |
ALTER TABLE student ADD COLUMN address VARCHAR(255); |
Kết quả:

