pt-osc 文档使用说明

pt-osc 文档使用说明
- 功能介绍：
- 工作原理:
- 用法介绍
- 举例

功能介绍：

在 alter 操作更改表结构的时候不⽤锁表，也就是说执⾏ alter 的时候不会阻塞
读写的操作

工作原理:

创建一个你要执alter操作的表⼀样的空表结构，执行表结构的修改，然后从
原表中 COPY 原始数据到表结构修改后的表，当数据 copy 完成以后就会将原表移
走，用新表代替原表，默认动作是将原表删除。在 copy 数据的过程中，任何在原
表的更新操作都会更新到新表，因为这个⼯具会在原表上创建触发器，触发器会将
元彪上更新的内容更新到新表中。如果表中已经定义了触发器这个⼯具不能工作了。

用法介绍

pt-online-schema-change [OPTIONS] DSN  主要介绍常⽤参
数必带参数，其他参数可自动options 可以自行查看help
1、 DNS：为你要操作的数据库和表
2、 –dry-run：这个参数不建⽴触发器，不拷贝数据，也不会替换原表，只是创建和
更改新表。
3、 –execute：会创建筹触发器，来保证最新的变更数据会影响到新表。注意：如
果不加这个参数，这个⼯具在执⾏会再制造一些检查后退出。这一举措是为了充分
分析这个工具原理。
4、 –max-log：默认为 1s 每个 chunks 拷⻉完成后，会查看 check-slave-log 参
数所指定的从库的延迟信息，如果超过了 max-log 的阀值则暂停复制数据，直到复制延迟⼩于 max-log 的阀值。检查复制延迟信息依赖于 show slave status 返回中
的 seconds_behind_master 列的值
5、 check-interval：当出现复制延迟暂停复制数据后，按照 check-interval 指定时间周期来检查复
制延迟，直至延迟时间低于 max-log 阀值然后进⾏拷⻉数据。
6、 –check_size：用于每次控制每次拷呗数据的大小，默认 1000
7、 –chunk_time：默认 0.5 动态调整块的⼤⼩以便每个数据副本花费很长时间执
行。该工作跟踪复制速度，并在每个数据副本查询之后调整块的大小，所以是由于
服务的负载情况来进⾏动态调整。 [将此参数设置为 0，或者指定 chunk-size，都可
以禁止动态调整]
8、 chunk_size_limit:默认值 4.0；当需要复制的块大于设置的 chunk_size 大小，就不复制
9、 –critical-load： default thread_runing = 50
该参数在 copy 每个块后检查 show global status,如果负载过⾼则终⽌，如果
不给出，则⼯具检查启动当前值来确定阀值。
10、 –max-load： default threads_running=25
该参数用于拷贝数据每个数据块的时候进⾏检查 show global status,如果任何
状态变量高于阀值会暂停，如果不设置，该⼯具会在检测到的当前值上再加 20%来
确定阀值(方式 Threads_connected:100 或者 Thread_connected:110)该选项
主要目的是为了防⽌给服务器添加太多的负载，导致锁等待以及其他干扰⾏为。
12、 –[no]drop-new-table
13、 –[no]drop-old-table
默认为 YES，如果复制失败后，删除新表。注意：执⾏该参数需指定—
nodrop-new-table 复制的新表很⼤，新的数据都会缓存在 buffer pool 内。
Mysql 在删除表的过程中 innodb 会将⽂件在 buffer pool 中对应的⻚⾯清
楚。如果这设置 buffer pool 的值过大的话，或者 buffer pool 里面有很
多需要被 flush 的页面，那么此时要遍历扫描页面就会占用笔较大的时间，
导致其他事物在⽤到 buffer pool 实例时就会阻塞，从⽽影响到整个数据

举例

pt-online-schema-change
–execute
–no-version-check
–charset=utf8
–user=admin
–nodrop-old-table
–nodrop-new-table
–max-load Threads_running=50 –critical-load Threads_running=100#
把限制增⼤⼀倍。需要根据机器负载情况来调整
–alter “add column foo int(11) default null” D=test,t=t1,h=127.0.0.1
注意：以下参数是⽤于复制延迟的参数，具体解释参考⽂档，需要适当调整。
check_interval
chunk_size
chunk_size_limit
chunk_time