Chuyển đến nội dung chính (Skip to content)
Mục lục bài viết
MySQL

Bài 11: MySQL Router: tách endpoint đọc/ghi và kiểm tra failover

MySQL Router: tách endpoint đọc/ghi và kiểm tra failover

Cấu hình MySQL Router theo route thực tế, phân biệt 6446/6447 với read/write splitting và nghiệm thu failover từ phía ứng dụng.

Primary đã đổi nhưng ứng dụng vẫn kết nối vào IP cũ là một khoảng hở thường gặp khi chỉ kiểm tra cluster.status(). MySQL Router cung cấp endpoint ổn định hơn, nhưng cần cấu hình route và xử lý lỗi của client đúng với cách ứng dụng dùng kết nối.

Phần 5 dùng Router 8.4 và InnoDB Cluster single-primary của lab. Bài phân biệt endpoint đọc/ghi truyền thống với tính năng read/write splitting; không xem hai cơ chế này là một.

Router định tuyến kết nối, không nhân bản dữ liệu

Router theo dõi metadata để chọn backend phù hợp với route. Endpoint read/write thường phục vụ primary; read-only route dùng các secondary và có policy fallback cụ thể. Một kết nối đã được gắn backend không đồng nghĩa mỗi SELECT sẽ được cân bằng lại sang node khác.

Tính năng read/write splitting có điều kiện về giao thức, connection sharing, statement và cấu hình riêng. Nếu ứng dụng đã tách hai pool, hãy kiểm chứng route của hai pool trước; đừng đổi sang một endpoint mới mà không thử transaction/session state và read-after-write.

Chọn vị trí theo failure domain

Router gần ứng dụng có thể giảm phụ thuộc một gateway tập trung, nhưng vẫn cần quản lý process, cập nhật cấu hình và quan sát. Một nhóm Router riêng cần HA của chính nhóm đó. Localhost không khiến mọi độ trễ mạng biến mất vì Router vẫn phải tới database.

Ghi rõ frontend bind address, cổng ứng dụng dùng, backend network và TLS ở cả hai chặng. Không mở listener trên mọi interface nếu ứng dụng chỉ local. Tài khoản bootstrap có quyền cao hơn account runtime của Router và account nghiệp vụ.

Router: endpoint khác tính năng splitting
Default bootstrap Router 8.4; luôn đọc config thực tế. conf-base-port/policy có thể đổi giá trị. Hai endpoint đọc/ghi không đồng nghĩa tự phân loại mọi SQL.

Cuộn ngang hoặc chạm sơ đồ để mở bản đầy đủ. Hình được biên tập, không phải ảnh chụp kiểm thử.

Cài đúng nhánh và chuẩn bị thư mục riêng

Dùng repo Oracle theo nền tảng hỗ trợ và chọn package Router 8.4 tương thích. Xác nhận version binary trước bootstrap. Không dùng tên package hoặc service của một distro làm cam kết cho mọi bản cài.

mysqlrouter --version
mysqlrouter --help

Lab dưới dùng directory deployment trong thư mục riêng được cấp quyền cho user dịch vụ. Nó không tự chứng minh unit systemd mặc định đang đọc file đó. Chọn một phương thức deployment và kiểm tra đường config thực sự được chạy.

Bootstrap tạo cấu hình và credential runtime

mysqlrouter --bootstrap clusteradmin@mysql-node1:3306 \
  --directory=/srv/mysqlrouter/app-router \
  --name=app-router-lab

Chạy với quyền sở hữu thư mục phù hợp, không nhúng mật khẩu; đọc prompt và file tạo ra. Bootstrap có thể tạo account/metadata cho Router, vì vậy cần lưu config trước nếu re-bootstrap. Chỉ dùng thư mục lab mới hoặc đã có kế hoạch thay thế.

Bảo vệ keyring, file cấu hình và dynamic state theo hướng dẫn Router. Không copy credential của Router vào application pool. Sau bootstrap, đọc destination, routing_strategy, bind_address và port thay vì đoán từ tài liệu cũ.

Đọc port thực tế: 6446/6447 khác 6450

Với bootstrap defaults hiện hành của Router 8.4, Classic read/write thường 6446, Classic read-only 6447; X Protocol dùng 6448/6449. Các số 64460/64470 là defaults lịch sử trước thay đổi của Router, không nên gọi mặc định hiện tại.

Port 6450 dùng cho route read/write splitting khi được tạo/bật với cấu hình tương ứng. Dù port quen thuộc, config thực là căn cứ: conf-base-port và tùy chọn bootstrap có thể đổi nó. Read-only route không cấp quyền SELECT cho account và không thay grants phía server.

Quy trình kiểm tra MySQL Router: tách endpoint đọc/ghi và kiểm tra failover
Các điểm kiểm chứng theo chủ đề; không phải mọi kết quả đều dẫn tới một nguyên nhân duy nhất.

Cuộn ngang hoặc chạm sơ đồ để mở bản đầy đủ. Hình được biên tập, không phải ảnh chụp kiểm thử.

Khởi chạy đúng config và xác nhận listener

mysqlrouter --config=/srv/mysqlrouter/app-router/mysqlrouter.conf

Mẫu chạy foreground trong lab để đọc log, không phải lệnh bật production daemon. Nếu dùng systemd, tạo/đối chiếu unit có User, quyền file và ExecStart trỏ đúng config. Không bật service mặc định rồi mặc nhiên cho rằng nó dùng directory vừa bootstrap.

ss -ltnp

So listener với config, rồi kiểm tra route bằng account ứng dụng. Log có thể chứa topology và thông tin nhạy cảm; chỉ thu thập đủ phục vụ chẩn đoán. Router process sống chưa bảo đảm backend đủ quorum hoặc kết nối SQL thành công.

Nghiệm thu route và giới hạn failover

mysql --host=127.0.0.1 --port=6446 --user=app_lab --password \
  -e "SELECT @@hostname, @@read_only, @@super_read_only;"

Tương tự thử một kết nối mới qua port read-only thực tế. Dùng read_only/super_read_only, không dùng innodb_read_only để suy vai trò Group Replication. Lặp kết nối mới giúp quan sát route, nhưng không bảo đảm chia đều tuyệt đối trong mọi policy.

Trong diễn tập được phép, đo failover từ phía ứng dụng: lỗi phiên cũ, reconnect, kết quả commit và retry idempotent. Không có bảo đảm 1–2 giây hay zero downtime. Checklist: port/config đúng, TLS, runtime credential, route đúng role, backend quorum và giao dịch nghiệp vụ sau chuyển vai trò.

Port 6446 mở nhưng ứng dụng không ghi được

Tình huống giả định để luyện phân tích, không phải kết quả đo.

Giả sử TCP tới Router thành công, nhưng INSERT báo lỗi. Đầu tiên dùng account ứng dụng kiểm tra hostname, role server, grant và SQL error. Listener sống chỉ cho biết Router nhận kết nối; backend có thể thiếu quorum, route chọn khác dự kiến hoặc account chỉ có SELECT.

Đọc config mà process thực dùng, không file vừa bootstrap ở thư mục khác. Với systemd, đối chiếu ExecStart và User; với directory deployment, xác minh runtime files và quyền. Một unit đang chạy config cũ có thể khiến test nhìn khác toàn bộ dự đoán.

Nếu lỗi xuất hiện sau primary change, kiểm tra metadata refresh và kết nối mới. Phiên cũ bị ngắt có thể là hành vi phải xử lý ở client; không tiếp tục một transaction dở dang bằng cách replay mù. Với kết quả commit không rõ, ứng dụng cần khóa idempotency hoặc đối soát trước retry.

Với read-only route, SELECT thành công không xác nhận freshness đáp ứng nghiệp vụ. Xác định yêu cầu read-after-write, consistency và nơi đọc. Bài kiểm thử nên kiểm tra cả định tuyến lẫn nội dung nhìn thấy ở thời điểm có điều kiện, không chỉ tên node luân phiên.

Nguồn đối chiếu và bài đọc tiếp

Phạm vi tham chiếu là tài liệu theo phiên bản ghi trong bài. Khi áp dụng, đối chiếu model triển khai, bản patch và quyền đang dùng; các ví dụ chưa được kiểm thử trên máy chủ thật.

Tiếp tục theo mạch kiến thức:

Tìm hiểu thêm

Xem toàn bộ lộ trình MySQL