深入解析gh-ost工具的命令行参数配置

深入解析gh-ost工具的命令行参数配置

gh-ost GitHub's Online Schema-migration Tool for MySQL 项目地址: https://gitcode.com/gh_mirrors/gh/gh-ost

前言

gh-ost作为一款优秀的在线表结构变更工具，其强大的功能很大程度上依赖于丰富的命令行参数配置。本文将全面解析gh-ost的核心参数，帮助数据库管理员根据实际场景灵活配置，确保在线DDL操作的安全性和效率。

基础连接参数

数据库连接配置

gh-ost支持多种方式连接数据库：

• --conf：指定包含数据库连接信息的配置文件路径，格式为标准MySQL客户端配置
• --ssl：启用SSL/TLS加密连接
• --ssl-ca/--ssl-cert/--ssl-key：自定义SSL证书配置
• --ssl-allow-insecure：允许不验证服务器证书的加密连接

字符集配置

--charset参数支持指定数据库连接字符集，默认支持utf8mb4、utf8和latin1等多种字符集及对应的排序规则。

执行模式控制

执行环境标识

针对不同云环境，gh-ost提供了专门的标识参数：

• --aliyun-rds：阿里云RDS环境
• --azure：Azure MySQL数据库环境
• --gcp：Google Cloud Platform第一代环境

执行策略控制

• --execute：实际执行迁移操作（默认仅为模拟测试）
• --allow-on-master：允许直接在主库执行（默认要求连接从库）
• --migrate-on-replica：完全在从库执行迁移
• --test-on-replica：在从库测试迁移而不影响主库

表结构处理参数

列处理相关

• --allow-zero-in-date：允许包含零值的日期类型
• --approve-renamed-columns：确认列重命名操作
• --skip-renamed-columns：忽略列重命名关联

外键处理

• --discard-foreign-keys：静默丢弃外键（危险操作）
• --skip-foreign-key-checks：跳过外键检查

存储引擎支持

--storage-engine参数支持InnoDB（默认）和RocksDB（实验性）两种存储引擎。需要注意的是RocksDB目前不支持外键、生成列等特性。

性能与安全控制

负载监控

• --max-load：定义触发节流的负载阈值
• --critical-load：定义必须退出的临界负载
• --critical-load-hibernate-seconds：临界负载时休眠而非退出
• --critical-load-interval-millis：临界负载二次检查间隔

复制延迟控制

• --max-lag-millis：允许的最大复制延迟（毫秒）
• --throttle-control-replicas：指定需要监控延迟的从库列表
• --heartbeat-interval-millis：心跳间隔（默认100ms）

批处理优化

--dml-batch-size控制二进制日志事件批量写入大小（1-100），默认10，可在吞吐量和事务大小间取得平衡。

高级功能参数

精确行数统计

• --exact-rowcount：执行精确的COUNT(*)统计
• --concurrent-rowcount：并行执行行数统计（默认启用）

即时DDL支持

--attempt-instant-ddl尝试使用MySQL 8.0的即时DDL功能，失败后自动回退到传统方式。

交互控制

• --postpone-cut-over-flag-file：通过文件存在延迟切换
• --force-named-cut-over：要求命名切换的表
• --force-named-panic：要求命名panic的表

总结

gh-ost提供了丰富的命令行参数，覆盖了从基础连接到高级控制的各个方面。合理配置这些参数可以：

1. 适应不同的数据库环境和拓扑结构
2. 精细控制迁移过程中的资源使用
3. 确保数据一致性和业务连续性
4. 提供灵活的交互控制能力

建议在实际生产环境使用前，充分测试各项参数的组合效果，特别是负载控制和节流相关参数，以确保迁移过程平稳可靠。

gh-ost GitHub's Online Schema-migration Tool for MySQL 项目地址: https://gitcode.com/gh_mirrors/gh/gh-ost