LHM实战：10个真实场景下的MySQL模式迁移案例

LHM实战：10个真实场景下的MySQL模式迁移案例

【免费下载链接】lhmOnline MySQL schema migrations项目地址: https://gitcode.com/gh_mirrors/lh/lhm

LHM（Large Hadron Migrator）是一款强大的MySQL在线模式迁移工具，能够帮助开发者在不中断服务的情况下安全地进行数据库结构变更。本文将通过10个真实场景案例，详细介绍如何使用LHM解决各种MySQL模式迁移难题，让你轻松掌握这一必备技能。

1. 为高流量表添加新列

场景：电商平台用户表需新增"会员等级"字段，该表日均访问量超100万次。

解决方案：使用LHM的add_column方法，通过后台复制表和增量同步实现无锁迁移：

Lhm.change_table :users do |m| m.add_column :member_level, "INT(2) NOT NULL DEFAULT 0" end

LHM会自动创建临时表、复制数据、同步增量变更，并在最后一刻切换表名，整个过程对应用透明。相关实现可参考lib/lhm/migrator.rb中的add_column方法定义。

2. 安全修改大表字段类型

场景：订单表的"金额"字段从VARCHAR改为DECIMAL，表数据量达500万行。

解决方案：使用change_column方法进行字段类型转换，LHM会处理数据类型转换的所有细节：

Lhm.change_table :orders do |m| m.change_column :amount, "DECIMAL(10,2) NOT NULL DEFAULT 0.00" end

此操作会自动处理数据验证和转换，确保业务连续性。代码实现可查看lib/lhm/migrator.rb的change_column函数。

3. 添加复合索引优化查询性能

场景：商品表需要基于"分类+上架时间"创建复合索引，提升筛选商品的查询速度。

解决方案：使用add_index方法创建复合索引，支持多列和自定义索引名：

Lhm.change_table :products do |m| m.add_index [:category_id, :created_at], :name => :idx_products_category_created end

LHM支持各种索引类型，包括前缀索引和自定义命名。相关测试案例可参考spec/unit/migrator_spec.rb中的复合索引测试。

4. 处理含有默认值的字段添加

场景：用户表需添加"注册渠道"字段，并设置默认值为"website"。

解决方案：在add_column中直接指定默认值，LHM会确保历史数据和新数据都正确应用默认值：

Lhm.change_table :users do |m| m.add_column :signup_channel, "VARCHAR(20) NOT NULL DEFAULT 'website'" end

这种方式避免了传统ALTER TABLE的长时间锁表，实现零停机变更。示例代码可见README.md中的带默认值列添加。

5. 大表拆分场景下的数据迁移

场景：将原有用户表按地区拆分为多个子表，同时保持应用兼容性。

解决方案：结合LHM的数据复制能力和应用层路由，实现平滑拆分：

# 创建新表 Lhm.change_table :users_shanghai do |m| # 复制原表结构 end # 同步历史数据 Lhm::Chunker.new(source_table, destination_table).run # 切换应用路由

LHM的分块复制功能可避免长时间锁表，具体实现可查看lib/lhm/chunker.rb的分块逻辑。

6. 处理含有外键约束的表变更

场景：订单表需添加外键关联到新的配送地址表，确保数据完整性。

解决方案：先创建新表和外键，再通过LHM迁移数据：

# 创建配送地址表 ActiveRecord::Migration.create_table :shipping_addresses do |t| # 字段定义 end # 使用LHM添加外键关联 Lhm.change_table :orders do |m| m.add_column :shipping_address_id, "INT(11) NOT NULL" # LHM本身不直接处理外键，需在数据迁移后手动添加 end # 数据迁移完成后添加外键 ActiveRecord::Migration.add_foreign_key :orders, :shipping_addresses

虽然LHM不直接处理外键，但可与常规迁移配合使用，实现安全变更。

7. 为频繁更新表添加索引

场景：支付记录表需添加索引，但该表每秒钟有数十次写入操作。

解决方案：使用LHM的低影响索引添加功能，减少对写入性能的影响：

Lhm.change_table :payments do |m| m.add_index :transaction_id end

LHM通过后台表复制方式添加索引，避免了ADD INDEX的写锁问题。相关实现可参考lib/lhm/migrator.rb的add_index方法。

8. 处理字段长度调整需求

场景：用户表的"用户名"字段从VARCHAR(20)扩展到VARCHAR(50)，支持更长的用户名。

解决方案：使用change_column方法安全调整字段长度：

Lhm.change_table :users do |m| m.change_column :username, "VARCHAR(50) NOT NULL" end

此操作在LHM内部会被优化为高效的元数据变更，而非全表扫描。测试案例可参考spec/integration/lhm_spec.rb的字段变更测试。

9. 多字段同时变更优化

场景：商品表需要同时添加"折扣价"字段和"库存状态"字段。

解决方案：在单个LHM迁移中组合多个变更操作，减少迁移次数：

Lhm.change_table :products do |m| m.add_column :discount_price, "DECIMAL(10,2)" m.add_column :stock_status, "VARCHAR(10) NOT NULL DEFAULT 'in_stock'" m.add_index :stock_status end

LHM支持在一次迁移中执行多个变更，有效减少操作次数和风险。示例可见spec/unit/migrator_spec.rb中的多列添加测试。

10. 处理历史数据清洗的迁移

场景：清理用户表中多年前的无效数据，同时添加新的状态字段。

解决方案：结合LHM和数据过滤，实现边迁移边清洗：

Lhm.change_table :users do |m| m.add_column :account_status, "VARCHAR(20) NOT NULL DEFAULT 'active'" # 通过where条件过滤需要保留的数据 m.where("created_at > '2020-01-01'") end

LHM支持通过where子句筛选需要迁移的数据，实现数据清洗和结构变更的一举两得。具体实现可参考lib/lhm/migration.rb中的条件处理逻辑。

LHM迁移的最佳实践总结

1. 小步快跑：将大型迁移拆分为多个小步骤，降低风险
2. 非高峰执行：选择业务低峰期进行迁移操作
3. 充分测试：在 staging 环境充分测试迁移方案，参考spec/integration/中的测试用例
4. 监控性能：迁移过程中监控数据库性能指标
5. 准备回滚：制定完善的回滚方案，防患于未然

通过这10个真实场景案例，我们可以看到LHM作为一款专业的MySQL在线迁移工具，能够应对各种复杂的模式变更需求。无论是添加字段、修改类型还是创建索引，LHM都能确保迁移过程安全、高效，最大限度减少对业务的影响。

要开始使用LHM，只需将其添加到你的Ruby项目中，然后参考本文案例和README.md中的详细说明，即可轻松实现MySQL的零停机模式迁移。

【免费下载链接】lhmOnline MySQL schema migrations项目地址: https://gitcode.com/gh_mirrors/lh/lhm