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

Bài 13: MySQL Shell: script Python, JavaScript và tự động hóa an toàn

MySQL Shell: script Python, JavaScript và tự động hóa an toàn

Viết script MySQL Shell có session, mode và lỗi rõ ràng; bắt đầu bằng status, bảo vệ credential, kiểm soát switchover và xác minh backup.

Một script trả về “OK” nhưng chưa mở session đúng server hoặc chưa kiểm tra exit code chỉ tạo cảm giác an toàn. Tự động hóa quản trị database nên bắt đầu từ tác vụ đọc có thể chạy lại, rồi mới mở rộng sang thay đổi topology.

Phần 7 dùng MySQL Shell 8.4. Lệnh ở terminal, SQL, JavaScript và Python được tách riêng. Mã là ví dụ biên tập, chưa được thực thi trên cluster thật; chạy bằng mysqlsh, không mặc định Python hệ điều hành có sẵn AdminAPI.

Chọn một tác vụ đọc và định nghĩa kết quả

Tác vụ đầu tiên là đọc trạng thái labCluster, xuất JSON và trả lỗi khi không kết nối/không lấy được object. Script cần biết target, version, quyền, timeout và nơi ghi log. Không dùng tài khoản ứng dụng quyền hạn chế để rồi cấp thêm ALL chỉ vì script lỗi.

Phân biệt trạng thái lệnh chạy được với cluster đạt tiêu chí của tổ chức. Trạng thái OK, số member, role và cảnh báo đều có thể cần kiểm tra riêng. Kết quả phải có timestamp cùng nguồn instance; log không được chứa password hoặc URI có bí mật.

Tách prompt Shell khỏi mã ngôn ngữ

mysqlsh --mysql --js clusteradmin@mysql-node1:3306
\sql
SELECT VERSION(), @@hostname;
\js
var cluster = dba.getCluster('labCluster');
cluster.status();

Backslash command là lệnh tương tác của Shell, không phải Python syntax để đưa vào file .py. JavaScript dùng camelCase như getCluster; Python dùng API naming phù hợp như get_cluster. Dùng --js hoặc --py tường minh thay vì dựa mode của phiên cũ.

Classic session dùng cho AdminAPI ở ví dụ. X DevAPI là API/protocol riêng cho các tác vụ tương ứng; không cần tạo mysqlx session và nhét credential vào URI để đọc status.

Script đọc có hợp đồng rõ
MySQL Shell Python/JS có session được chọn. Switchover là tác vụ thay đổi có phê duyệt riêng. Không tự force quorum sau timeout của healthcheck.

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ử.

File script nhận session đã kết nối

mysqlsh --mysql --py clusteradmin@mysql-node1:3306 \
  --file=/opt/mysql-ops/healthcheck.py
# Chạy bằng mysqlsh --py với session đã kết nối
import json
from datetime import datetime, timezone

cluster = dba.get_cluster('labCluster')
status = cluster.status({'extended': 1})
print(json.dumps({
    'checked_at': datetime.now(timezone.utc).isoformat(),
    'status': status
}, ensure_ascii=False))

Trong thao tác tay, password prompt phù hợp. Job không tương tác cần credential store/helper theo Shell và môi trường, được cấp quyền file/OS đúng cách; không truyền --password=secret trên command line. Để exception làm job thất bại thay vì catch rồi luôn in success. Kiểm tra exit code từ scheduler và giữ stdout/stderr tách biệt khi cần parse JSON.

Switchover không phải healthcheck thường kỳ

Chuyển primary là thay đổi vận hành, không đưa vào script kiểm tra chạy mỗi phút. Trước khi gọi, cần đủ quorum, target ONLINE và bắt kịp, kiểm tra transaction/backup, cửa sổ bảo trì, đường Router và retry của ứng dụng.

var cluster = dba.getCluster('labCluster');
cluster.setPrimaryInstance('mysql-node2:3306');
cluster.status({extended: 1});

Mẫu chỉ dùng trong lab hoặc thay đổi đã phê duyệt. Đo lỗi phiên cũ, thời gian reconnect và kết quả nghiệp vụ; không hứa chuyển mạch nguyên tử ở góc nhìn mọi client. Khi kết quả không rõ, đọc lại topology trước retry lệnh và không tự tắt primary cũ.

Quét schema để rà soát, không tự sửa bảng

SELECT t.table_schema, t.table_name
FROM information_schema.tables AS t
WHERE t.table_type = 'BASE TABLE'
 AND t.table_schema NOT IN
 ('mysql','sys','performance_schema','information_schema',
  'mysql_innodb_cluster_metadata')
 AND NOT EXISTS (
   SELECT 1 FROM information_schema.table_constraints AS c
   WHERE c.table_schema=t.table_schema
    AND c.table_name=t.table_name
    AND c.constraint_type='PRIMARY KEY'
 );

Đây là SQL rà các bảng thiếu primary key tường minh trong phạm vi nhìn thấy. Không tự kết luận mọi kết quả đều vi phạm Group Replication, vì manual có điều kiện khóa tương đương và các ngoại lệ cần xét. Không chạy ALTER TABLE tự động trên mọi kết quả.

Nếu gọi từ JS/Python, dùng session SQL đã biết; không giả định chuỗi cluster.getPrimaryInstance().getSession() tồn tại. So metadata qua account có quyền phù hợp và đưa kết quả vào review schema.

Quy trình kiểm tra MySQL Shell: script Python, JavaScript và tự động hóa an toàn
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ử.

Job dump cần đường dẫn mới và nghiệm thu

from datetime import datetime, timezone

run_id = datetime.now(timezone.utc).strftime('%Y%m%dT%H%M%SZ')
path = '/backups/app_lab_' + run_id
util.dump_schemas(['app_lab'], path, {
    'threads': 4, 'compression': 'zstd',
    'consistent': True, 'showProgress': False
})
print('Dump finished; restore validation still required.')

Mẫu chạy bằng MySQL Shell Python đã kết nối nguồn, backup path có quyền bảo vệ và dung lượng. Ngăn hai job trùng nhau bằng cơ chế lock của scheduler. Dump thành công chưa xác nhận RPO/RTO; job restore độc lập và kiểm tra dữ liệu vẫn cần thiết.

Không tự xóa backup cũ trong cùng script mẫu. Retention cần xét chuỗi binlog, incremental, offsite và khả năng đọc khóa mã hóa. Khi job lỗi, lưu nguyên nhân và trạng thái output trước khi thử lại.

Bật automation theo cấp độ rủi ro

Đi từ read-only status, tới báo cáo, tới tác vụ có phê duyệt và cuối cùng mới cân nhắc tự động sửa có guardrail. Thử mất kết nối, credential hết quyền, JSON thiếu field và chạy lặp để thấy script dừng đúng. Tránh suy nội dung log bằng regex mong manh nếu API có cấu trúc.

Checklist: target tường minh, session/mode đúng, credential không lộ, lỗi có exit status, job không chồng, backup được restore. Force quorum và complete-outage recovery thuộc runbook có quyết định của người vận hành, không phải phản xạ tự động sau timeout.

Scheduler báo thành công nhưng script không kiểm tra cluster

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

Giả sử script catch mọi exception rồi in “OK” để scheduler không gửi nhiều cảnh báo. Khi credential hết hạn hoặc session target sai, công việc vẫn xanh. Đây là lỗi hợp đồng output: kết quả chạy process bị đánh đồng với kết quả kiểm tra.

Tách lỗi kết nối, lỗi lấy cluster và kết quả trạng thái. Exception không xử lý nên dẫn tới exit code lỗi; nếu xử lý có chủ đích, vẫn trả mã lỗi phù hợp và log không chứa secret. Đừng chỉ tìm từ OK trong stdout vì JSON status có thể mang cảnh báo ở field khác.

Thử script trong lab với target không tồn tại, account chỉ đọc đúng quyền và file output không ghi được. Kiểm tra scheduler có giữ stderr, thông báo cho người trực và ngăn job chồng. Một tác vụ đọc có thể chạy lại, nhưng backup tạo thư mục hoặc thay primary cần idempotency/phạm vi riêng.

Đặt acceptance criteria dưới dạng trường dữ liệu và điều kiện rõ ràng, có version schema nếu hệ downstream phụ thuộc. Khi nâng Shell, chạy lại các case lỗi này trước khi đưa binary mới vào job định kỳ. Không gọi script “an toàn” chỉ vì không có lệnh DROP.

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