affaan-m/database-migrations

针对 PostgreSQL、MySQL 及常见 ORM（Prisma、Drizzle、Django、TypeORM、golang-migrate）的架构变更、数据迁移、回滚与零停机部署的数据库迁移最佳实践。

编程协作开发 Agent Agent 技能调研数据库迁移管理零停机发布多 ORM 迁移工具模式变更回滚生产环境部署

技术栈: cursor24万+许可证: MIT开发者: affaan-m

Skill 介绍Skill 文件

重要提示：本站仅作 Skill 资源导航与收录，正文以 GitHub 原仓库为准，版权归原项目所有。

在 GitHub 查看 ↗

原文译文

以下为摘要预览，完整内容请查看 GitHub 原文。

数据库迁移模式

面向生产环境的安全、可回滚的数据库架构变更。

何时启用

创建或修改数据库表时
添加或删除列或索引时
运行数据迁移时（回填、转换）
规划零停机架构变更时
为新项目搭建迁移工具时

核心原则

每次变更都是一次 migration —— 永远不要手动变更生产数据库
生产环境的 migration 仅向前 —— 回滚通过新的向前 migration 完成
架构迁移与数据迁移分离 —— 永远不要在同一次 migration 中混合 DDL 与 DML
针对生产规模的数据测试 migration —— 在 100 行上可用的 migration 可能在 1000 万行上锁死
在生产中运行过的 migration 是不可变的 —— 永远不要编辑已在生产中运行过的 migration

迁移安全检查清单

在应用任何 migration 之前：

Migration 包含 UP 和 DOWN（或明确标记为不可回滚）
大表上没有全表锁（使用并发操作）
新列带有默认值或可为 null（绝不添加没有默认值的 NOT NULL）
索引以并发方式创建（对现有表不要与 CREATE TABLE 内联）
数据回填是与架构变更分离的独立 migration
已针对生产数据副本进行测试
已记录回滚计划

PostgreSQL 模式

安全添加列

-- 正确：可空列，无锁
ALTER TABLE users ADD COLUMN avatar_url TEXT;

-- 正确：带默认值的列（Postgres 11+ 即时生效，无需重写）
ALTER TABLE users ADD COLUMN is_active BOOLEAN NOT NULL DEFAULT true;

-- 错误：在现有表上添加没有默认值的 NOT NULL（需要完全重写）
ALTER TABLE users ADD COLUMN role TEXT NOT NULL;
-- 这会锁表并重写每一行

不停机添加索引

-- 错误：在大表上阻塞写入
CREATE INDEX idx_users_email ON users (email);

-- 正确：不阻塞，允许并发写入
CREATE INDEX CONCURRENTLY idx_users_email ON users (email);

-- 注意：CONCURRENTLY 无法在事务块内运行
-- 大多数 migration 工具需要为此进行特殊处理

重命名列（零停机…

重要提示：源文件不在本站托管，请通过 GitHub 查看与下载。

索引更新于 8/25/2026, 9:18:05 PMGitHub ↗

SKILL.md9.7 KB在 GitHub 查看 ↗

相关资源

按类型、任务、场景与标签加权推荐

itsPremkumar/mcptest

MCP · Model · Context · Protocol · 测试工具 · 调试 · 开发框架

Automated MCP Server Testing Framework

yair4Data/mcp-security-analyzer

MCP · 安全审计 · 配置扫描 · 权限分析 · 开发工具

Comprehensive security testing framework for Model Context Protocol (MCP) server

Web Search Agents by Nimble

web · search · real-time · data · AI · agent · scraping · structured

网络搜索代理是针对您特定领域（例如公司信息丰富、法规研究等）的专业网络爬虫和研究代理。它们会自主学习您的使用场景，深入挖掘对您最重要的资源，从而为您的 AI 提供更深入、更相关的网络上下文

Demovanta

AI · Agent · 演示平台 · 评测 · 开发工具

。只需粘贴URL，一个真实浏览器就会打开你的网页，模拟浏览操作，并用你的母语旁白讲解屏幕上的内容

Krevios

AI代理 · 企业自动化 · 研究 · 工作流

你可以生成与编辑图像、制作视频、合成文本与排版——全程只需以可视化方式连接节点，无需编写代码

AIplayworld.io

AI代理 · 虚拟世界 · 基准测试 · 游戏环境 · LLM评测

An immersive AI adventure platform（沉浸式 AI 冒险平台）