Skip to content

Releases: 17741421897/xiaozi-mysql

Release list

v1.0.0

v1.0.0 Pre-release
Pre-release

Choose a tag to compare

View all tags
@17741421897 17741421897 released this 04 Jul 03:47
v1.0.0
2d5a35a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

小紫 MySQL — 产品特色与能力说明

贤紫优选 · 小紫基础设施系列
文档版本：v1.0 · 2026-07

一、产品定位

小紫 MySQL 是一款面向企业自建 MySQL 的 一站式部署与运维桌面工具。通过图形化向导与自动化脚本，把「装库、搭集群、日常维护、备份迁移」从命令行搬到可点击、可追踪、可复现的流程里。

维度 说明
产品形态 Windows 桌面应用（Electron），通过 SSH 管理远程 Linux
目标用户 DBA、运维工程师、ISV 交付、中小企业 IT
核心价值 复杂 MySQL 集群运维 — 图形化、自动化、可追溯
系列定位 与小紫 Redis、小紫 MongoDB 同属「小紫基础设施」产品线，工程范式对齐小紫 Redis

二、六大产品特色

1. 四阶段平滑演进，一套工具走完全生命周期

不强迫企业「一步到位上分布式」。从单机试点到主从读写分离，再到 MGR 高可用，最后到分片横向扩展，同一套产品、同一套运维登录 覆盖全路径，并支持阶段间 数据迁移 升级架构。

单机 → 主从 → MGR 组复制 → 分布式（分片 + Proxy）

2. 远程自动化部署，开箱即用的最佳实践模板

  • SSH 一键安装 MySQL（yum / 本地上传安装包）
  • 自动生成并下发 my.cnf、systemd、防火墙规则
  • GTID 主从、MGR 组复制、ShardingSphere-Proxy 5.x 分片集群均有 分步/一键部署
  • 部署过程 实时日志抽屉，支持取消、持久化，操作可追溯

3. 统一运维会话（OpsSession）

一次登录，维护、监控、备份、迁移、管理后台 共用连接上下文：

  • 自动识别拓扑：单机 / 主从 / MGR / 分布式
  • 从已保存部署配置 一键导入 连接信息
  • 敏感凭据留在主进程，不暴露给前端页面

4. 专业级数据迁移（含分布式 Proxy 场景）

  • 支持外部 MySQL、会话节点、本地 SQL/备份包等多种来源
  • 迁入 ShardingSphere Proxy 时自动适配分库/分表/分库+分表
  • 结构阶段：各分片直连建物理表 + REFRESH TABLE METADATA
  • 速度档位：自动 / 稳妥 / 均衡 / 激进（按 CPU/内存推荐）
  • 冲突策略：遇错停止 / 跳过已存在（增量续迁）/ 覆盖已存在
  • 管道直连、mysqldump 参数自动消毒（锁表、Proxy 不兼容项）

5. 可观测 + 可治理

  • 多维度监控：复制状态、性能指标、进程列表、库表容量等
  • 分布式专项：分片巡检、路由与数据源一致性诊断
  • 日志管理：error / slow / binlog 扫描与清理
  • 逻辑备份：mysqldump 全库/单库，备份列表与恢复

6. 私有化友好，对标云分布式能力边界清晰

  • 适合 内网、政企、金融隔离区、交付现场 无法使用公有云 RDS 的场景
  • 分布式能力基于 ShardingSphere-Proxy + 多分片 MySQL，透明 SQL 路由
  • 与 PolarDB-X、TDSQL 等托管产品相比：自主可控、私有化部署，存储扩容需手动加分片/升配（文档与 UI 均有说明）

三、四阶段架构与能力对照

企业 MySQL 建设遵循 由轻到重 的路径。下表说明每个阶段 解决什么、不解决什么，以及工具提供的核心能力。

阶段 架构形态 典型痛点 工具核心能力 典型场景 不适用于
一：单机 单实例 MySQL 安装繁琐、参数不懂 单机部署、参数模板、服务管理、单机维护与监控 开发测试、POC、小业务、边缘节点 高可用、写扩展、海量数据
二：主从 一主多从 + GTID 读压力大、要热备、复制中断 主从批量部署、复制监控与修复、读写分离基础、备份恢复 读多写少、报表从库、同城灾备 自动故障切换、无限写扩展
三：MGR InnoDB Cluster / 组复制 主库宕机要自动切换 MGR 部署与卸载、成员监控、在线扩缩容 生产核心库、金融/电商订单库 HA 数据分片、单机装不下的 TB 级单库
四：分布式 多分片 + ShardingSphere-Proxy 内存/QPS/磁盘到顶 分片部署、分片规则管理、Proxy 同步、分片扩缩容、Proxy 迁入迁移、分片巡检 企业库、爬虫库、日志库、多租户 SaaS 数据层 跨分片复杂 JOIN 当单机用

阶段演进示意

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌──────────────────────┐
│  阶段一     │    │  阶段二     │    │  阶段三     │    │  阶段四              │
│  单机部署   │ ─► │  主从复制   │ ─► │  MGR 高可用 │ ─► │  分片 + Proxy 扩展   │
│  快速验证   │    │  读扩展     │    │  自动切换   │    │  写+读横向扩展       │
└─────────────┘    └─────────────┘    └─────────────┘    └──────────────────────┘
       │                  │                  │                        │
       └──────────────────┴──────────────────┴──── 数据迁移贯穿各阶段 ──┘

容量与架构选型指引

现象 建议阶段 工具动作
机器内存小、SQL 慢 一 + 调优 参数模板、innodb_buffer_pool 建议
读 QPS 高、主库压力大 二 加从库、复制监控
主库故障不可接受 三 部署 MGR、扩缩容
单库数据量/写入装不下 四 分片规则 + Proxy + 迁入迁移
历史冷数据归档 业务归档 + 可选分片 迁移工具辅助搬迁

四、功能能力全景（按模块）

4.1 部署模块

能力 说明
单机部署 CentOS 远程安装 MySQL 5.7，目录规划、服务注册、卸载（保留/删除数据）
主从复制部署 1 主 N 从批量添加，GTID，5.7 复制语法自动适配
MGR 组复制部署 多成员组复制，种子节点、组通信端口、防火墙
分布式集群部署 多分片 MySQL + ShardingSphere-Proxy 5.4.1，Java 11、JDBC 驱动
本地上传安装 支持离线环境上传 MySQL 安装包、Proxy 包、JDK 包
部署日志 流式输出、进度条、可取消、可清空

4.2 运维模块

能力 说明
运维登录 单机 / 主从 / 集群(MGR) / 分布式(Proxy) 四种模式
集群维护 诊断、复制修复、服务控制、只读切换（按拓扑）
实例监控 复制延迟、状态变量、进程列表等（按拓扑分页面）
性能大盘 QPS/TPS/连接数/InnoDB/磁盘趋势图（ECharts，7 天落盘）
慢 SQL 分析 P_S Top N、慢日志聚合、EXPLAIN
告警中心 阈值规则、桌面/Webhook/邮件、Prometheus /metrics
深度诊断 P_S/sys 视图、锁等待链、死锁解析
后台监控 托盘常驻、30s 采集、运维登录可加入监控列表
MGR 扩缩容 在线加成员、缩容移除节点
分布式扩缩容 加分片、缩容，Proxy 配置联动
分片规则管理 多逻辑库、逻辑表、分库/分表/分库+分表规则，在线同步 Proxy
分布式巡检 分片健康、数据源映射、诊断报告
MySQL 管理 库表用户、SQL 执行、进程查杀、变量查看
日志管理 慢日志、错误日志、binlog 扫描与维护
备份恢复 mysqldump / mydumper / XtraBackup、定时调度、SSL 一键配置
数据迁移 全量/增量、管道迁移、Proxy 专业迁入、预检、迁移历史

4.3 平台与安全

能力 说明
贤紫优选账号登录 企业软件统一门禁
免责协议 首次使用确认
进程隔离 Main / Preload / Renderer，凭据不暴露给页面
IPC 白名单 敏感操作需已登录且已建立运维会话
配置持久化 部署配置、运维会话、迁移历史本地保存

五、数据迁移能力详解（高频场景）

迁移路径 适用阶段 要点
外部 MySQL → 单机 一 管道直连 / SSH 中转，mysqldump 参数可配
单机 → 主从 一→二 先迁数据再上复制
主从 → MGR 二→三 低峰切换，复制状态确认
单机/主从 → Proxy 分片 →四 须先「结构+数据」完整迁入；续迁用「仅数据+跳过已存在」
分片集群内迁表 四 分片规则注册 + 物理表与源 DDL 一致
本地 SQL / 备份包 全阶段 上传至执行节点导入

Proxy 迁入专业特性（阶段四专属）：

  1. 结构：各分片 DROP 旧表 → 源库真实 DDL 建物理表 → REFRESH TABLE METADATA
  2. 数据：仅 INSERT 经 Proxy，自动路由分片键
  3. 自动关闭锁表、DROP TABLE 等 Proxy 不兼容 mysqldump 选项
  4. 速度档位 + 多表并行 + 可取消的长任务管道

六、适用行业与典型客户画像

工具不绑定单一行业，下列为 高频匹配场景（自建 MySQL、有 SSH 权限、希望降低 DBA 重复劳动）：

行业/领域 典型诉求 推荐阶段 工具价值
互联网 / SaaS 多租户数据增长、活动峰值 二→四 主从扛读、分片扛写；迁移上云前私有化部署
电商 / 零售 订单、商品、库存；大促 二、三 MGR 保订单库 HA；报表走从库
政企 / 信创 内网隔离、不可上公有云 一～四 全链路私有化；SSH 批量交付
金融 / 支付（非核心交易库） 账务、对账、风控数据 二、三 GTID 复制、MGR；审计日志与慢 SQL 治理
制造 / ERP / MES 工厂边缘库、总部汇总 一、二 单机/主从；备份与迁移
医疗 / 教育 业务系统、历史数据归档 一、二 备份恢复、日志清理
数据采集 / 爬虫 / 日志 单表亿级、写入密集 四 分表分库；Proxy 迁入（如企业库、进度表）
ISV / 集成商 客户现场交付、验收 一～四 可视化部署日志、可复现步骤、降低现场人力
研发测试 快速起环境、灌测试数据 一 单机一键部署 + 迁移

七、与同类方案对比（简表）

维度 手工脚本 / Ansible 云 RDS / 分布式 SQL 小紫 MySQL
学习成本 高（需熟 MySQL + OS） 低（控制台） 中低（向导 + 提示）
私有化 ✅ ❌ 或受限 ✅
四阶段一体 ❌ 需多套方案 部分（按产品买） ✅
部署可追溯 看脚本/日志 云审计 DeployLog 全记录
Proxy 分片迁入 需自研 云厂商工具链 内置专业管道
运维 GUI 无 / 第三方 控制台 统一运维台

八、技术栈与运行环境

项目 说明
客户端 Windows 10/11，Electron 桌面安装包
服务端 推荐 CentOS 7 / Rocky 8，SSH + systemd
MySQL 5.7.x、8.0.x（复制语法自动分支）
分布式 ShardingSphere-Proxy 5.4.1，OpenJDK 11
技术栈 Electron · React · TypeScript · Ant Design · mysql2 · ssh2 · ECharts

九、能力成熟度说明（诚实边界）

以下能力 已具备或持续增强，以下 需结合环境或二期规划：

已具备（当前版本重点） 规划中 / 需留意
四模式部署 + 卸载 ProxySQL 读写分离模块
主从/MGR/分布式 维护与监控 + 性能大盘 Vitess / K8s 方案
慢 SQL 分析 + 深度诊断 + 告警/Prometheus MGR/主从自动故障切换（仅监控告警）
分片规则在线同步 + 巡检
Proxy 专业数据迁入 + 增量续迁
mysqldump + mydumper + XtraBackup + 定时备份
日志扫描与维护 + SSL 一键配置

分布式已知限制（须在选型时知晓）：

  • 分片键选定后 难以在线修改
  • 跨分片 JOIN / 分布式事务 受中间件能力限制
  • 分片不等于 MGR 级自动故障转移（高可用需在分片内另做主从或 MGR）

十、一句话总结

小紫 MySQL = 私有化场景下的 MySQL 全生命周期工作台：从一台机器装起，到主从扛读、MGR 扛宕机、分片扛数据量，部署可追踪、运维可登录、迁移可专业迁入。

附录：菜单能力速查

菜单 对应能力
部署 · 单机 阶段一
部署 · 主从 阶段二
部署 · MGR 阶段三
部署 · 分布式 阶段四
运维登录 四种拓扑统一入口
维护 / 监控 按拓扑分派
集群扩缩容 / 分布式扩缩容 阶段三、四
分片规则 阶段四逻辑库表与 Proxy 规则
分布式巡检 阶段四健康检查
MySQL 管理 通用 DBA 操作
日志管理 慢日志、错误日志、binlog
性能大盘 指标趋势图
慢 SQL 分析 P_S + 慢日志 + EXPLAIN
告警中心 规则 + 通知 + Prometheus
深度诊断 P_S/sys/锁/死锁
备份恢复 多引擎备份 + 定时 + SSL
数据迁移 全阶段，含 Proxy 专业迁入

贤紫优选 · 小紫基础设施系列 · 与小紫 Redis 工程同构、与 MongoDB 产品能力对标

Loading