Database Migration với AI: Đừng để một câu lệnh làm mất dữ liệu cả hệ thống

    18/11/2026    11    5.00/5 trong 1 lượt 
Database Migration với AI: Đừng để một câu lệnh làm mất dữ liệu cả hệ thống
Hướng dẫn Database Migration an toàn khi dùng AI Coding: Expand–Contract, SQL Server, backfill dữ liệu, kiểm tra tương thích, backup, rollback và Go-live nhiều phiên bản.

Xem nhanh:

Có một việc mà lập trình viên càng làm lâu càng thận trọng: sửa cấu trúc database của hệ thống đang chạy.

Với dự án mới, muốn đổi tên một cột dữ liệu, chúng ta có thể chỉnh sửa model, tạo migration rồi chạy lại.

Nhưng nếu hệ thống đã vận hành nhiều năm, có hàng triệu bản ghi, nhiều API và ứng dụng cùng sử dụng một database thì sao?

Chú Nha 27 tuổi hình dung một tình huống thế này.

Chúng ta yêu cầu AI Coding Agent: "Đổi cột DisplayName thành FullName và cập nhật các chức năng liên quan".

AI phân tích, viết một câu lệnh ALTER TABLE, sửa các model và báo hoàn thành.

Trên máy development, tất cả đều chạy.

Nhưng khi đưa lên production, có thể vẫn còn một API cũ đang đọc DisplayName. Một background job chưa được cập nhật. Hoặc một báo cáo chạy trực tiếp trên database đang tham chiếu tên cột cũ.

Chỉ một thay đổi nhỏ cũng có thể làm nhiều thành phần ngừng hoạt động.

Đó là lý do tôi muốn dành riêng một bài cho Database Migration khi lập trình với AI.

Không phải để hướng dẫn AI viết thật nhiều câu lệnh SQL. Mục tiêu là học cách thay đổi database mà vẫn bảo vệ dữ liệu cũ, các hệ thống đang hoạt động và khả năng khôi phục khi gặp sự cố.

Bài viết sử dụng SQL Server làm ví dụ, nhưng những nguyên tắc như kiểm tra tương thích, chuyển đổi theo giai đoạn và nghiệm thu dữ liệu có thể áp dụng cho nhiều hệ quản trị cơ sở dữ liệu khác.

1. Database Migration là gì?

Database Migration là quá trình chuyển đổi cấu trúc, dữ liệu hoặc cả hai từ một trạng thái sang trạng thái mới để đáp ứng yêu cầu phát triển phần mềm.

Ví dụ:

  • Thêm cột dữ liệu mới.
  • Đổi tên cột hoặc bảng.
  • Thay đổi kiểu dữ liệu.
  • Tách một bảng lớn thành nhiều bảng.
  • Bổ sung khóa ngoại hoặc ràng buộc duy nhất.
  • Chuyển dữ liệu từ trường cũ sang trường mới.
  • Thay đổi cách ứng dụng lưu và truy xuất dữ liệu.

Không phải migration nào cũng có mức độ rủi ro như nhau.

Thêm một cột nullable vào bảng nhỏ có thể tương đối đơn giản. Nhưng đổi kiểu dữ liệu hoặc xóa một cột đang được nhiều hệ thống sử dụng có thể gây lỗi ứng dụng, khóa bảng hoặc mất dữ liệu.

Điểm quan trọng là không xem migration chỉ như một file SQL.

Một database migration an toàn thường cần phối hợp giữa thay đổi schema, mã nguồn ứng dụng, dữ liệu hiện có, kiểm thử và quy trình triển khai.

2. Vì sao AI Coding làm Database Migration cần kiểm soát riêng?

AI có thể viết SQL rất nhanh. Nhưng để đánh giá một thay đổi có an toàn với production hay không, nó cần biết những thông tin mà mã nguồn chưa chắc thể hiện đầy đủ.

Chẳng hạn:

  • Bảng hiện tại có bao nhiêu bản ghi?
  • Những ứng dụng nào đang đọc hoặc ghi bảng đó?
  • Có stored procedure, trigger, view hoặc job nào phụ thuộc không?
  • Có hệ thống báo cáo kết nối trực tiếp không?
  • Đang sử dụng phiên bản và edition SQL Server nào?
  • Hệ thống có chấp nhận dừng dịch vụ không?
  • Backup đã được thử phục hồi chưa?
  • Database có đủ dung lượng dữ liệu và transaction log không?

Nếu không được cung cấp những thông tin này, AI có thể đưa ra một phương án đúng về cú pháp nhưng không phù hợp với hệ thống đang vận hành.

Vì vậy, tôi đề xuất một nguyên tắc:

AI được phép đề xuất migration. Nhưng việc thực thi trên production phải tuân thủ quyền truy cập, kiểm thử và phê duyệt độc lập.

3. Một ví dụ tưởng đơn giản: Đổi tên cột DisplayName thành FullName

Giả sử hệ thống có bảng khách hàng như sau:

CREATE TABLE dbo.Customers (

CustomerId INT NOT NULL PRIMARY KEY,

DisplayName NVARCHAR(200) NULL );

Ứng dụng đang sử dụng cột DisplayName để lưu tên hiển thị của khách hàng.

Yêu cầu mới là đổi tên trường này thành FullName.

AI có thể đề xuất sử dụng sp_rename:

EXEC sp_rename     'dbo.Customers.DisplayName',     'FullName',     'COLUMN';

Lệnh này có thể đổi tên cột, nhưng không tự động sửa mọi phần mã nguồn hoặc đối tượng phụ thuộc vào tên cũ.

Thậm chí nếu toàn bộ code mới đã chuyển sang FullName, trong thời gian triển khai vẫn có thể còn những phiên bản ứng dụng cũ đang chạy.

Đổi tên trực tiếp khiến chúng không còn tìm thấy DisplayName.

Chúng ta cần một phương án khác.

4. Expand–Migrate–Contract là gì?

Expand–Migrate–Contract, còn gọi là Parallel Change, là cách thực hiện một thay đổi không tương thích thông qua nhiều giai đoạn chuyển tiếp.

Martin Fowler mô tả phương pháp này bằng ba bước:

  • Expand: Mở rộng cấu trúc để hệ thống mới có thể được phát triển trong khi phần cũ vẫn hoạt động.
  • Migrate: Chuyển dữ liệu và những thành phần sử dụng sang cách làm mới.
  • Contract: Loại bỏ cấu trúc cũ khi đã xác nhận không còn thành phần nào phụ thuộc.

Ví dụ với cột tên khách hàng:

TRẠNG THÁI BAN ĐẦU  Customers   - CustomerId   - DisplayName
        | v  EXPAND  Customers   - CustomerId   - DisplayName   - FullName
        | v  MIGRATE  - Đồng bộ dữ liệu - Chuyển ứng dụng sang FullName - Kiểm tra dữ liệu cũ và mới - Kiểm tra các thành phần phụ thuộc
        | v  CONTRACT  Customers   - CustomerId   - FullName

Điểm khác biệt là chúng ta không xóa cột cũ ngay khi tạo cột mới.

Hai cấu trúc cùng tồn tại trong thời gian chuyển đổi.

Phương pháp này không tự động bảo đảm zero downtime. Nó chỉ giúp thiết kế quá trình chuyển đổi có thể duy trì tương thích giữa các phiên bản khi được thực hiện đúng.

5. Bước 1: Kiểm tra database trước khi thay đổi

Trước khi AI tạo migration, hãy yêu cầu thu thập thông tin về schema và những thành phần phụ thuộc.

Ví dụ, kiểm tra sự tồn tại của các cột trên SQL Server:

SELECT

c.name AS ColumnName,

t.name AS DataType,

c.max_length,

c.is_nullable FROM sys.columns c JOIN sys.types t

ON c.user_type_id = t.user_type_id WHERE c.object_id =

OBJECT_ID(N'dbo.Customers');

Kiểm tra số bản ghi:

SELECT COUNT_BIG(*) AS TotalRows FROM dbo.Customers;

Kiểm tra các đối tượng phụ thuộc có thể được SQL Server ghi nhận:

SELECT

OBJECT_SCHEMA_NAME(d.referencing_id)

AS SchemaName,

OBJECT_NAME(d.referencing_id)

AS ObjectName,

d.referenced_entity_name FROM sys.sql_expression_dependencies d WHERE d.referenced_id =

OBJECT_ID(N'dbo.Customers');

Đừng xem kết quả của truy vấn cuối là danh sách đầy đủ tuyệt đối.

Dynamic SQL, mã nguồn ứng dụng, hệ thống báo cáo hoặc những kết nối từ bên ngoài có thể không xuất hiện trong metadata phụ thuộc.

Vì vậy, cần tìm kiếm thêm trong repository, stored procedures, jobs và danh sách các hệ thống tích hợp.

6. Bước 2: Expand - Thêm cột mới mà chưa xóa cột cũ

Trong ví dụ này, chúng ta tạo FullName nhưng giữ nguyên DisplayName.

Mẫu SQL dưới đây dành cho môi trường thực hành. Khi triển khai thực tế, cần xác minh rằng tên cột chưa được sử dụng và database đang ở đúng phiên bản dự kiến.

IF COL_LENGTH(

'dbo.Customers',

'FullName' ) IS NULL BEGIN

ALTER TABLE dbo.Customers

ADD FullName NVARCHAR(200) NULL; END;

Lưu ý: Kiểm tra cột tồn tại giúp tránh một số lỗi chạy lặp lại, nhưng không có nghĩa migration sẽ an toàn trong mọi trạng thái hoặc khi nhiều tiến trình triển khai đồng thời.

Câu lệnh ALTER TABLE có thể cần schema modification lock, thường được gọi là Sch-M.

Vì vậy, ngay cả thao tác thêm cột cũng nên được đánh giá theo tải hệ thống, kích thước bảng, thời điểm triển khai và đặc điểm của phiên bản SQL Server.

Không nên cho AI thực hiện trên production chỉ vì câu lệnh trông đơn giản.

7. Bước 3: Migrate - Chuyển dữ liệu cũ sang cột mới

Sau khi tạo FullName, các bản ghi hiện có vẫn chưa có dữ liệu ở cột mới.

Chúng ta cần chuyển dữ liệu từ DisplayName sang FullName.

Với bảng nhỏ, một câu lệnh UPDATE có thể đủ.

Nhưng với bảng lớn, cập nhật hàng triệu bản ghi trong một transaction có thể gây khóa dữ liệu kéo dài, tăng transaction log và ảnh hưởng các truy vấn khác.

Một phương án là cập nhật theo lô.

Ví dụ dưới đây chỉ dành cho môi trường thực hành hoặc staging đã được kiểm soát:

SET NOCOUNT ON;

DECLARE @RowsAffected INT = 1;

WHILE @RowsAffected > 0 BEGIN

;WITH Batch AS

(

SELECT TOP (500)

CustomerId

FROM dbo.Customers

WHERE FullName IS NULL

AND DisplayName IS NOT NULL

ORDER BY CustomerId

)

UPDATE c

SET FullName = c.DisplayName

FROM dbo.Customers c

INNER JOIN Batch b

ON c.CustomerId = b.CustomerId

WHERE c.FullName IS NULL;

SET @RowsAffected = @@ROWCOUNT;

PRINT CONCAT(

'Rows updated: ',

@RowsAffected

); END;

Mỗi lượt xử lý tối đa 500 bản ghi. Đây chỉ là kích thước lô minh họa, không phải giá trị tối ưu cho mọi database.

Trong hệ thống thật, cần đo thời gian chạy, số bản ghi, blocking, transaction log và ảnh hưởng lên hiệu năng.

Đặc biệt, không nên mặc định điều kiện FullName IS NULL là đủ để thiết kế toàn bộ cơ chế đồng bộ.

Nếu ứng dụng vẫn đang thay đổi DisplayName trong quá trình backfill, dữ liệu có thể tiếp tục bị lệch.

Vì thế, trước khi backfill, cần có cơ chế phối hợp ghi dữ liệu giữa phiên bản cũ và mới, hoặc một chiến lược chuyển đổi khác đã được kiểm chứng.

8. Bài toán khó hơn: Trong lúc migration, ứng dụng vẫn đang ghi dữ liệu

Đây là phần dễ bị bỏ quên.

Giả sử backfill đã chuyển dữ liệu cho khách hàng A.

Ngay sau đó, một phiên bản ứng dụng cũ cập nhật DisplayName của khách hàng A.

FullName có thể vẫn chứa giá trị trước khi cập nhật.

Vậy dữ liệu nào mới là đúng?

Muốn chuyển đổi an toàn, chúng ta cần xác định một nguồn dữ liệu có thẩm quyền trong từng giai đoạn.

Một phương án là triển khai phiên bản ứng dụng trung gian có khả năng ghi đồng bộ hai cột.

Nhưng cần lưu ý: Dual Write không đơn giản chỉ là hai lệnh UPDATE.

Để tránh dữ liệu lệch, phải xem xét:

  • Hai cột có được cập nhật trong cùng transaction không?
  • Có phiên bản ứng dụng cũ vẫn chỉ ghi DisplayName không?
  • Có trigger hoặc job khác cập nhật dữ liệu không?
  • Nếu một thao tác ghi thất bại thì xử lý thế nào?
  • Trong quá trình chuyển đổi, cột nào được xem là nguồn dữ liệu chính?
  • Hệ thống sẽ phát hiện và sửa dữ liệu lệch bằng cách nào?

Với hệ thống có nhiều tiến trình ghi hoặc nhiều ứng dụng cùng sử dụng database, cần thiết kế và kiểm thử cơ chế đồng bộ riêng.

Đừng yêu cầu AI "dual write cả hai cột" rồi coi như bài toán đã giải quyết xong.

9. Bước 4: Kiểm tra dữ liệu trước khi chuyển sang cột mới

Sau khi backfill, phải kiểm tra những bản ghi chưa được chuyển và những giá trị chưa khớp.

Ví dụ, kiểm tra các bản ghi có DisplayName nhưng thiếu FullName:

SELECT COUNT_BIG(*) AS MissingFullName FROM dbo.Customers WHERE DisplayName IS NOT NULL

AND FullName IS NULL;

Kiểm tra dữ liệu khác nhau, kể cả khi một bên là NULL:

SELECT COUNT_BIG(*) AS MismatchCount FROM dbo.Customers WHERE

(

DisplayName IS NULL

AND FullName IS NOT NULL

)

OR

(

DisplayName IS NOT NULL

AND FullName IS NULL

)

OR

(

DisplayName <> FullName

);

Ví dụ này áp dụng cho trường hợp chuyển đổi sao chép nguyên giá trị.

Nếu cột mới có quy tắc chuẩn hóa hoặc biến đổi dữ liệu, việc kiểm tra phải dựa trên quy tắc biến đổi đã được phê duyệt, không đơn giản chỉ so sánh hai cột bằng nhau.

Cũng cần kiểm tra các bản ghi mới phát sinh và những bản ghi được chỉnh sửa trong lúc backfill.

Với hệ thống có tải lớn, truy vấn đối soát trên toàn bảng cũng phải được đánh giá về hiệu năng và mức độ ảnh hưởng.

10. Bước 5: Chuyển ứng dụng sang FullName

Khi dữ liệu mới đã sẵn sàng, ứng dụng có thể bắt đầu đọc FullName.

Không nhất thiết chuyển tất cả thành phần cùng lúc.

Có thể triển khai theo từng nhóm ứng dụng hoặc từng phiên bản, với điều kiện những phiên bản đang chạy vẫn tương thích với schema.

Ví dụ một trình tự chuyển đổi:

RELEASE A
- Add FullName
- Keep DisplayName
- Deploy compatibility logic

RELEASE B
- Backfill data in batches
- Verify consistency
- Monitor new writes

RELEASE C
- Switch reads to FullName
- Keep compatibility during transition
- Monitor errors and discrepancies

RELEASE D
- Remove legacy dependencies
- Verify no old consumers remain
- Approve removal of DisplayName

Một số hệ thống có thể sử dụng feature flag để kiểm soát thời điểm chuyển từ dữ liệu cũ sang dữ liệu mới.

Tuy nhiên, feature flag cũng cần được kiểm thử. Không phải cứ có một nút bật tắt là mọi trạng thái chuyển đổi đều an toàn.

Điều quan trọng là biết chính xác phiên bản ứng dụng nào có thể làm việc với từng phiên bản database.

11. Bước 6: Contract - Khi nào mới được xóa cột cũ?

Đây là bước tôi muốn trì hoãn cho đến khi có đủ bằng chứng.

Đừng xóa DisplayName ngay khi phiên bản ứng dụng mới bắt đầu chạy.

Trước khi loại bỏ, cần xác nhận:

  • Không còn ứng dụng nào đọc DisplayName.
  • Không còn job hoặc stored procedure phụ thuộc.
  • Các báo cáo đã được cập nhật.
  • Không còn phiên bản cũ cần rollback về trạng thái chỉ sử dụng DisplayName.
  • Dữ liệu ở FullName đã được kiểm chứng.
  • Đã có phương án khôi phục và phê duyệt loại bỏ.

Sau đó mới lập một migration riêng để xóa cột cũ.

Tôi không đưa câu lệnh DROP COLUMN trực tiếp vào phần thực hành này, vì muốn nhấn mạnh rằng xóa dữ liệu là một quyết định cần được kiểm tra riêng, không phải bước tự động thực hiện ngay sau backfill.

Nguyên tắc: Chỉ Contract khi cấu trúc cũ thực sự không còn cần thiết, không còn phụ thuộc và việc loại bỏ đã được phê duyệt.

12. Rollback code không đồng nghĩa với rollback database

Đây là một khác biệt rất quan trọng.

Nếu phiên bản ứng dụng mới có lỗi, chúng ta có thể triển khai lại phiên bản trước đó.

Nhưng nếu database đã đổi cấu trúc không tương thích, ứng dụng cũ có thể không chạy được.

Và nếu migration đã xóa dữ liệu, việc đổi lại tên cột hoặc tạo lại bảng không tự động khôi phục nội dung đã mất.

Vì vậy, cần phân biệt:

  • Application rollback: Đưa ứng dụng về phiên bản trước.
  • Schema rollback: Đưa cấu trúc database về trạng thái trước, nếu khả thi và an toàn.
  • Data recovery: Khôi phục dữ liệu bị mất hoặc sai, có thể cần backup, transaction log hoặc các phương án phục hồi khác.

Một ưu điểm của Expand–Migrate–Contract là trong thời gian chuyển tiếp, chúng ta có thể duy trì khả năng chạy ứng dụng cũ mà chưa cần xóa cấu trúc cũ.

Tuy nhiên, điều này chỉ đúng khi đã thiết kế và kiểm thử khả năng tương thích giữa các phiên bản.

Không nên hứa rollback an toàn nếu chưa thực sự thử.

13. Backup trước migration: Có file .bak chưa đủ

Trước khi thay đổi database quan trọng, cần có phương án backup và phục hồi phù hợp.

Trên SQL Server, một bản backup có thể được kiểm tra bằng các cơ chế xác minh như RESTORE VERIFYONLY.

Nhưng việc kiểm tra cấu trúc backup không thay thế hoàn toàn cho một lần phục hồi dữ liệu thực tế.

Với hệ thống quan trọng, nên thử restore trên môi trường tách biệt và kiểm tra khả năng đọc dữ liệu, tính toàn vẹn và thời gian khôi phục.

Những câu hỏi cần trả lời:

  • Bản backup gần nhất được tạo khi nào?
  • Backup có bao gồm những dữ liệu cần bảo vệ không?
  • Có bảo vệ được dữ liệu phát sinh ngay trước thời điểm migration không?
  • Có đủ dung lượng để restore không?
  • Đã thử phục hồi thành công chưa?
  • Thời gian phục hồi có đáp ứng yêu cầu vận hành không?
  • Điều gì xảy ra với các giao dịch phát sinh sau thời điểm backup?

Đặc biệt, không nên xem việc restore nguyên database như phương án rollback mặc định cho mọi hệ thống đang tiếp tục nhận đơn hàng hoặc giao dịch.

Restore từ một thời điểm cũ có thể khiến dữ liệu phát sinh sau đó không còn trong bản khôi phục, nếu không có phương án phục hồi và đối soát phù hợp.

14. Khóa bảng và Transaction Log: Hai rủi ro dễ bị đánh giá thấp

Với SQL Server, ALTER TABLE có thể sử dụng schema modification lock.

Khi thao tác chờ hoặc giữ khóa, những truy vấn khác có thể bị ảnh hưởng.

Một migration chạy nhanh trên database development chưa chắc chạy nhanh trên production.

Production có thể có nhiều dữ liệu hơn, nhiều giao dịch đồng thời hơn và các truy vấn kéo dài.

Ngoài ra, việc cập nhật dữ liệu hàng loạt còn tạo ra hoạt động ghi transaction log.

Nếu transaction log không có đủ dung lượng hoặc không thể tăng trưởng phù hợp, migration có thể thất bại hoặc ảnh hưởng hệ thống.

Trước khi triển khai, cần đánh giá:

  • Số bản ghi và kích thước bảng.
  • Những truy vấn đang sử dụng bảng.
  • Thời gian khóa dự kiến.
  • Mức độ blocking có thể xảy ra.
  • Dung lượng transaction log.
  • Khả năng tăng trưởng file và dung lượng đĩa.
  • Thời điểm có lưu lượng thấp.
  • Điều kiện dừng migration.

Một lưu ý nữa: Không phải mọi phiên bản và edition SQL Server đều hỗ trợ các thao tác online giống nhau.

Vì vậy, những ví dụ sử dụng ONLINE = ON hoặc các tính năng migration mới cần được kiểm tra khả năng hỗ trợ trước khi chạy.

15. Sử dụng EF Core Migrations với AI Coding

Nếu dự án sử dụng Entity Framework Core, chúng ta có thể tạo migration từ thay đổi model.

Ví dụ:

dotnet ef migrations add AddCustomerFullName

Tuy nhiên, không nên mặc định migration do công cụ sinh ra luôn an toàn với dữ liệu cũ.

Với những thay đổi như đổi tên cột, EF Core có thể cần con người chỉnh sửa migration để tránh phương án drop và tạo lại cột khiến dữ liệu không được giữ nguyên.

Microsoft khuyến nghị xem xét các migration được tạo, đặc biệt khi có nguy cơ mất dữ liệu.

Để tạo script SQL có thể review:

dotnet ef migrations script     --idempotent     -o artifacts/migrate.sql

Lệnh trên được trình bày thành nhiều dòng cho dễ đọc; khi chạy trên terminal, hãy viết thành một lệnh hoặc sử dụng cú pháp xuống dòng phù hợp với shell.

Idempotent script của EF Core sử dụng lịch sử migration để xác định những migration nào chưa được áp dụng.

Nhưng điều đó không chứng minh rằng mọi thay đổi dữ liệu bên trong migration đều an toàn nếu thực thi lặp lại hoặc trong điều kiện bất thường.

Với production, tôi ưu tiên quy trình tạo script, review, kiểm thử trên bản sao phù hợp, sau đó mới triển khai thông qua cơ chế được phép.

16. Nên lưu migration trong repository như thế nào?

Tôi đề xuất đặt migration trong một cấu trúc có thể truy vết cùng với nhiệm vụ triển khai.

project/
|
+-- AGENTS.md
|
+-- docs/
|
+-- architecture.md
|
+-- database/
|
+-- schema.md
|
+-- migration-policy.md
|
+-- tasks/
|
+-- DB-001.md
|
+-- database/
|
+-- migrations/ |
|
+-- DB-001-expand.sql |
|
+-- DB-001-backfill.sql |
|
+-- DB-001-contract.sql |   |
|
+-- verification/
|
+-- DB-001-verify.sql
|
+-- releases/
+-- release-001/
+-- rollout-plan.md
+-- rollback-plan.md
+-- test-report.md

Các file có trách nhiệm khác nhau.

Expand thay đổi cấu trúc có tính tương thích.

Backfill chuyển đổi dữ liệu.

Verification xác nhận dữ liệu.

Contract loại bỏ cấu trúc cũ sau khi được phê duyệt.

Với dự án sử dụng EF Core, Flyway hoặc một công cụ migration khác, cần tuân theo cơ chế quản lý version và migration history của công cụ đó thay vì tự trộn các hệ thống migration không có kế hoạch.

17. Task Specification mẫu cho AI Database Migration

Trước khi giao AI viết SQL, hãy tạo một task riêng.

# DB-001

## Title
Migrate Customer DisplayName to FullName

## Objective
Introduce FullName without breaking existing application versions.

## Existing
State dbo.Customers.DisplayName

## Target
State dbo.Customers.FullName

## Required
Strategy Expand
- Migrate
- Contract

## Constraints
- No direct destructive changes.
- Preserve existing data.
- Support approved old app versions.
- No production execution by AI.
- No unapproved schema changes.

## Required
Analysis
- Current database schema
- Row counts
- Dependencies
- Application compatibility
- Locking risks
- Transaction log risks
- Backup and restore readiness

## Deliverables
- Expand migration
- Data backfill plan
- Compatibility plan
- Verification queries
- Rollout plan
- Recovery plan
- Contract proposal

## Acceptance
Criteria
- Existing data preserved.
- Approved old app versions work.
- New app version reads correct data.
- Data discrepancies are resolved.
- Migration has verification evidence.
- Production execution approved.

## Approval
Human approval is required for all production changes.

Task này giúp AI hiểu rằng mục tiêu không phải đổi tên cột nhanh nhất, mà là chuyển đổi có kiểm soát.

18. Prompt yêu cầu AI phân tích trước khi viết migration

ROLE: Senior Database Architect and SQL Server Migration Reviewer

OBJECTIVE: Plan a safe database migration for an existing production system.

TASK: tasks/DB-001.md

PHASE 1
- DISCOVERY

Review available:
- Schema definitions
- Stored procedures
- Views and triggers
- Application code references
- Database version and edition
- Dependencies
- Current data volume
- Backup strategy

PHASE 2
- RISK ANALYSIS

Identify:
- Breaking changes
- Data loss risks
- Locking and blocking risks
- Transaction log risks
- Backward compatibility risks
- Concurrent write risks
- Recovery limitations

PHASE 3
- PLAN

Propose:
1. Expand migration
2. Compatibility mechanism
3. Data backfill
4. Data verification
5. Application cutover
6. Contract phase
7. Recovery strategy

RULES:
- Do not execute SQL.
- Do not access production.
- Do not invent schema details.
- Do not assume online DDL support.
- Do not use destructive SQL

without explicit approval.
- Clearly identify assumptions.

OUTPUT:
- Migration plan
- SQL draft for review
- Verification plan
- Risks
- Open questions
- Required approvals

Chú ý: Nếu AI chưa có quyền đọc database, nó chỉ có thể phân tích những tài liệu đã được cung cấp.

Không nên xem các nhận xét về số lượng dữ liệu, chỉ mục hoặc hiệu năng là kết quả đo thực tế nếu AI chưa có dữ liệu xác minh.

19. Prompt kiểm tra chéo migration bằng một AI Reviewer

Sau khi AI Coding Agent tạo kế hoạch và script, chúng ta có thể sử dụng reviewer độc lập để tìm các rủi ro.

ROLE: Independent SQL Server Migration Reviewer

INPUT:
- Approved Task
- Current Schema
- Proposed Migration Scripts
- Application Compatibility Plan
- Verification Queries
- Rollout and Recovery Plans

REVIEW:
1. Data loss risk
2. Breaking schema changes
3. Application version compatibility
4. Locking and blocking
5. Transaction log impact
6. Backfill correctness
7. Concurrent writes
8. Idempotency assumptions
9. Rollback limitations
10. Verification gaps

FOR EACH FINDING:
- Severity
- Script location
- Triggering condition
- Potential impact
- Evidence
- Verification method
- Recommended correction

RULES:
- Do not modify database.
- Do not assume production safety.
- Distinguish confirmed findings

from unverified concerns.
- Do not approve deployment.

FINAL:
- Findings
- Missing evidence
- Required tests
- Go/No-Go concerns
- Human approval requirements

Reviewer không được tự khẳng định migration an toàn chỉ vì không tìm thấy lỗi trong script.

Những rủi ro về lưu lượng thực tế, quyền truy cập hoặc khả năng restore vẫn cần được xác minh bằng môi trường và dữ liệu phù hợp.

20. Checklist 20 mục trước khi chạy Database Migration

  1. Đã xác định chính xác database và môi trường triển khai chưa?
  2. Đã ghi nhận phiên bản và edition SQL Server chưa?
  3. Đã có mục tiêu và Task Specification được duyệt chưa?
  4. Đã kiểm tra schema hiện tại chưa?
  5. Đã xác định các ứng dụng và job phụ thuộc chưa?
  6. Đã kiểm tra stored procedures, views và triggers chưa?
  7. Đã có bản backup phù hợp chưa?
  8. Đã thử restore backup thành công chưa?
  9. Đã xác định RPO và RTO chưa?
  10. Đã ước lượng kích thước dữ liệu cần chuyển chưa?
  11. Đã đánh giá khóa bảng và blocking chưa?
  12. Đã đánh giá transaction log và dung lượng đĩa chưa?
  13. Đã kiểm tra khả năng tương thích giữa các phiên bản ứng dụng chưa?
  14. Đã xác định nguồn dữ liệu chính trong giai đoạn chuyển đổi chưa?
  15. Đã thiết kế phương án xử lý ghi đồng thời chưa?
  16. Đã có verification queries chưa?
  17. Đã chạy thử migration trên môi trường phù hợp chưa?
  18. Đã có điều kiện dừng và kế hoạch khôi phục chưa?
  19. Đã có người chịu trách nhiệm theo dõi triển khai chưa?
  20. Đã có phê duyệt thực thi production chưa?

21. Checklist 15 mục sau khi chạy Migration

  1. Migration có hoàn thành đúng trạng thái dự kiến không?
  2. Đã xác nhận schema mới chưa?
  3. Đã xác nhận dữ liệu cũ được giữ nguyên chưa?
  4. Đã kiểm tra số bản ghi trước và sau chưa?
  5. Đã kiểm tra dữ liệu NULL bất thường chưa?
  6. Đã kiểm tra dữ liệu sai lệch chưa?
  7. Đã kiểm tra các bản ghi mới phát sinh trong quá trình migration chưa?
  8. Đã kiểm tra những ghi dữ liệu đồng thời chưa?
  9. Đã chạy integration tests chưa?
  10. Đã kiểm tra ứng dụng phiên bản cũ nếu còn được hỗ trợ chưa?
  11. Đã kiểm tra ứng dụng phiên bản mới chưa?
  12. Đã theo dõi lỗi, latency và blocking chưa?
  13. Đã kiểm tra transaction log và tài nguyên chưa?
  14. Đã lưu báo cáo, script version và kết quả xác minh chưa?
  15. Đã có quyết định tiếp tục, tạm dừng hoặc chuyển sang giai đoạn Contract chưa?

22. Những sai lầm dễ gặp khi để AI sửa database

Đổi tên cột trực tiếp mà không kiểm tra dependency

Ứng dụng mới chạy được nhưng ứng dụng cũ, job hoặc báo cáo có thể gặp lỗi.

Gộp Expand, Backfill và Contract vào một lần deploy

Điều này làm giảm khả năng kiểm tra và tăng khó khăn khi cần khôi phục.

Chạy một UPDATE lớn trên bảng có lưu lượng cao

Cần đánh giá blocking, transaction log và cách chuyển dữ liệu theo lô.

Cho rằng migration đã rollback được vì script có lệnh ngược

Chạy ngược schema không có nghĩa là dữ liệu đã xóa hoặc biến đổi có thể tự phục hồi.

Tin rằng có file backup là đủ

Backup cần có kế hoạch phục hồi đã được kiểm chứng.

Chỉ kiểm tra data count

Số lượng bản ghi không đổi không có nghĩa giá trị dữ liệu còn đúng.

Không kiểm tra các phiên bản ứng dụng cùng tồn tại

Rolling deployment có thể khiến phiên bản cũ và mới sử dụng database trong cùng một thời điểm.

Cho AI tự chạy migration trên production

Quyền thực thi phải được giới hạn. Những thay đổi quan trọng cần review và phê duyệt phù hợp.

Quá tự tin vào zero downtime

Không phải mọi thao tác schema đều tránh được khóa hoặc ảnh hưởng đến hiệu năng.

Xóa cột cũ quá sớm

Đây có thể là sai lầm khiến khả năng quay lại ứng dụng cũ biến mất.

23. Database Migration nên là một phần của quy trình AI Coding

Trong series này, chúng ta đã xây dựng một quy trình phát triển phần mềm có kiểm soát.

Database Migration cần được đặt vào cùng quy trình ấy.

APPROVED REQUIREMENTS
        | v DATABASE CHANGE REQUEST
        | v AI MIGRATION ANALYSIS
        | v HUMAN REVIEW
        | v EXPAND MIGRATION
        | v COMPATIBILITY DEPLOYMENT
        | v BACKFILL + VERIFICATION
        | v APPLICATION CUTOVER
        | v MONITORING
        | v CONTRACT APPROVAL
        | v REMOVE LEGACY SCHEMA

Không phải dự án nào cũng cần thực hiện đủ các bước dưới dạng những release riêng biệt.

Nhưng khi thay đổi có thể ảnh hưởng dữ liệu và các hệ thống đang vận hành, việc tách giai đoạn giúp chúng ta kiểm soát và xác minh dễ hơn.

Nếu đang xây dựng website, bạn cũng có thể tham khảo bộ 150 checklist trước và sau Vibe Coding, trước khi Go-live website mà tôi đã chia sẻ miễn phí.

Trong đó có các nhóm kiểm tra toàn vẹn dữ liệu, database migration, backup và khả năng phục hồi.

24. Kết luận: Sửa database không khó bằng bảo vệ dữ liệu đang có

Với chú Nha 27 tuổi, một trong những thay đổi lớn khi lập trình với AI là chúng ta có thể tạo code và script nhanh hơn rất nhiều.

Nhưng tốc độ tạo ra câu lệnh không đồng nghĩa với tốc độ đưa câu lệnh ấy vào production.

Đặc biệt với database, điều đáng bảo vệ không chỉ là cấu trúc bảng. Đó là dữ liệu người dùng, lịch sử giao dịch, tính đúng đắn của nghiệp vụ và khả năng duy trì dịch vụ.

Một câu lệnh ALTER TABLE có thể chỉ dài vài dòng.

Nhưng để biết câu lệnh ấy an toàn với hệ thống đang chạy, chúng ta cần xem xét nhiều thứ hơn.

Tôi thích phương pháp Expand–Migrate–Contract vì nó nhắc chúng ta đừng nóng vội loại bỏ cái cũ trước khi cái mới được kiểm chứng.

Thêm cấu trúc mới. Chuyển dữ liệu có kiểm soát. Kiểm tra. Chuyển ứng dụng. Theo dõi. Và chỉ loại bỏ cấu trúc cũ khi thật sự sẵn sàng.

AI có thể giúp nghiên cứu và chuẩn bị các bước ấy.

Nhưng người chịu trách nhiệm với hệ thống vẫn phải hiểu điều gì đang thay đổi, có thể ảnh hưởng đến ai và làm gì khi kết quả không như mong đợi.

Nếu một ngày AI hỏi: "Em đã viết xong migration rồi, anh có muốn chạy luôn không?", có lẽ chú Nha sẽ trả lời:

"Khoan. Cho anh xem backup, compatibility plan và kết quả restore thử đã."

Chậm vài phút để kiểm tra đôi khi tốt hơn rất nhiều so với nhanh một câu lệnh rồi dành cả đêm tìm cách lấy lại dữ liệu.

Nguồn tham khảo

Cảm ơn bạn đã đọc hết bài viết!

Nha thân tặng bộ source code blog này cho những ai quan tâm.
☕

Mời tác giả tách cà phê / Tiếp sức cho Blog

Nếu nội dung này hữu ích với bạn, hãy ủng hộ một khoản nhỏ để tiếp thêm động lực cho tác giả duy trì và chia sẻ nhiều kiến thức chất lượng hơn!

Giới thiệu

Tìm kiếm Google

Liên kết

Mạng thư viện
Quà tặng con gái và con trai
Dotgrid Planner 2023
Mua hàng tại amazone
Bàn phím cơ