社区博客用户投稿专区

详见：社区博客进阶教程投稿板块。

最新投稿（2025.04.01 之后的投稿）

• 2025.04.09 @远疏 《OceanBase x Spark：OceanBase Spark Catalog 快速上手》，OceanBase Spark Connector 从 1.1 版本开始全面支持 Spark Catalog，通过使用 Spark Catalog，用户能够以更加简洁和一致的方式访问和操作 OceanBase 数据库。远疏大佬就为大家整理了一篇快速上手 OceanBase Spark Catalog 的博客，并会为大家介绍如何配置和使用这些新特性。个人奖励 200 积分！

• 2025.04.09 @爱可生_ActionDB 《OceanBase 字段扩容避坑：字符集变更导致 DDL 失败
  》，这篇文章与其说是 OceanBase 字段扩容避坑，不如叫教大家正确理解 MySQL modify column 的行为语义。这里我多说两句，大家选择性地阅读以下内容即可。MySQL 和 Oracle 中的 alter table modify column A B（A B 分别为列的两种属性）的语义不同。MySQL 是把原本的 column a b c d 改为 column A B （modify 时没写 C D，那改完之后 C D 属性就没了，或者说被改成了这俩属性的默认值），也就是可以理解成 MySQL 的 modify from origin to A B，写啥属性，就用写的属性替换现有的所有属性。Oracle 是把原本的 column a b c d 改为 column A B c d，也就是 modify column a to A and b to B，写啥属性，改啥属性，其他属性均保持不变。使用企业版时要区分 MySQL 和 Oracle 模式下 alter table modify column 的不同行为。MySQL 的 alter table 除了 modify column，还有 change column 和 alter column，看上去差不多，但实际三个语义全都不一样，更坑。当然，OB 的 MySQL 模式也兼容了 MySQL 的这些行为。只因 MySQL 本身的产品行为比较奇怪，所以 OB 为了兼容 MySQL 的行为，才会有和 MySQL 一样的这些使用上的不便之处。

早鸟投稿（截止到 2025.03.31 的投稿）

• 2025.02.10 @爱可生_ActionDB 《七步定位 OceanBase 登录报错》，为大家介绍了 OceanBase 数据库当前支持的 MySQL 客户端版本包括 V5.5、V5.6 和 V5.7，而对 MySQL 8.x 版本的客户端支持不够完善，推荐大家使用 OBClient 或者 5.x 版本的 MySQL 客户端链接 OB，可以避免踩坑。

• 2025.02.10 @爱可生_ActionDB 《OceanBase 备份清理任务卡死之谜》，带着大家一起分析了一个备份ing里人物卡住的问题，直接说结论： 用户生产未安装官方文档的要求配置 NFS，可能存在很多异常问题，包括备份清理问题。 由于 OceanBase 数据库备份的并发控制需依赖 NFS4 的文件锁功能，故在挂载 NFS 时，需使用 NFS 4.1 及以上版本。

• 2025.03.03 @爱可生_ActionDB 《OceanBase 单机改三副本的实操与深思》，记录和总结了从单副本扩展为三副本过程中踩到的各种坑。这篇文章有很好的踩坑经历 + 副本扩展经验，值得大家阅读和收藏，个人奖励 500 积分！@OceanBase文档 有空儿时也可以关注下这篇内容~

• 2025.03.03 @爱可生_ActionDB 《计算 OceanBase 可用 CPU 的核心逻辑》，为大家介绍了计算 OceanBase 4.x 可用 CPU 的核心逻辑。当大家在 OceanBase 中创建租户时，如果遇到因内存或 CPU 等资源不足导致的租户创建失败的情况，可以参考这篇文章对机器资源进行检查。

• 2025.03.13 @红目香薰 《OceanBase “百万级数据” 并发插入 + “千万级数据” 查询事务校验》，作者通过 OB 官网的 OB Cloud 一年免费试用，在 OB 1C 4G 的小规格测试环境中对功能和插入、查询的性能进行了测试，并给出了测试结论。期待后续为大家带来在更大的测试或者生产环境中的测试结果。个人奖励 500 积分！

• 2025.03.17 @shunwah 《从理论到实践：深入探索 OceanBase 原生分布式架构》，为大家介绍了在分布式数据库 OceanBase 中的分区使用方式，以及和动态扩容、分区管理相关的技巧，推荐大家阅读。个人奖励 500 积分！

• 2025.03.26 @ljware 《OceanBase 数据库 Oracle 租户类型下 “LEVEL” 的使用注意事项》，这篇文章为使用企业版 Oracle 租户的同学介绍了 LEVEL 关键字的特殊性。当使用 LEVEL 关键字作为列名时，可能会和 CONNECT BY 层次查询中的伪列 LEVEL 产生混淆，降低可读性，增加维护难度。目的是建议大家尽量注意不要使用关键字当做对象名，社区版用户可以选择性阅读。这篇博客刚好跟社区本周（2025.04.09）推送的《OceanBase 数据库开发规范》 4.1 小节 的内容直接相关，也欢迎大家阅读。

• 2025.03.28 @shunwah 《TP 与 AP 共生之道：OceanBase 4.3.5 HTAP 混合负载实战》，为大家介绍了 AP 与 TP 版本根据不同场景化选择方法，以及多租户隔离的精细化设计与行业实践和索引优化实践，最后还对 HTAP 混合负载的性能进行了测试和验证。内容量大管饱，欢迎阅读。个人奖励 500 积分！

• 2025.03.28 @爱可生_ActionDB 《OBLogProxy 在 Binlog 模式下的故障案例解析》，记录了一次 OBLogProxy 的异常和恢复方法。

• 2025.03.28 @爱可生_ActionDB 《OceanBase 增量代理日志服务重启异常》，又记录了一次 OBLogProxy 的异常和恢复方法。

• 2025.03.28 @爱可生_ActionDB 《带宽被 OBServer 备份 “榨干”，集群陷入 “无主” 危机》，记录了一次由于每日备份导致网络带宽打满，进而导致的后续其他问题的排查过程和分析方法。并给出了几种相应的解决方案。

• 2025.03.31 @芦薇 《OceanBase 对象管理（一）序列的管理及优化》，介绍了 OB Oracle 模式下 Sequence 使用建议，其实 OB MySQL 模式下也扩展支持了和 Oracle 兼容的 Sequence 功能，欢迎社区用户试用！最后看到这个（一）就知道不简单，期待后续能发布更多和数据库对象使用建议相关的内容。个人奖励 500 积分！

天使轮投稿

• 2025.01.07 @甯空《负载均衡终极解决方案》，利用企业的实践经验，为我们弥补了进阶教程中容灾设计章节缺失的与负载 VIP 相关内容。作为本次共建活动的第一个投稿，为大家开了个好头。个人奖励 1000 积分！

• 2025.01.08 @五月《OceanBase 后悔药 —— 误操作恢复指南》，为大家介绍了 OceanBase 中几种有效的恢复方法，为那些可能犯错的管理员们提供一份“后悔药”。传说中的 “单副本拉起”，也只是文中的冰山一角。个人奖励 1000 积分！

• 2025.01.10 @qchenzi 《在 K8S 上部署 OceanBase 的最佳实践》，为大家介绍了美的集团在使用 OceanBase 企业版在公司内部完成 “去 Oracle” 的目标之后，继续对 OceanBase 进行容器化部署的探索，以及详细的实践经验分享。是本地活动中第一个通过在 github 上提交 pull request 完成的投稿。个人奖励 1000 积分！

• 2025.01.18 @obpilot 《OceanBase 空间缩容实践》，专业且详细地为大家介绍了 OB 的空间资源分配原理，以及如何对 OB 的数据文件进行缩容。为咱们弥补了官网文档中只有扩容方法没有缩容方法的缺憾。个人奖励 1000 积分！

• 2025.01.20 @obpilot 《云服务器上 OB 部署实践》，通过云服务器环境分析、云服务器部署建议、云盘性能提升方法、网卡速率设置等几个部分，毫无保留地为大家分享了在云服务器或虚拟机环下境部署 OB 的实践经验。感谢庆涛大神在周末加班为社区用户分享了两篇这么优质的实践文章！个人奖励 1000 积分！

共建背景

今年九月十五日，我们开始编写和整理了一个《OceanBase 4.x DBA 进阶教程》，并在 2024.12.31 完成了初版内容。

编写之前，我们在【OceanBase 4.x DBA 进阶教程】用户意见收集这个帖子里发起了一次教程内容的建议收集。社区论坛里有不少用户在内容的安排上，提出了诸多宝贵建议。

在此教程即将完成之际，对所有提出建议的用户表示由衷的感谢！

共建需求

因为进阶教程的初版内容暂时还没有用户参与编写，还是偏 “学院派” 一些。在用户的建议中，也有一些需要依靠广大用户，群策群力才能完成的 “用户实践向” 内容。

所以，我们想在初版内容接近完成之际，组织一个大家一起共建《进阶教程》的活动。希望大家能够一起参与进来，在这本教程中真正留下你们的足迹。

共建需求十分简单：希望大家能把使用 OceanBase 社区版过程中，真实用过的方案，以及积累的运维经验，在这本进阶教程中分享给大家。包括但不限于：根据业务特点设计数据库部署架构的思路、各种周边工具的使用技巧、性能调优技巧、让你有成就感的问题排查和分析过程，以及使用 OceanBase 社区版过程中发现的各种奇技淫巧等等等等。

大家共建的投稿内容不需要像官网文档一样写的那么严肃，社区里的内容就应该更接地气一些（《进阶教程》的编写本身就很随意，甚至还夹带了一些私货）。

共建时间

即日起至 2025 年 6 月 30 日。

共建福利

• 对于每篇被选中的共建内容，除了会被收入到《进阶教程》中，还会得到超高额的积分奖励：

  • 天使轮投稿：前五个主动投稿并被选中的内容，奖励 1000 积分（由兹拉坦个人通过悬赏贴进行发放）。

  • 早鸟投稿：2025/3/31 之前的每篇投稿，如被选中，则积分 * 2.5 倍，奖励 500 积分（由兹拉坦个人通过悬赏贴进行发放）。

  • 2025/4/1 ~ 2025/6/30 之前的每篇投稿，如被选中，奖励 200 积分。

• 内容质量较高的共建内容，会通过征文计划评委 —— 开源生态技术部总经理 @longda 的推荐，直接进入征文计划评比的绿色通道，作者大概率会获得丰厚的 “物质” 奖励（详见征文计划链接）。

• 参与投稿并被收入教程的企业或个人，会通过 OceanBase 开源社区负责人 @fionaduan 的推荐，直接进入月度之星、年度之星评比的绿色通道。

• 投稿内容被选中的用户，可以进入我们专门为热爱分享的用户创建的一个 OceanBase 技术内容交流微信群，以便后续能够第一时间在群里和大家分享 OceanBase 的运维经验，以及交流与 OceanBase 相关的技术问题。

• 所有参与共建的用户，都会出现在 OceanBase 进阶教程电子书的致谢名单中。

参与进阶教程共建的方法

• 方法一：在论坛投稿，步骤详见这里。

• 方法二：在博客投稿，步骤详见这里。

• 方法三：在 github 上投稿，步骤详见这里。

• 方法四：除了向教程投稿，也可以通过教程捉虫参与共建。会根据贡献值大小，获得相应奖励。步骤详见这里。

特别声明

• 绝对禁止使用灌水文来参与此共建活动！

  • 禁止利用 AI 生成的水文参加此共建活动。

  • 禁止直接用从官网中复制黏贴一段内容来参加此共建活动。

  • 禁止复制黏贴论坛或博客中已经存在的技术内容来参加此共建活动。

  • 禁止其他一切 “搞破坏” 的行为。

  • 第一次违规，会在论坛中对违规者及违规行为进行公示，并禁言 30 天。如有第二次违规，永久封禁账号。 这个活动的目的是让大家来分享使用 OceanBase 的经验，只想刷积分的朋友请移步灌水乐园板块，不允许在这个活动中发布无意义的内容浪费大家的阅读时间。

• 共建活动之前就已经在社区发布的技术内容，也可以向 @兹拉坦 投稿来参与此次共建活动，但不会获得 @兹拉坦 个人提供的积分奖励。

• 如果大家对此共建活动有任何疑问，欢迎在本帖中留言评论，或者向 @兹拉坦 进行咨询。

共建内容范例

• DBA 误操作删错表导致业务中断，如何恢复？

• 利用混闪机型部署 OceanBase 集群的探索

• OceanBase 查询闪回实践

• OceanBase v4.x 如何查询锁？

• 通过 HAproxy 实现 OBproxy 的高可用

参与进阶教程共建的方法

方法一：在社区论坛投稿

可以通过在 “建议与反馈 —— 文档&教程优化需求” 板块发帖进行投稿。

• 标题：【OceanBase DBA 进阶教程投稿】XXXXX
• 板块：建议与反馈 文档&教程优化需求
• 内容：包括但不限于问题分析排查记录、周边工具使用技巧、性能调优技巧等运维经验。
  
  

  image1467×1171 81.3 KB

投稿后需要手动在这个帖子下方艾特兹拉坦进行通知，或者私聊兹拉坦。

image1348×623 85.9 KB

方法二：在社区博客投稿

还可以通过在社区博客中发文进行投稿。

• 标题：【OceanBase DBA 进阶教程投稿】XXXXX
• 内容：包括但不限于问题分析排查记录、周边工具使用技巧、性能调优技巧等运维经验。
• 标签：添加 “进阶教程投稿” 标签。

image1920×766 76.8 KB

发布内容后，需要到社区论坛给这个叫兹拉坦的用户发送私信消息，催促他来对你的内容进行审核。

image1348×623 85.9 KB

方法三：在 github 上提交内容

这种共建的方式，需要用户对 git 的使用有一些基础的了解。

需要大家有一个 github 的账号，并已经对你的开发环境进行过了配置。git 教程详见这里，本文不再详细赘述。

当然，在 github 上，提交内容远不止下文提及的通过命令行这一种方式，通过其他任何方式提交你的改动都是可以的。例如在 fork 仓库之后，直接在白屏页面通过 Add file、Contribute 等方式提交，可能会更符合部分用户的习惯。

步骤一

fork 项目，并添加上游仓库。

image2784×458 106 KB

image1920×739 80 KB

git clone https://github.com/your_name/oceanbase.github.io.git

cd oceanbase.github.io

# 添加上游仓库
git remote add upstream https://github.com/oceanbase/oceanbase.github.io.git

# 创建并切换新分支
git checkout -b your_branch_name

# 从远程仓库获取更新
git fetch upstream

步骤二

更新进阶教程的内容，并进行提交。

• 文档内容在 oceanbase.github.io/docs/user_manual/operation_and_maintenance/zh-CN/user_practice_co-construction/ 路径下（可参考已有内容进行添加）。例如：01_introduction.md。

• 图片内容在 oceanbase.github.io/static/img/user_manual/operation_and_maintenance/zh-CN/user_practice_co-construction/ 路径下（可参考已有内容进行添加）。例如：01_introduction/001.png。

• 如需增加新的大章节，则需要修改这个文件 oceanbase.github.io/sidebars.ts （可参考已有内容进行添加）。

• 过程中需要参考这个项目的 README 进行展示效果的测试，安装 yarn 之后，可以通过执行 yarn start && yarn build 来查看你提交的内容对应的网页渲染效果（这里可以在 .zshrc 或者 .bashrc 等文件中设置一个更简化的命令别名，例如 alias see='yarn start && yarn build' ）。

• 确认网页的渲染效果符合预期之后，执行以下命令序列，把你在本地的修改推送到远程仓库：

git add .

git commit -m "message of your content"

git fetch upstream

git merge upstream/master

# 这里可能需要解决冲突

git push origin your_branch_name

• 然后到 github 上通过 pull request 提交你的修改即可。

image3180×1072 322 KB

image3182×1146 224 KB

• 最后 reviewer 可以选 liboyang0730 这个人，并点击 request 催促他来 review 及合并你的内容（如果这个人很懒，没能及时 review 你的内容，还可以到社区论坛给一个叫兹拉坦的用户发送私信消息，继续催促他来 review）。

image3162×1898 426 KB

image1920×886 80 KB

步骤三

• 确认提交合并到主仓库之后，先手动 sync fork 一下 master 分支和你自己的分支。

image3172×1804 454 KB

image1902×702 122 KB

• 然后到你自己分支下执行 git fetch upstream 和 git merge upstream/master 拉取上游主分支的最新内容。
• 最后重复步骤二，即可继续提交新内容。

方法四：教程捉虫

可以通过在 “建议与反馈 —— 文档&教程优化需求” 板块发帖进行捉虫。

• 标题：【OceanBase DBA 进阶教程捉虫】XXXXX
• 板块：建议与反馈 文档&教程优化需求

同时欢迎大家在本帖中提出你对这个共建计划的建议，以及更有趣的共建想法~

很棒，大家积极参与。

欢迎 @obpilot @banjin @Giant @Livedba @ljware @Royce1220 @EINTR @AntTech_AMXM79 @皇甫侯 @咖啡哥 @五月 @坤易 @弋烆蘇 @宝耶 @治民 @无糖拿铁 @卡卡西 @靖顺 @渠磊 @爱可生_ActionDB 等一众活跃大佬，以及其他所有社区用户，都能够在这个共建活动中肆无忌惮地和大家分享各种技术内容！

加油加油

2025-01-07 15:07:20，在活动刚刚正式发起还不到一天的时候，@甯空 老师通过社区博客发起了第一篇共建投稿《负载均衡终极解决方案》！

image737×249 13.4 KB

@甯空 老师的这篇博客《负载均衡终极解决方案》，利用企业的实践经验，为我们弥补了进阶教程中容灾设计章节缺失的与负载 VIP 相关的内容，欢迎大家阅读！

这篇博客也即将被收入到进阶教程中的对应章节（可能会有补充和调整）。

image1496×922 97.3 KB

值得纪念的时刻，值得纪念的内容，值得纪念的用户，真是值得纪念呀！

请 @甯空 老师有空儿的时候在 进阶教程共建投稿《负载均衡终极解决方案》积分发放贴 中领取一下 1000 积分的奖励~

张老师，你的单副本拉起之术呢？

哈哈一直犹豫没发出来，等我忙完这两天发出来

期待五月大作！

期待！！！！

头像~蚂蚁也穿上棉服了

求一篇《tidb迁移oceanbase最佳实践》