Skip to content

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ộcHệ quả với engine
Ownership tách: Core / File / Payment / InvoiceCầ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 publicCả 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-coreCả 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 / MariaDBDatabase name (trong MySQL, database ≡ schema)
PostgreSQLSchema 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/17Ghi chú MINAP
Mô hình namespaceDatabase = schemaDatabase ⊃ nhiều schemaPostgreSQL khớp trực tiếp quy ước “tên vật lý = schema”
Isolation theo ownershipMột database / contextSchema / context (hoặc DB / context)Cả hai làm được; Postgres linh hoạt hơn khi muốn share instance
JSON / semi-structuredKiểu JSON + function; index qua generated / multi-valuedjsonb + GIN, containment (@>), jsonpathAudit payload, connector state → Postgres mạnh hơn
Constraint / SQL giàuĐủ cho OLTP cổ điểnPartial unique, exclusion, CTE/window mạnhPersonal Workspace “đúng một / account” kiểu partial unique → Postgres tự nhiên hơn
Multi-tenant defense-in-depthChủ yếu enforce ở app / viewRLS (Row-Level Security) tùy chọnWorkspace-scoped authz hiện ở app; RLS là lớp dự phòng sau
Prisma / NodeHỗ trợ tốtHỗ trợ tốt; multi-schema cần cấu hình rõCore đã đi Postgres path
Ecosystem gần MINAPPhổ biến hostingKeycloak & Synapse thường mặc định PostgresGiảm dị biệt ops nếu platform RDBMS cũng Postgres
Ops / toolingĐơn giản, quen thuộc nhiều teamPhong phú extension (pgcrypto, logical replication, …)Skill team Owner vẫn là biến số
License / forkMySQL (Oracle) / MariaDBPostgreSQL (permissive)Không blocker; ghi nhận governance
Read-heavy đơn giảnRất mạnh với replica đơn giảnMạ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, invoice schemas).

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 ánMô tảƯuNhược
A. Một Postgres database + nhiều schemaVí dụ database minap chứa schema platform_core, file_service, payment, invoiceBackup/ops gọn; khớp quy ước tên vật lý = schemaQuyền/role phải siết; blast radius backup chung
B. Một Postgres database / bounded contextplatform_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ơnNhiều connection string, migration/ops nhân lên
C. Hỗn hợp MySQL + PostgreSQL trong cùng lớp platformVí dụ Core Postgres + Payment MySQLTố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 + schema public — lệch SoT schema platform_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:

  1. 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 đó.
  2. Hosting / managed service bắt buộc MySQL và không có Postgres tương đương.
  3. 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) ​

IDNội dungStatus
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 CorePostgreSQL; tên vật lý = schema platform_coreDECIDED
R3 — File / Payment / InvoicePostgreSQL; tên vật lý = schema file_service / payment / invoiceDECIDED
R4 — TopologyNon-prod: một Postgres database + nhiều schema (phương án A); isolation production vẫn OPENDECIDED (non-prod A)
R5 — Không dual-engine mặc địnhKhô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 GateDECIDED

9. Rủi ro nếu chọn ngược ​

Nếu…Rủi ro
Đổi Platform Core sang MySQL ngayMigration 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átChi phí Infisical/backup/runbook × N; QA khó chuẩn hóa
Giữ schema public làm SoTLẫn ownership; khó map cột “Tên vật lý” theo quy ước Owner

10. Bước tiếp ​

  1. Approve R1–R5 — xong (Owner 2026-11-16 → D-022).
  2. Align local Platform Core: schema SoT platform_core (đổi khỏi public nếu compose còn lệch).
  3. Chốt sau: backup/HA; isolation production (giữ A hay tách database).
  4. 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 ​

docs/ = SoT duy nhất · văn xuôi tiếng Việt + thuật ngữ chuyên ngành English