gh-ost —— GitHub Online DDL 工具使用详解

目录

• 1.简介
• 2.为何不用触发器 ?
• 3.命名由来
• 4.亮点
• 5.使用
• 6.它是如何工做的？
• 7.工做模式
  • 7.1.模式1 —— 连上从库，在主库上修改
  • 7.2.模式2 —— 直接在主库上修改
  • 7.3.模式3 —— 在从库上修改和测试
• 8.下载
• 9.参数说明
• 10.实际操做
  • 10.1. DDL执行过程
    • 10.1.1. 单实例上DDL
    • 10.1.2. 主从上DDL
    • 10.1.3.在从上进行DDL测试
    • 10.1.4.额外说明：终止、暂停、限速
• 11.建议
• 12.更多的小贴士
• 13.更多

GitHub’s online schema migration for MySQL
项目地址：gh-ost

1.简介

• gh-ost是一个无触发器的MySQL schema在线迁移解决方案。它是可测试的，并提供了可用性、动态控制/从新配置、审计和许多操做功能。
• 在整个迁移过程当中，gh-ost在主库上产生的工做负载较轻，与迁移表上的现有工做负载解耦。
• 它是根据多年使用现有解决方案的经验设计的，并更改了表迁移的范例。

2.为何不用触发器 ?

• 已存在的工具备：
  • pt-osc
  • Facebook OSC
  • LHM
  • oak-online-alter-table
• 它们都使用触发器将表上的活动，传输更新到正在缓慢同步的鬼/影表。这些工具的工做方式不尽相同：大多数工具使用同步方法(应用于ghost表的全部更改)，而Facebook工具使用异步方法(将更改追加到更改日志表，稍后将审查并应用于ghost表)。
• 触发器的使用简化了动态表迁移中的许多流程，但也带来了一些限制或困难。如下是咱们选择为模式迁移设计无触发解决方案design a triggerless solution的缘由。

3.命名由来

• 最初它被命名为gh-osc: GitHub Online Schema Change，相似于Facebook online schema change和pt-online-schema-change。

  但后来发生了一种罕见的基因突变，c变成了t。这让咱们走上了寻找一个新的缩略词的道路。gh-ost(发音:Ghost)，表明GitHub的在线模式转换器/变形器。

4.亮点

• 经过在从库上测试gh-ost来创建您对它的信任。gh-ost将发出与主表相同的流，迁移复制表上的表，而不实际替换原始表，将复制表保留为两个表，而后您能够比较并确信该工具操做正确。这就是咱们在生产中不断测试gh-ost的方法。
• 真正的暂停：当gh-ost中止throttles时，它真正中止对master上的写：没有行复制，也没有正在进行的事件处理。经过节流，能够将主服务器返回到其原始工做负载
• 动态控制：即便迁移仍在运行，您也能够交互式interactively地从新配置gh-ost。您能够强制启动节流
• 审计：您能够查询gh-ost的状态。在unix套接字或TCP上监听gh-ost
• 切换阶段的控制：能够指示gh-ost推迟多是最关键的步骤：表的交换，直到您能够方便地使用为止。没有必要担忧ETA在办公时间以外
• 外部挂载hooks能够将gh-ost与您的特定环境结合起来

5.使用

• 详细说明都在

  cheatsheet

  。您可能对以各类模式调用gh-ost感兴趣：

  • noop迁移（仅仅测试迁移是有效的和良好的)
  • 使用从库进行的真正迁移（若是您的主库使用基于语句的复制，则须要在主库上运行；gh-ost能够识别涉及的服务器的身份。)
  • 一个真正的迁移，直接在主库上运行（可是gh-ost更喜欢前者)
  • 在从库上作真实迁移（主版本未受影响）
  • 在从库上作测试迁移，您能够经过这种方式与gh-ost的操做创建信任。

6.它是如何工做的？

• 全部现有的在线模式变动工具以相似的方式操做：他们建立一个与你原始表类似的ghost表，缓慢而逐步将数据从原始表复制到ghost表,同时不断传输增量 (任何insert、delete、update应用到你的表)到ghost表。
• 最后，在适当的时候，它们会用ghost表替换原来的表。
• gh-ost使用相同的模式。可是，它不一样于全部现有的工具，不使用触发器。咱们已经认识到触发器是许多限制和风险的根源many limitations and risks。
• 相反，gh-ost使用binlog流捕获表更改uses the binary log stream，并异步地将它们应用到ghost表。gh-ost承担了一些其余工具留给数据库执行的任务。所以，gh-ost对迁移过程有更大的控制：能够真正暂停、能够真正地将迁移的写负载与主工做负载分离。
• 此外，它还提供了许多操做上的好处operational perks，使它更安全、更值得信赖、使用起来更有趣。

gh-ost 首先链接到主库上，根据 alter 语句建立幽灵表，而后做为一个”备库“链接到其中一个真正的备库上，一边在主库上拷贝已有的数据到幽灵表，一边从备库上拉取增量数据的 binlog，而后不断的把 binlog 应用回主库。图中 cut-over 是最后一步，锁住主库的源表，等待 binlog 应用完毕，而后替换 gh-ost 表为源表。gh-ost 在执行中，会在本来的 binlog event 里面增长如下 hint 和心跳包，用来控制整个流程的进度，检测状态等。这种架构带来诸多好处，例如：

• 整个流程异步执行，对于源表的增量数据操做没有额外的开销，高峰期变动业务对性能影响小。
• 下降写压力，触发器操做都在一个事务内，gh-ost 应用 binlog 是另一个链接在作。
• 可中止，binlog 有位点记录，若是变动过程发现主库性能受影响，能够马上中止拉binlog，中止应用 binlog，稳定以后继续应用。
• 可测试，gh-ost 提供了测试功能，能够链接到一个备库上直接作 Online DDL，在备库上观察变动结果是否正确，再对主库操做，内心更有底。

7.工做模式

• gh-ost 根据参数配置可选三种变动模式
• 除了直连主库和链接从库之外,还有链接从库作变动测试

7.1.模式1 —— 连上从库，在主库上修改

• 这是 gh-ost 默认的工做模式，它会查看从库状况，找到集群的主库而且链接上去。修改操做的具体步骤是

• • 在主库上读写行数据；
  • 在从库上读取二进制日志事件，将变动应用到主库上；
  • 在从库上查看表格式、字段、主键、总行数等；
  • 在从库上读取 gh-ost 内部事件日志（好比心跳）；
  • 在主库上完成表切换；
• 若是主库的二进制日志格式是 statement，就可使用这种模式。但从库就必须配成启用二进制日志（log_bin, log_slave_updates），还要设成 Row 格式（binlog_format=ROW），实际上 gh-ost 会在从库上帮你作这些设置。

• 事实上，即便把从库改为 Row 格式，这仍然是对主库侵入最少的工做模式。

7.2.模式2 —— 直接在主库上修改

• 若是没有从库，或者不想在从库上操做，那直接用主库也是能够的。gh-ost 就会在主库上直接作全部的操做。仍然能够在上面查看主从复制延迟。

• • 主库必须产生 Row 格式的二进制日志；
  • 启动 gh-ost 时必须用 --allow-on-master 选项来开启这种模式；

7.3.模式3 —— 在从库上修改和测试

• 这种模式会在从库上作修改。gh-ost 仍然会连上主库，但全部操做都是在从库上作的，不会对主库产生任何影响。在操做过程当中，gh-ost 也会不时地暂停，以便从库的数据能够保持最新。

• • --migrate-on-replica 选项让 gh-ost 直接在从库上修改表。最终的切换过程也是在从库正常复制的状态下完成的。
  • --test-on-replica 代表操做只是为了测试目的。在进行最终的切换操做以前，复制会被中止。原始表和临时表会相互切换，再切换回来，最终至关于原始表没被动过。主从复制暂停的状态下，你能够检查和对比这两张表中的数据。

8.下载

• 下载地址：https://github.com/github/gh-ost/releases

9.参数说明

option	meaning	default value
--aliyun-rds	是否在阿里云数据库上执行	true
--allow-master-master	是否容许gh-ost运行在双主复制架构中，通常与 --assume-master-host参数一块儿使用
--allow-nullable-unique-key	容许 gh-ost 在数据迁移依赖的惟一键能够为NULL，默认为不容许为NULL的惟一键。若是数据迁移(migrate)依赖的惟一键容许NULL值，则可能形成数据不正确，请谨慎使用
--allow-on-master	容许gh-ost直接运行在主库上。不加该参数 gh-ost 默认链接的从库
--alter string	DDL语句
--approve-renamed-columns ALTER	若是你修改一个列的名字，gh-ost将会识别到而且须要提供重命名列名的缘由，默认状况下gh-ost是不继续执行的，除非提供-approve-renamed-columns ALTER
--ask-pass	MySQL密码
--assume-master-host	为gh-ost指定一个主库，格式为”ip:port”或者”hostname:port”。在这主主架构里比较有用，或则在gh-ost发现不到主的时候有用
--assume-rbr	确认gh-ost链接的数据库实例的binlog_format=ROW的状况下，能够指定-assume-rbr，这样能够禁止从库上运行stop slave,start slave,执行gh-ost用户也不须要SUPER权限
--check-flag
--chunk-size	在每次迭代中处理的行数量(容许范围：100-100000)	1000
--concurrent-rowcount	该参数若是为True，则进行row-copy以后，估算统计行数(使用explain select count(*)方式)，并调整ETA时间，不然，gh-ost首先预估统计行数，而后开始row-copy	true
--conf	gh-ost的配置文件路径
--critical-load string	一系列逗号分隔的status-name=values组成，当MySQL中status超过对应的values，gh-ost将会退出。-critical-load Threads_connected=20,Connections=1500，指的是当MySQL中的状态值Threads_connected>20,Connections>1500的时候，gh-ost将会因为该数据库严重负载而中止并退出
--critical-load-hibernate-seconds	负载达到critical-load时，gh-ost在指定的时间内进入休眠状态。 它不会读/写任何来自任何服务器的任何内容
--critical-load-interval-millis	当值为0时，当达到-critical-load，gh-ost当即退出。当值不为0时，当达到-critical-load，gh-ost会在-critical-load-interval-millis秒数后，再次进行检查，再次检查依旧达到-critical-load，gh-ost将会退出
--cut-over	选择cut-over类型:atomic/two-step，atomic(默认)类型的cut-over是github的算法，two-step采用的是facebook-OSC的算法
--cut-over-exponential-backoff
--cut-over-lock-timeout-seconds	gh-ost在cut-over阶段最大的锁等待时间，当锁超时时，gh-ost的cut-over将重试	3
--database string	数据库名
--debug	debug模式
--default-retries	各类操做在panick前重试次数	60
--discard-foreign-keys	该参数针对一个有外键的表，在gh-ost建立ghost表时，并不会为ghost表建立外键。该参数很适合用于删除外键，除此以外，请谨慎使用
--dml-batch-size	在单个事务中应用DML事件的批量大小（范围1-100）	1
--exact-rowcount	准确统计表行数(使用select count(*)的方式)，获得更准确的预估时间
--execute	实际执行alter&migrate表，默认为noop，不执行，仅仅作测试并退出，若是想要ALTER TABLE语句真正落实到数据库中去，须要明确指定-execute
--exponential-backoff-max-interval
--force-named-cut-over	若是为true，则unpostpone / cut-over交互式命令必须命名迁移的表
--force-table-names	在临时表上使用的表名前缀
--heartbeat-interval-millis	gh-ost心跳频率值	500
--hooks-hint	任意消息经过 GH_OST_HOOKS_HINT 注入到 hook
--hooks-path	hook文件存放目录(默认为empty，即禁用hook)。hook会在这个目录下寻找符合约定命名的hook文件来执行
--host	MySQL IP/hostname
--initially-drop-ghost-table	gh-ost操做以前，检查并删除已经存在的ghost表。该参数不建议使用，请手动处理原来存在的ghost表。默认该参数，gh-ost直接退出操做	不启用
--initially-drop-old-table	gh-ost操做以前，检查并删除已经存在的旧表。该参数不建议使用，请手动处理原来存在的ghost表。默认，gh-ost直接退出操做	不启用
--initially-drop-socket-file	gh-ost强制删除已经存在的socket文件。该参数不建议使用，可能会删除一个正在运行的gh-ost程序，致使DDL失败
--master-password	MySQL 主密码
--master-user	MysQL主帐号
--max-lag-millis	主从复制最大延迟时间，当主从复制延迟时间超过该值后，gh-ost将采起节流(throttle)措施	1500s
--max-load	逗号分隔状态名称=阈值，如：'Threads_running=100,Threads_connected=500'. When status exceeds threshold, app throttles writes
--migrate-on-replica	gh-ost的数据迁移(migrate)运行在从库上，而不是主库上
--nice-ratio	每次chunk时间段的休眠时间，范围[0.0…100.0]。0：每一个chunk时间段不休眠，即一个chunk接着一个chunk执行；1：每row-copy 1毫秒，则另外休眠1毫秒；0.7：每row-copy 10毫秒，则另外休眠7毫秒
--ok-to-drop-table	gh-ost操做结束后，删除旧表，默认状态是不删除旧表，会存在_tablename_del表
--panic-flag-file	当这个文件被建立，gh-ost将会当即退出
--password	MySQL密码
--port	MySQL端口，最好用从库
--postpone-cut-over-flag-file	当这个文件存在的时候，gh-ost的cut-over阶段将会被推迟，数据仍然在复制，直到该文件被删除
--quiet	静默模式
--replica-server-id	gh-ost的server_id
--replication-lag-query	弃用
--serve-socket-file	gh-ost的socket文件绝对路径
--serve-tcp-port	gh-ost使用端口，默认为关闭端口
--skip-foreign-key-checks	肯定你的表上没有外键时，设置为'true'，而且但愿跳过gh-ost验证的时间-skip-renamed-columns ALTER
--skip-renamed-columns ALTER	若是你修改一个列的名字(如change column)，gh-ost将会识别到而且须要提供重命名列名的缘由，默认状况下gh-ost是不继续执行的。该参数告诉gh-ost跳该列的数据迁移，让gh-ost把重命名列做为可有可无的列。该操做很危险，你会损失该列的全部值
--stack	添加错误堆栈追踪
--switch-to-rbr	让gh-ost自动将从库的binlog_format转换为ROW格式
--table	表名
--test-on-replica	在从库上测试gh-ost，包括在从库上数据迁移(migration)，数据迁移完成后stop slave，原表和ghost表马上交换然后马上交换回来。继续保持stop slave，使你能够对比两张表
--test-on-replica-skip-replica-stop	当-test-on-replica执行时，该参数表示该过程当中不用stop slave
--throttle-additional-flag-file	当该文件被建立后，gh-ost操做当即中止。该参数能够用在多个gh-ost同时操做的时候，建立一个文件，让全部的gh-ost操做中止，或者删除这个文件，让全部的gh-ost操做恢复
--throttle-control-replicas	列出全部须要被检查主从复制延迟的从库
--throttle-flag-file	当该文件被建立后，gh-ost操做当即中止。该参数适合控制单个gh-ost操做。-throttle-additional-flag-file string适合控制多个gh-ost操做
--throttle-http
--throttle-query string	节流查询。每秒钟执行一次。当返回值=0时不须要节流，当返回值>0时，须要执行节流操做。该查询会在数据迁移(migrated)服务器上操做，因此请确保该查询是轻量级的
--timestamp-old-table	在旧表名中使用时间戳。 这会使旧表名称具备惟一且无冲突的交叉迁移
--tungsten	告诉gh-ost你正在运行的是一个tungsten-replication拓扑结构
--user	MYSQL用户
--verbose
--version

10.实际操做

• 使用说明：条件是操做的MySQL上须要的binlog模式是ROW。若是在一个从上测试也必须是ROW模式，还要开启log_slave_updates。根据上面的参数说明按照需求进行调整
• 环境：主库：192.168.1.101；从库：192.168.1.102

10.1. DDL执行过程

• 校验阶段：
  • 检查有没有外键和触发器。
  • 检查表的主键信息。
  • 检查是否主库或从库，是否开启 log_slave_updates，以及 binlog 信息
  • 检查 gho 和 del 结尾的临时表是否存在
  • 建立 ghc 结尾的表，存数据迁移的信息，以及 binlog 信息等
• 初始化 stream 的链接，添加 binlog 的监听
• 迁移阶段：
  • 建立 gho 结尾的临时表，执行 DDL 在 gho 结尾的临时表上
  • 开启事务，按照主键id把源表数据写入到 gho 结尾的表上，再提交，以及binlog apply
• cut-over 阶段：
  • lock 源表，rename 表：rename 源表 to 源 _del 表，gho 表 to 源表
  • 清理 ghc 表

10.1.1. 单实例上DDL

• 单个实例至关于主库，须要开启--allow-on-master参数和ROW模式

gh-ost --user="root" --password="root" --host=192.168.1.101  --database="test" --table="t1" 
 --alter="ADD COLUMN cc2 varchar(10),add column cc3 int not null default 0 comment 'test' " --allow-on-master  --execute

10.1.2. 主从上DDL

• 有2个选择，一是按照1直接在主上执行同步到从上，另外一个链接到从库，在主库作迁移（只要保证从库的binlog为ROW便可，主库不须要保证）

gh-ost --user="root" --password="root" --host=192.168.1.102  --database="test" --table="t" --initially-drop-old-table
 --alter="ADD COLUMN y1 varchar(10),add column y2 int not null default 0 comment 'test' "  --execute

• 此时的操做大体是：
  • 行数据在主库上读写
  • 读取从库的二进制日志，将变动应用到主库
  • 在从库收集表格式，字段&索引，行数等信息
  • 在从库上读取内部的变动事件（如心跳事件）
  • 在主库切换表
• 在执行DDL中，从库会执行一次 stop/start slave，要是肯定从的 binlog 是 ROW 的话能够添加参数：--assume-rbr。若是从库的 binlog 不是 ROW，能够用参数 --switch-to-rbr 来转换成 ROW，此时须要注意的是执行完毕以后，binlog 模式不会被转换成原来的值。--assume-rbr 和 --switch-to-rbr 参数不能一块儿使用。

10.1.3.在从上进行DDL测试

gh-ost --user="root" --password="root" --host=192.168.1.102  --database="test" --table="t" 
 --alter="ADD COLUMN abc1 varchar(10),add column abc2 int not null default 0 comment 'test' " --test-on-replica  --switch-to-rbr --execute

• 参数--test-on-replica：在从库上测试gh-ost，包括在从库上数据迁移 (migration)，数据迁移完成后 stop slave，原表和 ghost 表马上交换然后马上交换回来。继续保持 stop slave，使你能够对比两张表。若是不想 stop slave，则能够再添加参数：--test-on-replica-skip-replica-stop
• 上面三种是 gh-ost 操做模式，上面的操做中，到最后不会清理临时表，须要手动清理，再下次执行以前果真临时表还存在，则会执行失败，能够经过参数进行删除:
  • --initially-drop-ghost-table:gh-ost操做以前，检查并删除已经存在的ghost表。该参数不建议使用，请手动处理原来存在的ghost表。默认不启用该参数，gh-ost直接退出操做。
  • --initially-drop-old-table:gh-ost操做以前，检查并删除已经存在的旧表。该参数不建议使用，请手动处理原来存在的ghost表。默认不启用该参数，gh-ost直接退出操做。
  • --initially-drop-socket-file:gh-ost强制删除已经存在的socket文件。该参数不建议使用，可能会删除一个正在运行的gh-ost程序，致使DDL失败。
  • --ok-to-drop-table:gh-ost操做结束后，删除旧表，默认状态是不删除旧表，会存在_tablename_del表。
• 还有其余的一些参数，好比：--exact-rowcount、--max-lag-millis、--max-load 等等，能够看上面的说明，具体大部分经常使用的参数命令以下：

gh-osc --user= --password= --host= --database= --table= --max-load=Threads_running=30, --chunk-size=1000 --serve-socket-file=/tmp/gh-ost.test.sock
 --exact-rowcount --allow-on-master/--test-on-replica --initially-drop-ghost-table/--initially-drop-old-table/--initially-drop-socket-file
 --max-lag-millis= --max-load='Threads_running=100,Threads_connected=500' --ok-to-drop-table

10.1.4.额外说明：终止、暂停、限速

gh-ost --user="root" --password="root" --host=192.168.1.101  --database="test" --table="t1" 
 --alter="ADD COLUMN o2 varchar(10),add column o1 int not null default 0 comment 'test' " --exact-rowcount
 --serve-socket-file=/tmp/gh-ost.t1.sock --panic-flag-file=/tmp/gh-ost.panic.t1.flag  --postpone-cut-over-flag-file=/tmp/ghost.postpone.t1.flag
 --allow-on-master  --execute

• 表示文件终止运行：--panic-flag-file
  • 建立文件终止运行，例子中建立 /tmp/gh-ost.panic.t1.flag 文件，终止正在运行的 gh-ost，临时文件清理须要手动进行
• 表示文件禁止cut-over进行，即禁止表名切换，数据复制正常进行。--postpone-cut-over-flag-file
  • 建立文件延迟cut-over进行，即推迟切换操做。例子中建立/tmp/ghost.postpone.t1.flag文件，gh-ost 会完成行复制，但并不会切换表，它会持续的将原表的数据更新操做同步到临时表中。
• 使用socket监听请求，操做者能够在命令运行后更改相应的参数。--serve-socket-file，--serve-tcp-port（默认关闭）
• 建立socket文件进行监听，经过接口进行参数调整，当执行操做的过程当中发现负载、延迟上升了，不得不终止操做，从新配置参数，如 chunk-size，而后从新执行操做命令，能够经过scoket接口进行动态调整。如：

10.1.4.1.暂停操做：

#暂停
echo throttle | socat - /tmp/gh-ost.test.t1.sock
#恢复
echo no-throttle | socat - /tmp/gh-ost.test.t1.sock

10.1.4.2.修改限速参数：

echo chunk-size=100 | socat - /tmp/gh-ost.t1.sock
echo max-lag-millis=200 | socat - /tmp/gh-ost.t1.sock
echo max-load=Thread_running=3 | socat - /tmp/gh-ost.t1.sock

11.建议

• Testing above all，尝试 --test-on-replica前几回。更好的是，让它继续运行。咱们有多个从库，在这些从库中，咱们迭代全部的生产表，逐个迁移它们，检查和结果，验证迁移是好的。
• 对于每一个主库迁移，首先发出一个noop
• 而后经过——问题的执行

12.更多的小贴士

• 使用 --exact-rowcount获取精确的提示
• 使用 --postpone-cut-over-flag-file控制切换时机
• 熟悉交互式命令interactive commands

13.更多

• requirements and limitations
• common questions
• what if?
• the fine print
• Community questions
• Using gh-ost on AWS RDS