pt-osc 文档使用说明

拼搏现实的明天。 2022-05-28 00:40 358阅读 0赞

# 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