ghcr.io/teableio/teable-db-migrate:latest

teable-db-migrate 是 Teable 项目生态中的数据库迁移工具，专为管理 Teable 平台的数据库结构变更设计，采用容器化封装，便于在不同环境中快速部署和使用。

作为 Teable 数据层迭代的核心支撑工具，它的主要功能是统一管理数据库结构的版本化变更。无论是开发过程中的表结构调整、字段增减、索引优化，还是生产环境的 schema 升级，都能通过预定义的迁移脚本实现自动化执行。工具会记录每一次变更的详细历史，包括变更时间、操作人、具体 SQL 脚本内容，形成可追溯的版本链，避免手动修改数据库带来的混乱。

具体来说，它支持两种核心操作：正向迁移和回滚。开发团队在迭代功能时，只需按规范编写增量迁移脚本（如新增表、修改字段类型），工具会按版本顺序自动执行；若变更出现问题，也可通过回滚脚本快速恢复到上一稳定版本，降低风险。同时，它兼容 MySQL、PostgreSQL 等主流关系型数据库，能适配 Teable 从开发、测试到生产的全流程部署场景，确保不同环境下数据库结构的一致性。

在协作与安全性上，teable-db-migrate 支持集成 CI/CD 流程，可在代码合并前自动检测迁移脚本的语法正确性和潜在冲突，避免不规范脚本进入生产环境。工具还会对迁移过程中的数据一致性做基础校验，比如检查外键约束、索引有效性等，减少因结构变更导致的数据异常。

对于 Teable 开发团队而言，这个工具解决了多人间协作修改数据库时的版本同步问题，省去了手动执行 SQL 脚本的繁琐步骤，同时通过自动化和可追溯性，大幅降低了人为操作失误的概率，为 Teable 平台数据层的稳定迭代提供了可靠保障。