欢迎来到 MariaDB 中文社区文档
一个面向新手、AI 开发者与云上用户的现代 MariaDB 知识库
这是什么？
这是一份中文优先、多语种的 MariaDB 文档与学习资料。我们不打算复制 mariadb.com/kb 那本几千页的"参考手册"，而是用任务驱动和场景化的方式重新组织 MariaDB 的知识，目标读者是：
- 新人 / 学生：第一次接触关系型数据库，希望少踩坑、快上手；
- AI 开发者 / Vibe Coder：用 Cursor、Claude Code、Windsurf 写代码，需要 LLM 友好的 schema、MCP 接入、向量检索等姿势；
- 云上用户：选 AWS RDS、阿里云 RDS、腾讯云 CDB、Azure 还是 SkySQL？怎么从 MySQL 迁过来？
为什么不直接看官网？
老牌数据库的官网文档大多停留在 2010 年代的信息架构：
- 入口繁多但门槛高，缺少"我现在该做什么"的引导；
- 缺乏中文化深度（官方中文社区文档多年未更新）；
- 几乎没有覆盖 AI 时代的开发范式（Agent、MCP、向量、自然语言到 SQL）；
- 云上使用部分散落在各云厂商的文档里。
我们想把这些缺口补上。
从哪里开始？
第一次来？
想做 AI 应用？
MCP Server 实战
给 MariaDB 写一个生产级 MCP，含 SQL 注入护栏。
RAG with VECTOR
用 MariaDB 11.8+ 原生向量替代 pgvector。
事故合集
别人怎么把数据库搞坏的——8 个真实事故复盘。
想迁过来？
部署到云？
云 RDS 对照
AWS / 阿里 / 腾讯 / SkySQL 实测与选型。
跨云迁移
DTS / Debezium / 双写切流三种方案。
魔改版真相
Aurora / PolarDB / Lindorm / TDSQL 兼容到什么程度。
想深入原理？
InnoDB 内部
B+ 树、Buffer Pool、Redo / Undo、MVCC。
优化器深度
Hash Join、Condition Pushdown、ANALYZE。
复制与锁
异步 / 半同步 / Galera + 行锁 / Gap Lock。
实战工程
ORM / 驱动
Python / Node / Go / Java / Rust / PHP / Ruby。
Docker / K8s
Compose 模板、Operator、Helm chart、备份 CronJob。
行业 schema 案例
电商 / SaaS / 游戏 / IoT / Fintech / CMS。
参考与故事
当前版本快照
本节会随 MariaDB 官方发布节奏更新。
- 最新 LTS：MariaDB 12.3 LTS（2026-05 发布）—— 生产首选
- 上一代 LTS：11.8 LTS（VECTOR GA）与 11.4 LTS（支持至 2029）仍在维护
- 滚动主线：12.0 / 12.1 / 12.2 已全部 EOL 并被 12.3 LTS 取代；下一轮滚动版尚未开始，想尝鲜直接用 12.3
- MySQL 上游同步：MariaDB 已与 MySQL 完全分叉，不再回合上游
详见 版本与分支。
参与贡献
这个站点本身开源，欢迎在 GitHub 上：
- 提 issue 报告错误或建议主题
- 提 PR 翻译韩语 / 西语 / 葡语
- 把你踩过的 MariaDB 坑写成文章贡献进来
💡 AI 友好提示：本站每篇文档都可以追加
.md后缀获取 LLM 友好的纯文本版本（即将上线），方便你的 Agent 直接消费。