DDL 失败报错 5627，schema 槽位满的原因和解决方法

问题现象

在 OceanBase 数据库的测试环境中，当并发执行 DDL 脚本时，出现了错误代码 5627，提示 schema 槽位满导致 DDL 执行失败。即使将并发度降低至 2，仍然会出现报错现象，但在进一步降低并发度至 1 时，问题有所缓解。

关键信息

• 错误代码 5627（OB_SCHEMA_EAGAIN）出现在 schema 槽位满的情况下。

• schema 槽位可以看 __all_virtual_schema_slot，默认值为 128。

• 每次槽位满时打印出的 schema 版本对应的时间戳大多在 15 秒的间隔内。

• schema 槽位的释放机制包括：session 上有新的请求且有更新版本的 schema 时进行刷新；session 上一直无新请求，当前 schema 已占用超过 10 秒时进行释放；session_mgr 每 5 秒检查并触发上述逻辑。

问题原因

当 DDL 操作频繁且存在大量长时间无活动的 session 时，这些 session 会持续占用 schema 槽位，导致新的 DDL 操作无法获取足够的槽位来完成 schema 的刷新，进而引发错误 5627。尽管每次槽位满后都会立即有槽位被释放，但由于这些 session 在执行完 SQL 后 15 秒内没有新的请求，这使得它们的 schema 引用计数不能及时释放，从而再次快速达到槽位满的状态。

问题的风险及影响

schema 槽位满可能导致 DDL 操作触发的 schema 刷新失败，进而影响数据库的正常运行和维护工作。

适用版本

OceanBase 数据库所有版本。

解决方法

• 降低 DDL 操作的频率，减少 schema 版本的生成间隔。

• 增加 schema 槽位的数量或减少 schema 版本的数量。

• 避免使用长时间无活动的长 session。

规避方式

• 在设计应用时，尽量减少 DDL 操作的频率，尤其是在高并发环境下。

• 定期检查 __all_virtual_schema_slot，确保有足够的 schema 槽位支持业务需求。

• 优化应用逻辑，避免 session 长时间无活动，特别是在执行 DDL 操作前后。