By 兰春

Updated:

Contents
  1. 1. pt的详细步骤
  2. 2. 一、常用参数解读
    1. 2.1. 1.0 生产环境使用的参数
    2. 2.2. 1.1 基本用法
    3. 2.3. 1.2 安全的pt-online-schema-change
    4. 2.4. 1.3 常用参数
  3. 3. 二、使用限制
  4. 4. 三、关于触发器
  5. 5. 四、错误处理

pt的详细步骤

1
2
3
4
5
6
7
8
9
10
11
12
13
Step 1: Create the new table.
Step 2: Alter the new, empty table.  
		This should be very quick, or die if the user specified a bad alter statement.
Step 3: Create the triggers to capture changes on the original table and apply them to the new table.
Step 4: Copy rows.
Step 5: Rename tables: orig -> old, new -> orig
Step 6: Update foreign key constraints if there are child tables.
Step 7: Drop the old table.
		DROP TABLE IF EXISTS `_xx_old`
		DROP TRIGGER IF EXISTS `pt_osc_xx_xx_del`;
		DROP TRIGGER IF EXISTS `pt_osc_xx_xx_upd`;
		DROP TRIGGER IF EXISTS `pt_osc_xx_xx_ins`;
done

一、常用参数解读

1.0 生产环境使用的参数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
inception调用pt-online-schema-change，相关参数如下：
inception_osc_alter_foreign_keys_method = rebuild_constraints
inception_osc_check_alter = on
inception_osc_check_interval = 5
inception_osc_check_replication_filters = OFF
inception_osc_chunk_size = 1000
inception_osc_chunk_size_limit = 4
inception_osc_chunk_time = 1
inception_osc_critical_thread_connected = 4000
inception_osc_critical_thread_running = 300
inception_osc_drop_new_table = on
inception_osc_drop_old_table = on
inception_osc_max_lag = 3
inception_osc_max_thread_connected = 2500
inception_osc_max_thread_running = 200
inception_osc_min_table_size = 16
inception_osc_recursion_method = none
以上inception参数对应的pt-online-schema-change的命令参数如下：
pt-online-schema-change 
	--alter " xx " 
	--alter-foreign-keys-method=rebuild_constraints 
	--check-alter=yes 
	--check-interval=5 
	--check-replication-filters=no 
	--chunk-size=1000
	--chunk-size-limit=4
	--chunk-time=1
	--critical-load=thread_connected:4000,thread_running:300
	--max-load=thread_connected:2500,thread_running:200
	--drop-new-table=yes
	--drop-old-table=yes
	--max-lag=3
	--recursion-method=none

1.1 基本用法

  • pt-online-schema-change [OPTIONS] DSN
  • pt-online-schema-change —alter “ADD COLUMN c1 INT” D=sakila,t=actor
  • pt-online-schema-change —alter “ENGINE=InnoDB” D=sakila,t=actor

1.2 安全的pt-online-schema-change

默认情况下，pt-online-schema-change 是不会修改表的，除非你显示的指定了 —execute
pt-online-schema-change 有一系列动作来阻住一切不期望的后果发生，包括 自动检测复制，以及以下相关措施

  • 大部分情况下，pt-online-schema-change会拒绝给没有主键和唯一键的表做操作，可以参考 —alter 了解更多信息
  • 如果检测到复制过滤（ignore-db，do-db等），pt-online-schema-change会拒绝操作，可以参考 —[no]check-replication-filters 了解更多信息
  • 如果发现复制严重的厉害，那么会暂停copy数据，可以参考 —max-lag 了解更多的信息
  • 如果发现服务器负载非常高，那么也会暂停或者停止相关操作，可以参考 —max-load and —critical-load 了解更多信息
  • 该工具默认会设置 innodb_lock_wait_timeout=1 和 lock_wait_timeout=60来减少竞争 ， 参考 —set-vars 了解更多信息
  • 如果有外键约束，那么禁止改表，出发你指定 —alter-foreign-keys-method.
  • Percona XtraDB Cluster中禁止修改MYISAM的表

1.3 常用参数

  • —dry-run and —execute , 这两个是互斥的参数，一个是打印，一个是执行

  • —alter

通过这个选项，就不需要alter table关键字了。 你可以通过逗号来指定多个修改操作。 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
* 以下列出--alter中的一些限制，大家谨记和避免  
1. 原表必须要有主键或唯一键，因为delete触发器需要用到，否则会报错  
2. rename子句，不允许给表重命名  
2.1 不能通过删除一列，然后再新增一列的方式来完成对列的重命名操作  
3. 新增字段，如果这个字段是NOT NULL，必须要指定default值，否则报错。  你必须指定默认值  
4. 如果是DROP FOREIGN KEY constraint_name ， 那么必须指定 _ 加上 constraint_name ， 而不是 constraint_name。 
	举例： CONSTRAINT `fk_foo` FOREIGN KEY (`foo_id`) REFERENCES `bar` (`foo_id`)
	你必须指定： --alter "DROP FOREIGN KEY _fk_foo"  而不是  --alter "DROP FOREIGN KEY fk_foo".
5. 必须确保数据库高于5.0版本，因为5.0版本转换MYSIAM到InnoDB会出错
  • [no]check-alter

默认yes, 给—alter 做一些检测 

1
2
3
4
5
6
7
8
9
* 列的重命名
在之前的版本 CHANGE COLUMN name new_name 这个操作是会丢失数据的，现在的工具修复了
但是，由于pt代码并不是full-blown SQL parser，所以，你应该先 --dry-run and --print ， 确认下renamed的列名是否正确，以确保无误  
* 删除主键
删除主键是很危险的事情，尽量不要做这样的动作
  • —alter-foreign-keys-method

我们的规范不允许有外键，如果有外键，我们采取其他方式DDL 

1
2
3
4
5
6
7
8
如何把外键引用到新表?需要特殊处理带有外键约束的表,以保证它们可以应用到新表.当重命名表的时候,外键关系会带到重命名后的表上。
该工具有两种方法,可以自动找到子表,并修改约束关系。
    auto： 在rebuild_constraints和drop_swap两种处理方式中选择一个。
    rebuild_constraints：使用 ALTER TABLE语句先删除外键约束,然后再添加.如果子表很大的话,会导致长时间的阻塞。
    drop_swap： 执行FOREIGN_KEY_CHECKS=0,禁止外键约束,删除原表,再重命名新表。这种方式很快,也不会产生阻塞,但是有风险：
		    1, 在删除原表和重命名新表的短时间内,表是不存在的,程序会返回错误。
    		2, 如果重命名表出现错误,也不能回滚了.因为原表已经被删除。
	none： 类似"drop_swap"的处理方式,但是它不删除原表,并且外键关系会随着重命名转到老表上面。
  • —host=xxx —user=xxx —password=xxx
1
连接实例信息，缩写-h xxx -u xxx -p xxx，密码可以使用参数--ask-pass 手动输入。
  • D=db_name,t=table_name
1
指定要ddl的数据库名和表名
  • —charset
1
最好设置为MySQL默认字符集： utf8
  • —check-interval
1
默认1秒，检测--max-lag
  • —[no]check-replication-filters

默认yes

1
如果发现任何服务器有 binlog_ignore_db and replicate_do_db ， 那么就报错
  • —check-slave-lag
1
指定一个从库的DSN连接地址,如果从库超过--max-lag参数设置的值,就会暂停操作。
  • —[no]swap-tables 
1
默认yes。交换原始表和新表，除非你禁止--[no]drop-old-table。
  • —max-lag
1
2
3
4
5
6
默认1s。
每个chunk拷贝完成后，会查看所有复制Slave的延迟情况。
要是延迟大于该值，则暂停复制数据，直到所有从的滞后小于这个值，使用Seconds_Behind_Master。
如果有任何从滞后超过此选项的值，则该工具将睡眠--check-interval指定的时间，再检查。
如果从被停止，将会永远等待，直到从开始同步，并且延迟小于该值。
如果指定--check-slave-lag，该工具只检查该服务器的延迟，而不是所有服务器。
  • —max-load
1
2
3
4
5
6
默认为Threads_running=25。
每个chunk拷贝完后，会检查SHOW GLOBAL STATUS的内容，检查指标是否超过了指定的阈值。
如果超过，则先暂停。
这里可以用逗号分隔，指定多个条件，
每个条件格式： status指标=MAX_VALUE 或者 status指标:MAX_VALUE。
如果不指定MAX_VALUE，那么工具会设置其为当前值的120%。
  • —critical-load 
1
2
3
默认为Threads_running=50。
用法基本与--max-load类似，如果不指定MAX_VALUE，那么工具会这只其为当前值的200%。
如果超过指定值，则工具直接退出，而不是暂停。
  • —print
1
打印SQL语句到标准输出。指定此选项可以让你看到该工具所执行的语句，和--dry-run配合最佳。
  • —progress
1
复制数据的时候打印进度报告，二部分组成：第一部分是百分比，第二部分是时间。
  • —set-vars 
1
2
设置MySQL变量，多个用逗号分割。
默认该工具设置的是： wait_timeout=10000 innodb_lock_wait_timeout=1 lock_wait_timeout=60
  • —recursion-method
1
2
3
4
5
6
7
8
9
10
默认是show processlist，发现从的方法，也可以是host，但需要在从上指定report_host，通过show slave hosts来找到，可以指定none来不检查Slave。
METHOD       USES
===========  ==================
processlist  SHOW PROCESSLIST
hosts        SHOW SLAVE HOSTS
dsn=DSN      DSNs from a table
none         Do not find slaves
指定none则表示不在乎从的延迟。

—pause-file

1
可以指定文件暂停pt-online-schema-change

二、使用限制

  • 哪些ddl是不可以做的，做了容易出错 
1
2
3
4
5
6
7
1. 禁止创建唯一索引，会丢失数据，更加不允许添加 --alter-check=no，--check-unique-key-change=no  
2. 如果原表没有主键，或者也没有唯一索引，这些表是不允许用pt做DDL的  
3. 禁止对外键的表进行pt ddl
4. 禁止对表进行重命名
5. 禁止对列进行重命名，如果一定要做，也必须先print出来检测清楚列名是否正确  
6. 新增字段，NOT NULL必须要指定默认值
7. 不允许删除主键

  • 由于pt触发器原理，rowcopy会产业一堆的binlog，所以做之前要检测binlog空间是否够用，也要检测数据空间多一倍表空间是否够用

  • 禁止在业务高峰期进行pt-online-schema-change操作

  • 原表不能有触发器

  • MySQL最好设置为innodb_autoinc_lock_mode=2，否则在高并发的写入情况下，很容易产生所等待以及死锁

  • master的表结构必须跟slave的表结构一致，不允许异构，否则pt-online-schema-change的原理就是会rename，然后slave不一致的表结构会被master覆盖，谨记

三、关于触发器

  • 3.0.2之前的update触发器
1
REPLACE INTO `lc`.`_hb_new` (`id`, `ts`, `ts2`, `c1`) VALUES (NEW.`id`, NEW.`ts`, NEW.`ts2`, NEW.`c1`)
  • 3.0.2之后的update触发器
1
2
3
4
BEGIN 
	DELETE IGNORE FROM `lc`.`_hb_new` WHERE !(OLD.`id` <=> NEW.`id`) AND `lc`.`_hb_new`.`id` <=> OLD.`id`;
	REPLACE INTO `lc`.`_hb_new` (`id`, `ts`, `ts2`) VALUES (NEW.`id`, NEW.`ts`, NEW.`ts2`);
END
  • 原理
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
update触发器
    =SQL转换=> delete ignore + replace into (大于3.0.2版本)
    =SQL转换=> replace into（低于3.0.2版本，所以这个版本会有问题，如果这时候对老的主键修改，那么修改之前的值不会去掉，从而多了一些异常数据）
举例：t表中有三条数据，第一列id是主键
------
1 lc  --row1
2 lc  --row2
3 lc  --row3
------
pt-online-schema-change的原理大致四个阶段：
1. 创建临时表_t_new
2. 创建触发器
3. 老数据row copy
4. swap table
好了，我们来举个例子：
1. 创建临时表_t_new	
2. 创建触发器
3. 老数据row copy
	3.1 拷贝数据row1，row2完毕
	3.2 这时候业务有一个update语句， update t set id = 10 where id=1;
	3.3 拷贝数据row3
4. swap table
这时候脑补一下原表和新表的示意图, 这时候已经执行到3.1阶段
老表
------------
1 lc  --row1
2 lc  --row2    
3 lc  --row3
------------
新表
-----------
1 lc
2 lc
-----------
这时候脑补一下原表和新表的示意图, 这时候已经执行到3.3阶段
老表(update t set id = 10 where id=1)
------------
10 lc  --row1
2 lc  --row2
3 lc  --row3
------------
新表(3.0.2之前版本的触发器，没有delete映射，所以最终结果如下，跟老表相比已经不一致了，多了一条数据1，lc) , 触发器 replace into _t_new(id,name) values(10,lc) 
-----------
1 lc
2 lc
10 lc
3 lc
-----------
新表(3.0.2之后版本的触发器，有delete映射，所以最终结果如下，于老表的数据一致) , 触发器 delete ignore _t_new where id = 1;replace into _t_new(id,name) values(10,lc);
-----------
2 lc
10 lc
3 lc
-----------

四、错误处理

遇到错误后，继续补充完整

Contents
  1. 1. pt的详细步骤
  2. 2. 一、常用参数解读
    1. 2.1. 1.0 生产环境使用的参数
    2. 2.2. 1.1 基本用法
    3. 2.3. 1.2 安全的pt-online-schema-change
    4. 2.4. 1.3 常用参数
  3. 3. 二、使用限制
  4. 4. 三、关于触发器
  5. 5. 四、错误处理

幸福,不在于得到的多

而在于计较的少