Database Migration với Flyway

spring.jpa.hibernate.ddl-auto=update

Trước:  posts (id, title, content, summary, ...)
Sau:    posts (id, title, content, summary, excerpt, ...)
                                    ↑ vẫn ở đây, bị bỏ rơi

V1 — Tạo bảng users
V2 — Tạo bảng categories
V3 — Tạo bảng posts (với khóa ngoại đến users và categories)
V4 — Tạo bảng tags và bảng nối post_tags
V5 — Tạo bảng comments
V6 — Thêm cột views_count vào posts
V7 — Thêm index trên posts.status để tăng hiệu suất truy vấn
V8 — Đổi tên users.name thành users.full_name

App khởi động
    ↓
Flyway kiểm tra bảng flyway_schema_history
    ↓
"Database đang ở V5. Các file migration có đến V8."
    ↓
Flyway chạy V6, V7, V8 theo thứ tự
    ↓
Cập nhật flyway_schema_history: V6 ✓, V7 ✓, V8 ✓
    ↓
Spring Boot tiếp tục khởi động → Hibernate kiểm tra schema
    ↓
Ứng dụng sẵn sàng

<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
</dependency>

<!-- Flyway cần module đặc thù database cho MariaDB/MySQL -->
<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-mysql</artifactId>
</dependency>

# ============================================
# DataSource — giống như trước
# ============================================
spring.datasource.url=jdbc:mariadb://localhost:3306/blogdb
spring.datasource.username=bloguser
spring.datasource.password=blogpass
spring.datasource.driver-class-name=org.mariadb.jdbc.Driver

# ============================================
# JPA / Hibernate — THAY ĐỔI ddl-auto thành validate
# ============================================
# Trước: spring.jpa.hibernate.ddl-auto=update
# Giờ: Flyway quản lý schema, Hibernate chỉ kiểm tra
spring.jpa.hibernate.ddl-auto=validate

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MariaDBDialect

# ============================================
# Cấu hình Flyway
# ============================================
# Nơi Flyway tìm file migration (mặc định là classpath:db/migration)
spring.flyway.locations=classpath:db/migration

# Bật Flyway (mặc định bật khi có trên classpath)
spring.flyway.enabled=true

# Tên bảng lịch sử schema (mặc định: flyway_schema_history)
spring.flyway.table=flyway_schema_history

src/
└── main/
    └── resources/
        └── db/
            └── migration/
                ├── V1__create_users_table.sql
                ├── V2__create_categories_table.sql
                └── ... (thêm file migration)

V{version}__{mô_tả}.sql

Ví dụ:
V1__create_users_table.sql
V2__create_categories_table.sql
V3__create_posts_table.sql
V4__create_tags_and_post_tags.sql
V5__create_comments_table.sql
V6__add_views_count_to_posts.sql
V7__add_index_on_posts_status.sql

❌ V1_create_users.sql           → Một dấu gạch dưới (cần hai)
❌ v1__create_users.sql           → Chữ v thường (phải viết hoa V)
❌ V1__create users table.sql     → Có khoảng trắng trong tên file
❌ create_users_table.sql         → Thiếu tiền tố V
✅ V1__create_users_table.sql     → Đúng

-- V1: Tạo bảng users
-- Đây là bảng nền tảng — các bảng khác tham chiếu qua khóa ngoại.
CREATE TABLE users (
    id              BIGINT          AUTO_INCREMENT PRIMARY KEY,
    username        VARCHAR(50)     NOT NULL,
    email           VARCHAR(255)    NOT NULL,
    password_hash   VARCHAR(255)    NOT NULL,
    full_name       VARCHAR(100),
    bio             TEXT,
    role            VARCHAR(20)     NOT NULL DEFAULT 'ROLE_USER',
    is_active       BOOLEAN         NOT NULL DEFAULT TRUE,
    created_at      TIMESTAMP       NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at      TIMESTAMP       NOT NULL DEFAULT CURRENT_TIMESTAMP
                                    ON UPDATE CURRENT_TIMESTAMP,
    UNIQUE INDEX idx_users_username (username),
    UNIQUE INDEX idx_users_email (email)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

-- V2: Tạo bảng categories
CREATE TABLE categories (
    id          BIGINT          AUTO_INCREMENT PRIMARY KEY,
    name        VARCHAR(100)    NOT NULL,
    slug        VARCHAR(100)    NOT NULL,
    description TEXT,
    created_at  TIMESTAMP       NOT NULL DEFAULT CURRENT_TIMESTAMP,
    UNIQUE INDEX idx_categories_name (name),
    UNIQUE INDEX idx_categories_slug (slug)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

-- V3: Tạo bảng tags
CREATE TABLE tags (
    id          BIGINT          AUTO_INCREMENT PRIMARY KEY,
    name        VARCHAR(50)     NOT NULL,
    slug        VARCHAR(50)     NOT NULL,
    created_at  TIMESTAMP       NOT NULL DEFAULT CURRENT_TIMESTAMP,
    UNIQUE INDEX idx_tags_name (name),
    UNIQUE INDEX idx_tags_slug (slug)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

-- V4: Tạo bảng posts với khóa ngoại đến users và categories
CREATE TABLE posts (
    id              BIGINT          AUTO_INCREMENT PRIMARY KEY,
    title           VARCHAR(500)    NOT NULL,
    slug            VARCHAR(500)    NOT NULL,
    content         TEXT            NOT NULL,
    excerpt         VARCHAR(1000),
    status          VARCHAR(20)     NOT NULL DEFAULT 'DRAFT',
    author_id       BIGINT          NOT NULL,
    category_id     BIGINT,
    published_at    TIMESTAMP       NULL,
    created_at      TIMESTAMP       NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at      TIMESTAMP       NOT NULL DEFAULT CURRENT_TIMESTAMP
                                    ON UPDATE CURRENT_TIMESTAMP,
    UNIQUE INDEX idx_posts_slug (slug),
    INDEX idx_posts_status (status),
    INDEX idx_posts_author_id (author_id),
    FOREIGN KEY (author_id) REFERENCES users(id) ON DELETE RESTRICT,
    FOREIGN KEY (category_id) REFERENCES categories(id) ON DELETE SET NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

-- V5: Tạo bảng nối post_tags (nhiều-nhiều giữa posts và tags)
CREATE TABLE post_tags (
    post_id     BIGINT NOT NULL,
    tag_id      BIGINT NOT NULL,
    PRIMARY KEY (post_id, tag_id),
    FOREIGN KEY (post_id) REFERENCES posts(id) ON DELETE CASCADE,
    FOREIGN KEY (tag_id) REFERENCES tags(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

-- V6: Tạo bảng comments với tự tham chiếu cho bình luận lồng nhau
CREATE TABLE comments (
    id          BIGINT      AUTO_INCREMENT PRIMARY KEY,
    content     TEXT        NOT NULL,
    post_id     BIGINT      NOT NULL,
    author_id   BIGINT      NOT NULL,
    parent_id   BIGINT      NULL,
    created_at  TIMESTAMP   NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at  TIMESTAMP   NOT NULL DEFAULT CURRENT_TIMESTAMP
                            ON UPDATE CURRENT_TIMESTAMP,
    INDEX idx_comments_post_id (post_id),
    INDEX idx_comments_author_id (author_id),
    FOREIGN KEY (post_id) REFERENCES posts(id) ON DELETE CASCADE,
    FOREIGN KEY (author_id) REFERENCES users(id) ON DELETE RESTRICT,
    FOREIGN KEY (parent_id) REFERENCES comments(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

./mvnw flyway:migrate

./mvnw flyway:info

+---------+----------------------------+---------------------+---------+
| Version | Description                | Installed on        | State   |
+---------+----------------------------+---------------------+---------+
| 1       | create users table         | 2024-01-15 10:00:00 | Success |
| 2       | create categories table    | 2024-01-15 10:00:01 | Success |
| 3       | create tags table          |                     | Pending |
+---------+----------------------------+---------------------+---------+

./mvnw flyway:repair

./mvnw flyway:clean

# Ngăn flyway:clean trong production — Flyway sẽ ném lỗi
spring.flyway.clean-disabled=true

./mvnw flyway:validate

V20240115120000__add_phone_column.sql    (Developer A: 15/1 lúc 12:00)
V20240115143000__add_address_column.sql  (Developer B: 15/1 lúc 14:30)

-- V100: Seed dữ liệu tham chiếu ban đầu
-- Dùng V100 để có chỗ cho migration schema trước đó.

-- Danh mục mặc định
INSERT INTO categories (name, slug, description) VALUES
    ('Tutorial', 'tutorial', 'Hướng dẫn lập trình từng bước'),
    ('News', 'news', 'Tin tức công nghệ mới nhất'),
    ('Opinion', 'opinion', 'Suy nghĩ và quan điểm cá nhân'),
    ('Review', 'review', 'Đánh giá sản phẩm và công nghệ');

-- Tag mặc định
INSERT INTO tags (name, slug) VALUES
    ('Java', 'java'),
    ('Spring Boot', 'spring-boot'),
    ('MariaDB', 'mariadb'),
    ('Docker', 'docker'),
    ('REST API', 'rest-api'),
    ('JPA', 'jpa'),
    ('Security', 'security'),
    ('Testing', 'testing');

-- Admin user (mật khẩu: admin123 — đã hash BCrypt)
-- Trong production, tạo admin user qua quy trình bảo mật, không trong migration.
INSERT INTO users (username, email, password_hash, full_name, role) VALUES
    ('admin', 'admin@blog.com', '$2a$10$N9qo8uLOickgx2ZMRZoMyeIjZAgcfl7p92ldGxad68LJZdL17lhWy',
     'System Admin', 'ROLE_ADMIN');

R__create_or_replace_views.sql
R__refresh_materialized_data.sql

-- Repeatable: view này được tạo lại mỗi khi file thay đổi
DROP VIEW IF EXISTS post_statistics;

CREATE VIEW post_statistics AS
SELECT
    p.id AS post_id,
    p.title,
    p.status,
    u.username AS author,
    c.name AS category,
    p.views_count,
    (SELECT COUNT(*) FROM comments cm WHERE cm.post_id = p.id) AS comment_count,
    (SELECT COUNT(*) FROM post_tags pt WHERE pt.post_id = p.id) AS tag_count,
    p.published_at,
    p.created_at
FROM posts p
JOIN users u ON p.author_id = u.id
LEFT JOIN categories c ON p.category_id = c.id;

# application-dev.properties
spring.flyway.locations=classpath:db/migration,classpath:db/devdata

# application-prod.properties
spring.flyway.locations=classpath:db/migration

# Xóa và tạo lại database
docker exec -it blogdb mariadb -u root -prootpass \
  -e "DROP DATABASE IF EXISTS blogdb; CREATE DATABASE blogdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; GRANT ALL PRIVILEGES ON blogdb.* TO 'bloguser'@'%'; FLUSH PRIVILEGES;"

# Cho Flyway biết database hiện có đại diện phiên bản V6
spring.flyway.baseline-on-migrate=true
spring.flyway.baseline-version=6
spring.flyway.baseline-description=Baseline existing schema

./mvnw spring-boot:run

Flyway Community Edition 9.x by Redgate
Database: jdbc:mariadb://localhost:3306/blogdb (MariaDB 11.x)
Successfully validated 7 migrations
Creating Schema History table `blogdb`.`flyway_schema_history` ...
Migrating schema `blogdb` to version "1 - create users table"
Migrating schema `blogdb` to version "2 - create categories table"
...
Successfully applied 7 migrations to schema `blogdb`

-- V7: Thêm cột views_count để theo dõi độ phổ biến bài viết
ALTER TABLE posts ADD COLUMN views_count INT NOT NULL DEFAULT 0;
CREATE INDEX idx_posts_views_count ON posts(views_count);

@Column(name = "views_count", nullable = false)
private int viewsCount = 0;

# Tạo bài viết
curl -X POST http://localhost:8080/api/posts \
  -H "Content-Type: application/json" \
  -d '{"title":"Hướng dẫn Flyway","content":"Học quản lý migration...","authorId":1,"categoryId":1}'

# Xác minh bài viết
curl http://localhost:8080/api/posts/1

# Dừng và khởi động lại ứng dụng
# Flyway output: "Current version: 7" — không có migration mới
# Tất cả dữ liệu được bảo toàn

# Xác minh dữ liệu tồn tại sau khởi động lại
curl http://localhost:8080/api/posts/1