Appearance
So sánh engine: MySQL vs PostgreSQL
Version: 0.2
Date: 2026-11-16
Status: DECIDED (R1–R5 — Owner 2026-11-16; D-022)
1. Mục đích
Research / phân tích / so sánh MySQL (và MariaDB tương đương về mặt mô hình tên) với PostgreSQL cho các RDBMS trong phạm vi gói database lần này (db-platform-core, File Service, Payment, Invoice).
Owner đã chốt R1–R5 theo khuyến nghị PostgreSQL (2026-11-16) → ghi D-022. Phần so sánh dưới đây giữ làm căn cứ; khuyến nghị §8 thành quyết định.
Phạm vi: engine OLTP chính cho schema platform ở trên.
Ngoài phạm vi: Keycloak / Matrix / MinIO / Infisical (xem 90); DB domain Application (A/B/C, Salon, …) — không thuộc gói thiết kế này.
2. Ràng buộc MINAP (đầu vào phân tích)
| Ràng buộc | Hệ quả với engine |
|---|---|
| Ownership tách: Core / File / Payment / Invoice | Cần mô hình namespace vật lý rõ (MySQL database hoặc PostgreSQL schema) — đã ghi quy ước Owner ở 00-overview |
| Platform Core foundation đã dùng PostgreSQL + Prisma (Gate 1B; giờ D-022) | Đổi sang MySQL cho Core = chi phí migration + ADR mới |
ID công khai {prefix}_{nanoid} (D-017), không auto-increment public | Cả hai engine đều ổn; khác biệt nằm ở constraint / index / JSON phụ trợ |
| Audit / entitlement / connector payload (tương lai) | Có nhu cầu semi-structured → JSON mạnh là lợi thế |
Stack TypeScript / Node, Prisma đã dùng ở platform-core | Cả hai được Prisma hỗ trợ; PostgreSQL ecosystem (JSONB, schema) khớp sẵn hơn với hướng hiện tại |
| Ops non-prod → Swarm sau; Infisical (D-016) | Ưu tiên một họ engine để giảm backup, monitoring, skill |
3. Khái niệm tên vật lý (Owner đã chốt quy ước)
| Engine | “Tên vật lý” trong docs MINAP nghĩa là |
|---|---|
| MySQL / MariaDB | Database name (trong MySQL, database ≡ schema) |
| PostgreSQL | Schema name trong một Postgres database (không lấy public làm SoT ownership) |
Hệ quả: với PostgreSQL, nhiều bounded context có thể nằm trên một Postgres database (nhiều schema) hoặc tách database. Non-prod đã chốt phương án A (R4); isolation production vẫn OPEN. Với MySQL, mỗi “tên vật lý” gần như luôn là một database riêng.
4. Bảng so sánh (theo nhu cầu MINAP)
| Tiêu chí | MySQL 8+ | PostgreSQL 16/17 | Ghi chú MINAP |
|---|---|---|---|
| Mô hình namespace | Database = schema | Database ⊃ nhiều schema | PostgreSQL khớp trực tiếp quy ước “tên vật lý = schema” |
| Isolation theo ownership | Một database / context | Schema / context (hoặc DB / context) | Cả hai làm được; Postgres linh hoạt hơn khi muốn share instance |
| JSON / semi-structured | Kiểu JSON + function; index qua generated / multi-valued | jsonb + GIN, containment (@>), jsonpath | Audit payload, connector state → Postgres mạnh hơn |
| Constraint / SQL giàu | Đủ cho OLTP cổ điển | Partial unique, exclusion, CTE/window mạnh | Personal Workspace “đúng một / account” kiểu partial unique → Postgres tự nhiên hơn |
| Multi-tenant defense-in-depth | Chủ yếu enforce ở app / view | RLS (Row-Level Security) tùy chọn | Workspace-scoped authz hiện ở app; RLS là lớp dự phòng sau |
| Prisma / Node | Hỗ trợ tốt | Hỗ trợ tốt; multi-schema cần cấu hình rõ | Core đã đi Postgres path |
| Ecosystem gần MINAP | Phổ biến hosting | Keycloak & Synapse thường mặc định Postgres | Giảm dị biệt ops nếu platform RDBMS cũng Postgres |
| Ops / tooling | Đơn giản, quen thuộc nhiều team | Phong phú extension (pgcrypto, logical replication, …) | Skill team Owner vẫn là biến số |
| License / fork | MySQL (Oracle) / MariaDB | PostgreSQL (permissive) | Không blocker; ghi nhận governance |
| Read-heavy đơn giản | Rất mạnh với replica đơn giản | Mạnh; pattern khác (logical replication) | Không phải bottleneck hiện tại của foundation |
5. Phân tích theo từng lớp MINAP
5.1 Platform Core (db-platform-core)
- Đã có Prisma + migration + foundation Account/Workspace trên PostgreSQL.
- Cần unique / partial uniqueness, transactional provision, audit JSON → Postgres phù hợp.
- DECIDED (R2): PostgreSQL; tên vật lý schema
platform_core.
5.2 File Service metadata
- Metadata quan hệ + có thể JSON phụ (config TTL, allowlist).
- Ownership tách khỏi bytes (MinIO).
- DECIDED (R3): PostgreSQL + schema
file_service.
5.3 Payment / Invoice
- Ledger-like, idempotency, connector payload — thường hưởng lợi transaction + JSONB.
- DECIDED (R3): PostgreSQL (
payment,invoiceschemas).
5.4 Application DB
Ngoài phạm vi gói này. Khi thiết kế Application sau này: mặc định nên cùng họ engine platform trừ khi Gate ghi ngoại lệ.
6. Phương án topology (PostgreSQL)
Non-prod: phương án A DECIDED (R4). Production isolation (giữ A hay tách database) vẫn OPEN.
| Phương án | Mô tả | Ưu | Nhược |
|---|---|---|---|
| A. Một Postgres database + nhiều schema | Ví dụ database minap chứa schema platform_core, file_service, payment, invoice | Backup/ops gọn; khớp quy ước tên vật lý = schema | Quyền/role phải siết; blast radius backup chung |
| B. Một Postgres database / bounded context | platform_core là database, bên trong schema SoT cũng tên platform_core (hoặc public — không khuyến nghị làm SoT) | Cô lập mạnh hơn | Nhiều connection string, migration/ops nhân lên |
| C. Hỗn hợp MySQL + PostgreSQL trong cùng lớp platform | Ví dụ Core Postgres + Payment MySQL | Tối ưu cục bộ | Hai toolchain backup/monitor/ORM dialect |
DECIDED hướng: A cho non-prod (R4); đánh giá B khi cần cô lập production; tránh C trừ ngoại lệ Gate (R5).
Local hiện tại của Platform Core có thể còn database tên
platform_core+ schemapublic— lệch SoT schemaplatform_core. Cần align (xem 01-platform-core).
7. Khi nào chọn MySQL?
Chọn MySQL (cho một context cụ thể) khi một trong các điều kiện sau đúng và được Gate ghi nhận:
- Team vận hành chỉ có skill và tooling MySQL chín, chi phí học Postgres không chấp nhận được trong phase đó.
- Hosting / managed service bắt buộc MySQL và không có Postgres tương đương.
- Workload thuần read-heavy, schema đơn giản, không cần JSONB/RLS/partial unique — và lợi ích ops đo được.
Không khuyến nghị MySQL chỉ vì “quen hơn” nếu Platform Core đã Postgres và không có áp lực trên.
8. Quyết định (DECIDED — D-022)
| ID | Nội dung | Status |
|---|---|---|
| R1 — Engine mặc định (gói này) | PostgreSQL là RDBMS mặc định cho Core / File / Payment / Invoice trừ khi Gate ghi ngoại lệ | DECIDED |
| R2 — Platform Core | PostgreSQL; tên vật lý = schema platform_core | DECIDED |
| R3 — File / Payment / Invoice | PostgreSQL; tên vật lý = schema file_service / payment / invoice | DECIDED |
| R4 — Topology | Non-prod: một Postgres database + nhiều schema (phương án A); isolation production vẫn OPEN | DECIDED (non-prod A) |
| R5 — Không dual-engine mặc định | Không vận hành song song MySQL+Postgres trong cùng lớp platform của gói này nếu không có lý do Gate | DECIDED |
9. Rủi ro nếu chọn ngược
| Nếu… | Rủi ro |
|---|---|
| Đổi Platform Core sang MySQL ngay | Migration Prisma/data; mất partial unique / JSONB ergonomics; chậm foundation đã ship |
| Trộn MySQL+Postgres trong cùng lớp platform không kiểm soát | Chi phí Infisical/backup/runbook × N; QA khó chuẩn hóa |
Giữ schema public làm SoT | Lẫn ownership; khó map cột “Tên vật lý” theo quy ước Owner |
10. Bước tiếp
Approve R1–R5— xong (Owner 2026-11-16 → D-022).- Align local Platform Core: schema SoT
platform_core(đổi khỏipublicnếu compose còn lệch). - Chốt sau: backup/HA; isolation production (giữ A hay tách database).
- Schema bảng File / Payment / Invoice vẫn skeleton — thiết kế chi tiết khi capability/Gate tương ứng.
11. Tham chiếu
- Bản đồ DB: 00-overview
- Platform Core: 01-platform-core
- Sổ quyết định: /architecture/11-decisions-and-open-questions (D-022)
- Nền tảng so sánh ngành (JSON / SaaS tenancy / Node OLTP): Bytebase JSON compare; pattern SaaS schema-per-tenant vs shared; chiến lược Node 2025 ưu tiên Postgres OLTP