Shift UI使用教程：轻松创建、跟踪和管理数据库迁移请求

Shift UI使用教程：轻松创建、跟踪和管理数据库迁移请求

【免费下载链接】shiftshift is an application that helps you run schema migrations on MySQL databases项目地址: https://gitcode.com/gh_mirrors/sh/shift

Shift是一款专为MySQL数据库设计的schema迁移管理工具，通过直观的Web界面帮助团队轻松处理数据库结构变更。本文将详细介绍如何使用Shift UI创建迁移请求、跟踪进度并高效管理整个迁移流程，让数据库变更不再成为开发瓶颈。

🚀 准备工作：安装与访问Shift UI

在开始使用Shift UI之前，请确保已完成Shift应用的部署。你可以通过以下命令克隆官方仓库并按照安装指南进行部署：

git clone https://gitcode.com/gh_mirrors/sh/shift

部署完成后，通过浏览器访问Shift UI的地址（通常是服务器IP加端口号），即可进入登录界面。登录后将看到Shift的主控制台，这里集中展示了所有迁移请求的状态和进度。

🔍 认识Shift UI主界面

Shift UI的主界面设计简洁直观，主要分为导航栏和内容区两部分：

图：Shift UI主界面展示了进行中的迁移和待处理迁移请求，可直观查看迁移状态和进度

• 导航栏：包含"ALL REQUESTS"（所有请求）、"META REQUESTS"（元请求）、"CREATE REQUEST"（创建请求）和"ADMIN"（管理）四个主要选项
• 内容区：默认显示"Migrations In Progress"（进行中的迁移）和"Pending Migrations"（待处理迁移）两个列表，包含迁移ID、开始时间、集群名称、请求者、DDL语句、状态等关键信息

✨ 创建数据库迁移请求的完整步骤

1. 发起新迁移请求

点击导航栏中的"CREATE REQUEST"按钮，进入迁移请求创建页面。在这里需要填写以下关键信息：

• 集群名称：选择目标数据库集群
• DDL语句：输入要执行的数据库结构变更语句（如ALTER TABLE、CREATE TABLE等）
• 请求说明：简要描述迁移目的和影响范围（选填）

填写完成后点击"提交"按钮，系统将自动进入"preparing migration"状态，开始收集表统计信息（如行数、表大小等）。

2. 跟踪迁移进度

提交迁移请求后，可在主界面的"Migrations In Progress"列表中查看实时进度。每个迁移请求会显示"copy percentage"（复制百分比），直观反映数据复制的完成情况。

3. 理解迁移生命周期

Shift的迁移流程遵循标准化的生命周期管理，确保每个变更都经过安全验证和授权：

图：Shift迁移流程包含准备、等待审批、等待开始、执行中、等待重命名、完成等状态，清晰展示迁移的完整生命周期

主要状态说明：

• preparing migration：系统正在收集表统计信息
• awaiting approval：等待管理员审批
• awaiting start：已批准，等待管理员启动
• running migration：迁移执行中，显示复制进度
• awaiting rename：数据复制完成，等待管理员切换表名
• completed：迁移成功完成

📊 高效管理迁移请求

使用筛选功能快速定位

主界面右上角的"show filters"按钮可展开筛选面板，支持按集群、请求者、状态等条件筛选迁移请求，帮助你在大量请求中快速找到目标。

查看迁移详情

点击任意迁移请求的ID或行项目，可进入详情页面查看完整信息，包括：

• 详细的DDL语句
• 迁移各阶段的时间戳
• 相关评论和审批记录
• 错误日志（如迁移失败）

处理异常情况

当迁移出现"error"或"failed"状态时，可在详情页面查看具体错误信息。对于可恢复的错误，可选择"retry"从上次中断处继续迁移；若无法恢复，可选择"cancel"终止迁移并清理资源。

📚 进阶资源

• 官方文档：docs/Installation-Guide.md
• 常见问题解答：docs/Frequently-Asked-Questions.md
• 配置文件位置：ui/config/database.yml

通过Shift UI，团队可以实现数据库迁移的可视化管理，减少人工操作错误，提高变更效率。无论是简单的字段添加还是复杂的表结构调整，Shift都能提供安全可靠的迁移支持，让数据库变更管理变得简单而高效！

【免费下载链接】shiftshift is an application that helps you run schema migrations on MySQL databases项目地址: https://gitcode.com/gh_mirrors/sh/shift