Trong thực tế, ta thường không tránh khỏi việc phải cập nhật schema (hay còn gọi là schema evolution). Giống như thiết kế kiến trúc hệ thống, việc define schema cũng cần phải được tính toán khéo léo để có thể dễ dàng tương thích cho cả phiên bản cũ và mới (Backward/Forward Compatibility).

Bài viết này sử dụng định dạng Avro làm ví dụ minh họa, tuy nhiên ta cũng có thể áp dụng tương tự với các định dạng khác như JSON, Thrift, Protobuf… hay cho cả define table schema.

Tổng quát:

• Nên cung cấp giá trị default của field, điều này giúp thỏa mãn forward compatibility khi mình consume message từ version cũ. Trong trường hợp không sử dụng field đó nữa, ta hoàn toàn có thể xóa nó đi mà vẫn đảm bảo backward compatibility vì đã được khai báo giá trị mặc định.
  • Bất cứ khi nào add thêm field, cần cung cấp giá trị default
• Không được đổi data type
  • Nếu bạn thực sự có nhu cầu cần đổi data type, hãy bổ sung vào 1 field mới, thay vì sửa đè lên field hiện tại.
  • Add giá trị vào Enum cũng được coi là đổi data type, tuy nhiên ta vẫn có thể bổ sung được với điều kiện phải khai báo giá trị default cho enum từ trước.
• Không được đổi tên field. Với Avro, bạn có thể sử dụng tính năng alias nếu cần sửa tên field ở phía read.

Tham khảo:

• Backward and Forward compatibility with Java Jackson ObjectMapper
• https://docs.oracle.com/database/nosql-12.1.3.0/GettingStartedGuide/schemaevolution.html
• http://avro.apache.org/docs/current/spec.html