数据库监控与调优【十八】—— Percona Toolkit调优神器安装与使用

Percona Toolkit调优神器安装与使用

Percona Toolkit安装

本文基于Percona Toolkit 3.2.0，理论支持所有版本。

Percona Toolkit是一款MySQL世界里面非常实用的工具套件，如何安装它。

Windows系统

不支持。详见https://forums.percona.com/discussion/52503/percona-toolkit-for-windows

Linux系统

支持的操作系统主要有：

• Debian 7 (“wheezy”)
• Debian 8 (“jessie”)
• Ubuntu 14.04 LTS (Trusty Tahr)
• Ubuntu 16.04 LTS (Xenial Xerus)
• Ubuntu 16.10 (Yakkety Yak)
• Ubuntu 17.04 (Zesty Zapus)
• Red Hat Enterprise Linux or CentOS 6 (Santiago)
• Red Hat Enterprise Linux or CentOS 7 (Maipo)

• 可参考 https://blog.csdn.net/zyx_ly/article/details/88958352 的说明查看自己用的是哪个Linux发行版。

• 官方宣称，理论上Percona Toolkit也能支持其他使用基于Deb或RPM的Linux操作系统，但只有上面这些系统经过了测试。详见 https://www.percona.com/doc/percona-toolkit/LATEST/installation.html

一、安装percona-release仓库

这一步主要是配置Percona的仓库，配置好之后，Percona的相关库都可以从该仓库里下载。

可以通过以下命令查看Linux发行版

cat /etc/issue

基于Deb的Linux操作系统

例如：Debain、Ubuntu等

• 【可选】配置国内源，提升安装速度。这里使用中科大的源，也可使用其他源。

# 备份源配置文件
mv /etc/apt/sources.list /etc/apt/sources.list.bak

# 使用中科大源
echo 'deb http://mirrors.ustc.edu.cn/debian/ buster main
deb-src http://mirrors.ustc.edu.cn/debian/ buster main

deb http://mirrors.ustc.edu.cn/debian-security buster/updates main
deb-src http://mirrors.ustc.edu.cn/debian-security buster/updates main

deb http://mirrors.ustc.edu.cn/debian/ buster-updates main
deb-src http://mirrors.ustc.edu.cn/debian/ buster-updates main' > /etc/apt/sources.list

# 更新
apt-get update

• 下载安装包

wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb

• 安装

sudo dpkg -i percona-release_latest.generic_all.deb

• 执行完如上命令后，即可在文件 /etc/apt/sources.list.d/percona-release.list 中找到Percona Toolkit仓库设置。

基于RPM的Linux操作系统

例如：Red Hat Enterprise Linux、CentOS等

• 【可选】配置国内源，提升安装速度。参考 https://www.cnblogs.com/hester/p/12365068.html
• 执行如下命令即可安装percona-release仓库

sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm

二、安装Percona Toolkit

基于Deb的Linux操作系统

sudo apt-get install percona-toolkit

基于RPM的Linux操作系统

sudo yum install percona-toolkit

macOS系统

brew install percona-toolkit

Percona Toolkit使用1-pt-query-digest

pt-query-digest

官方文档：pt-query-digest

• 作用

分析日志（包括binlog、General log、slowlog）、processlist以及tcpdump中的查询，从而，帮助我们做SQL优化。就目前来说，很多企业用它来分析慢查询日志

• 语法

pt-query-digest [OPTIONS] [FILES] [DSN]

• 常用OPTIONS

--create-review-table			当使用--review参数把分析结果输出到表中时，如果没有表就自动创建
--create-history-table		当使用--history参数把分析结果输出到表中时，如果没有表就自动创建
--filter									输出符合条件的内容
--limit    								限制输出的百分比或数量。可指定百分比或数字，例如90%表示按响应时间从小到大排序，输出90%的结果；20表示输出最慢的20条
--host  									指定MySQL地址，也可用-h指定
--port										指定MySQL端口
--user  									指定MySQL用户名，也可用-u指定
--password  							指定MySQL密码，也可用-p指定
--history 								将分析结果保存到表中，分析结果比较详细，下次再使用--history时，如果存在相同的语句，且查询所在的时间区间和历史表中的不同，可通过查询同一CHECKSUM来比较某类型查询的历史变化
--review 									将分析结果保存到表中，从而方便未来review。这个分析只是对查询条件进行参数化，一个类型的查询一条记录，比较简单。当下次使用--review时，如果存在相同的语句分析，就不会记录到数据表中
--output 									指定将结果输出输出到哪里，值可以是report(标准分析报告)、slowlog(Mysql slow log)、json、json-anon，一般使用report，以便于阅读
--since 									指定分析的起始时间，值为字符串，可以是指定的某个”yyyy-mm-dd [hh:mm:ss]”格式的时间点，也可以是简单的一个时间值：s(秒)、h(小时)、m(分钟)、d(天)，如12h就表示从12小时前开始统计
--until 									指定分析的截止时间，配合--since可以分析一段时间内的慢查询

• 常用DSN

  A    指定字符集
  D    指定连接的数据库
  P    连接数据库端口
  S    连接Socket file
  h    连接数据库主机名
  p    连接数据库的密码
  t    使用--review或--history时把数据存储到哪张表里
  u    连接数据库用户名

DSN使用key=value的形式配置；多个DSN使用,分隔

• 使用示例

# 展示slow.log中最慢的查询的报表
pt-query-digest slow.log

# 分析最近12小时内的查询
pt-query-digest --since=12h slow.log

# 分析指定范围内的查询
pt-query-digest slow.log --since '2020-06-20 00:00:00' --until '2020-06-25 00:00:00'

# 把slow.log中查询保存到query_history表
pt-query-digest --user=root --password=root123 --review h=localhost,D=test,t=query_history --create-review-table slow.log

# 连上localhost，并读取processlist，输出到slowlog
pt-query-digest --processlist h=localhost --user=root --password=root123 --interval=0.01 --output slowlog

# 利用tcpdump获取MySQL协议数据，然后产生最慢查询的报表
# tcpdump使用说明：https://blog.csdn.net/chinaltx/article/details/87469933
tcpdump -s 65535 -x -nn -q -tttt -i any -c 1000 port 3306 > mysql.tcp.txt
pt-query-digest --type tcpdump mysql.tcp.txt

# 分析binlog
mysqlbinlog mysql-bin.000093 > mysql-bin000093.sql
pt-query-digest  --type=binlog mysql-bin000093.sql

# 分析general log
pt-query-digest  --type=genlog  localhost.log

• 结果可视化：

在Percona官方 https://www.percona.com/blog/2012/08/31/visualization-tools-for-pt-query-digest-tables/ 有介绍两款工具：

• Query Digest UI
• Box Anemometer
• 但两款工具都已N多年不维护了，如果感兴趣也可以搭建玩一玩，个人不建议用于生产。此外，Box Anemometer安装教程可参考https://www.cnblogs.com/lixigang/articles/5011055.html

具体操作

查看慢SQL设置

## 开启慢SQL日志
set global slow_query_log = 'ON';
set global log_output = 'FILE,TABLE';
set global long_query_time = 0.001;

## 查询慢SQL日志是否开启，以及慢SQL日志文件存放位置
SHOW VARIABLES LIKE '%slow%'; 
-- slow_query_log	ON
-- slow_query_log_file	/var/lib/mysql/es23-slow.log
SHOW VARIABLES LIKE 'log_output';
-- log_output	FILE,TABLE

使用pt-query-digest分析

## 进入文件目录
cd /var/lib/mysql/
## 使用pt-query-digest
pt-query-digest es23-slow.log

生成了以下的报表

*******************************************************************
 Using the default of SSL_verify_mode of SSL_VERIFY_NONE for client
 is deprecated! Please set SSL_verify_mode to SSL_VERIFY_PEER
 possibly with SSL_ca_file|SSL_ca_path for verification.
 If you really don't want to verify the certificate and keep the
 connection open to Man-In-The-Middle attacks please set
 SSL_verify_mode explicitly to SSL_VERIFY_NONE in your application.
*******************************************************************
  at /usr/bin/pt-query-digest line 12058.
*******************************************************************
 Using the default of SSL_verify_mode of SSL_VERIFY_NONE for client
 is deprecated! Please set SSL_verify_mode to SSL_VERIFY_PEER
 possibly with SSL_ca_file|SSL_ca_path for verification.
 If you really don't want to verify the certificate and keep the
 connection open to Man-In-The-Middle attacks please set
 SSL_verify_mode explicitly to SSL_VERIFY_NONE in your application.
*******************************************************************
  at /usr/bin/pt-query-digest line 12058.

# A software update is available:

-- 报表该有的信息
# 110ms user time, 30ms system time, 29.68M rss, 243.06M vsz
-- 分析时间
# Current date: Thu Jun  1 19:08:31 2023
-- 分析机器
# Hostname: es23
-- 分析文件
# Files: es23-slow.log
-- 分析总SQL，唯一的SQL条数
# Overall: 145 total, 40 unique, 0.00 QPS, 0.00x concurrency _____________
# Time range: 2023-03-26T22:08:18 to 2023-04-07T17:49:49
# Attribute          total     min     max     avg     95%  stddev  median
# ============     ======= ======= ======= ======= ======= ======= =======
-- 执行时间 
# Exec time             6s   336us      6s    44ms     7ms   453ms     1ms
-- 锁持有时间
# Lock time          316us       0    28us     2us     5us     3us     1us
-- 向客户端发送的数据量
# Rows sent          6.02M       0   4.86M  42.52k  487.09 400.07k   16.81
-- 扫描的数据量
# Rows examine       6.40M       0   5.15M  45.22k   1.53k 419.77k  964.41
-- 查询大小
# Query size        17.04k      11     570  120.37  212.52  104.38   97.36

-- 查询排序
# Profile
-- 针对SQL生成的唯一标识 SQL花费总时间 这条SQL执行时间占用总时间百分比 执行次数 平均每次花费时间 这条SQL执行时间趋向平均值的方差，越小表示该条SQL越稳定 该SQL
# Rank Query ID           Response time Calls R/Call V/M   Item
# ==== ================== ============= ===== ====== ===== ===============
#    1 0xE418612AF8CD4C2D  5.5196 85.6%     1 5.5196  0.00 SELECT employees.employees employees.salaries
#    2 0x633F5856DF702BD1  0.5233  8.1%     3 0.1744  0.00 SELECT employees
#    3 0x24D0922230C4DAE5  0.1483  2.3%     1 0.1483  0.00 SELECT employees.employees
# MISC 0xMISC              0.2593  4.0%   140 0.0019   0.0 <37 ITEMS>

-- 针对某条SQL分析
-- ID
# Query 1: 0 QPS, 0x concurrency, ID 0xE418612AF8CD4C2D at byte 11646 ____
# This item is included in the report because it matches --limit.
-- 方差
# Scores: V/M = 0.00
# Time range: all events occurred at 2023-04-07T11:23:38
-- 详细信息
# Attribute    pct   total     min     max     avg     95%  stddev  median
# ============ === ======= ======= ======= ======= ======= ======= =======
# Count          0       1
# Exec time     85      6s      6s      6s      6s      6s       0      6s
# Lock time      0     3us     3us     3us     3us     3us       0     3us
# Rows sent     80   4.86M   4.86M   4.86M   4.86M   4.86M       0   4.86M
# Rows examine  80   5.15M   5.15M   5.15M   5.15M   5.15M       0   5.15M
# Query size     2     450     450     450     450     450       0     450
# String:
-- 数据库
# Databases    employees
-- 数据库实例
# Hosts        192.168.218.1
-- 哪个用户执行
# Users        imooc
-- 执行时间分布
# Query_time distribution
#   1us
#  10us
# 100us
#   1ms
#  10ms
# 100ms
#    1s  ################################################################
#  10s+
-- 该SQL相关的表
-- 同时pt-query-digest贴心地展示了SHOW和EXPLAIN语句，这样，如果这条SQL性能瓶颈又想查看表的状态就可以直接COPY执行
# Tables
#    SHOW TABLE STATUS FROM `employees` LIKE 'employees'\G
#    SHOW CREATE TABLE `employees`.`employees`\G
#    SHOW TABLE STATUS FROM `employees` LIKE 'salaries'\G
#    SHOW CREATE TABLE `employees`.`salaries`\G
# EXPLAIN /*!50100 PARTITIONS*/
-- 原始的SQL
select '10001' AS `emp_no`,'1953-09-02' AS `birth_date`,'Georgi' AS `first_name`,'Facello' AS `last_name`,'M' AS `gender`,'1986-06-26' AS `hire_date`,'0' AS `first_name_hash`,`employees`.`s`.`emp_no` AS `emp_no`,`employees`.`s`.`salary` AS `salary`,`employees`.`s`.`from_date` AS `from_date`,`employees`.`s`.`to_date` AS `to_date` from `employees`.`employees` `e` left join `employees`.`salaries` `s` on((`employees`.`s`.`emp_no` = 10001)) where true\G

-- 另一条SQL
# Query 2: 0.00 QPS, 0.00x concurrency, ID 0x633F5856DF702BD1 at byte 8552
# This item is included in the report because it matches --limit.
# Scores: V/M = 0.00
# Time range: 2023-03-26T22:11:49 to 2023-04-07T10:34:39
# Attribute    pct   total     min     max     avg     95%  stddev  median
# ============ === ======= ======= ======= ======= ======= ======= =======
# Count          2       3
# Exec time      8   523ms   165ms   192ms   174ms   189ms    12ms   163ms
# Lock time      2     7us     1us     3us     2us     2us       0     2us
# Rows sent     14 878.98k 292.99k 292.99k 292.99k 292.99k       0 292.99k
# Rows examine  13 878.98k 292.99k 292.99k 292.99k 292.99k       0 292.99k
# Query size     0      69      23      23      23      23       0      23
# String:
# Databases    employees
# Hosts        192.168.218.1
# Users        imooc
# Query_time distribution
#   1us
#  10us
# 100us
#   1ms
#  10ms
# 100ms  ################################################################
#    1s
#  10s+
# Tables
#    SHOW TABLE STATUS FROM `employees` LIKE 'employees'\G
#    SHOW CREATE TABLE `employees`.`employees`\G
# EXPLAIN /*!50100 PARTITIONS*/
select * from employees\G

# Query 3: 0 QPS, 0x concurrency, ID 0x24D0922230C4DAE5 at byte 23865 ____
# This item is included in the report because it matches --limit.
# Scores: V/M = 0.00
# Time range: all events occurred at 2023-04-07T15:15:24
# Attribute    pct   total     min     max     avg     95%  stddev  median
# ============ === ======= ======= ======= ======= ======= ======= =======
# Count          0       1
# Exec time      2   148ms   148ms   148ms   148ms   148ms       0   148ms
# Lock time      1     5us     5us     5us     5us     5us       0     5us
# Rows sent      4 292.99k 292.99k 292.99k 292.99k 292.99k       0 292.99k
# Rows examine   4 292.99k 292.99k 292.99k 292.99k 292.99k       0 292.99k
# Query size     0      33      33      33      33      33       0      33
# String:
# Databases    employees
# Hosts        192.168.218.1
# Users        imooc
# Query_time distribution
#   1us
#  10us
# 100us
#   1ms
#  10ms
# 100ms  ################################################################
#    1s
#  10s+
# Tables
#    SHOW TABLE STATUS FROM `employees` LIKE 'employees'\G
#    SHOW CREATE TABLE `employees`.`employees`\G
# EXPLAIN /*!50100 PARTITIONS*/
SELECT * FROM employees.employees\G

总结

怎么使用上面的报表呢？

首先，可以使用概要信息，主要关注R/Call，指这条SQL平均每次花费时间；Calls，这个值越多表示调用越频繁，调用越频繁的慢SQL优化的价值就越大；Response time，比例越大说明这条SQL越重要，优化价值越高。找到需要优化的SQL的Query ID再在报表中查找就可针对分析。

把日志分析结果存入表中（存在小坑）

pt-query-digest --user=imooc --password=Imooc@123456 --review h=localhost,D=test,t=query_history --create-review-table es23-slow.log

小坑报错

无法连接数据库，并报类似如下的异常：

DBI connect(';host=localhost;mysql_read_default_group=client','root',...) failed: Plugin caching_sha2_password could not be loaded: /usr/lib/x86_64-linux-gnu/mariadb19/plugin/caching_sha2_password.so: cannot open shared object file: No such file or directory at /usr/bin/pt-query-digest line 1001.

高版本的MySQL使用caching_sha2_password，由于目前Percona Toolkit中的部分工具暂不支持caching_sha2_password导致的。

解决方案有两种

• 方法一、连接数据，并输入类似如下命令：

mysql> ALTER USER 你的用户@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';

例如：

ALTER USER root@'localhost' IDENTIFIED WITH mysql_native_password BY 'root123';

• 方法二、修改mysql配置文件 my.cnf ，在其中添加如下内容，并重启。

[mysqld] default_authentication_plugin=mysql_native_password

使用navicat查看test数据库

总结

将日志分析结果存入表中的好处：可以每一个月执行一次这个命令，后续做统计

Percona Toolkit使用2-pt-index-usage

pt-index-usage

官方文档：pt-index-usage

• 作用

通过日志文件分析查询，并分析查询如何使用索引

• 原理
  • 清点数据库中所有的表与索引，并将库中现有的索引和日志中的查询所使用的索引进行比较
  • 对日志中的每个查询运行EXPLAIN（这一步使用单独的数据库连接清点表并执行EXPLAIN）
  • 对于无用的索引，展示删除的语句
• 语法

pt-index-usage [OPTIONS] [FILES]

• 常用OPTIONS

--drop					打印建议删除的索引，取值primary、unique、non-unique、all。默认值non-unique，只会打印未使用的二级索引
--databases			只分析指定数据库的索引，多个库用,分隔
--tables				只分析指定表的索引，多张表用,分隔
--progress			打印执行进度
--host  				指定MySQL地址，也可用-h指定
--port					指定MySQL端口
--user  				指定MySQL用户名，也可用-u指定
--password  		指定MySQL密码，也可用-p指定

DSN使用key=value的形式配置；多个DSN使用,分隔

• 常用DSN

  A    指定字符集
  D    指定连接的数据库
  h    连接数据库主机名
  p    连接数据库的密码
  P    连接数据库端口
  S    连接Socket file
  u    连接数据库用户名

• 使用示例

# 读取slow.log，并连上localhost，去分析有哪些索引是可以删除的
pt-index-usage slow.log --user=root --password=root123 --host=localhost --port=
# 读取slow.log，并连上localhost，只分析employees库中，有有哪些索引是可以删除的
pt-index-usage slow.log --user=root --password=root123 --host=localhost --databases=employees

• 注意点

  • 此工具使用MySQL资源比较多，因此，在使用此工具时候：

    • 如果有条件，尽量不要直接在生产环境执行，而应在有相同表结构的数据库环境执行；
    • 如果必须在生产环境执行，请避开高峰期，比如在凌晨低谷期执行

  • 此工具分析大文件比较慢，使用时需注意这点，并做一定处理（比如把遗留的超大的慢查询日志先删除，而可以新建一个慢查询日志，并运行一段时间后用pt-index-usage分析）

  • 由于pt-index-usage只会扫描慢查询，而非所有的查询，所以有可能某个索引在慢查询日志中未使用，但其实还是被使用了的（只是使用这个索引的SQL并非慢查询）。因此：

    • 正式删除之前，应当先review下，确保可以删除该索引后再操作，避免发生问题

    • 对于MySQL 8.0及更高版本，善用“不可见索引”，进一步降低风险。

      • 不可见索引是不会被MySQL优化器使用的，可以把要删除的索引设置为不可见索引，优化器就会忽略该索引，避免误删需要的索引

      • 具体操作：

        -- 设置成不可见
        ALTER TABLE `employees` ALTER INDEX `employees_first_name_last_name_index` invisible;
        -- 设置成可见
        ALTER TABLE `employees` ALTER INDEX `employees_first_name_last_name_index` visible;
        

pt-duplicate-key-checker ：可以帮助我们找到重复的索引或外键，使用方式基本类似。

具体操作

pt-index-usage es23-slow.log --user=imooc --password=Imooc@123456 --host=localhost

ALTER TABLE `employees`.`employees` DROP KEY `employees_first_name_last_name_index`; -- type:non-unique
ALTER TABLE `employees`.`salaries` DROP KEY `salaries_emp_no_salary_index`; -- type:non-unique

可以看到结果中对冗余索引生成了删除语句

Percona Toolkit使用3-其他工具

pt-variable-advisor

官方文档：pt-variable-advisor

• 作用

分析MySQL变量，并对可能出现的问题提出建议

• 原理

执行 SHOW VARIABLES ，并分析哪些变量的值设置不合理，给出建议

• 语法

pt-variable-advisor [OPTIONS] [DSN]

• 常用OPTIONS

--source-of-variable			指定变量来源，可选mysql/none或者文件
--user  									指定MySQL用户名，也可用-u指定
--password  							指定MySQL密码，也可用-p指定

• 常用DSN

  A    指定字符集
  D    指定连接的数据库
  h    连接数据库主机名
  p    连接数据库的密码
  P    连接数据库端口
  S    连接Socket file
  u    连接数据库用户名

DSN使用key=value的形式配置；多个DSN使用,分隔

• 使用示例

# 连接上localhost:3306，并分析变量
pt-variable-advisor localhost --user=root --password=root123
pt-variable-advisor P=3306,u=root,p=root123 localhost:3306

# 先将show global variables生成文件，然后用pt-variable-advisor分析文件
mysql -uroot -proot123 -e'show global variables' > /root/vars.txt
pt-variable-advisor --source-of-variables /root/vars.txt

具体操作

# 分析数据库变量
pt-variable-advisor localhost --user=imooc --password=Imooc@123456

# WARN delay_key_write: MyISAM index blocks are never flushed until necessary.

# WARN key_buffer_size: The key buffer size is set to its default value, which is not good  for most production systems.

# NOTE sort_buffer_size-1: The sort_buffer_size variable should generally be left at its default unless an expert determines it is necessary to change it.

# WARN expire_logs_days: Binary logs are enabled, but automatic purging is not enabled.

# NOTE innodb_data_file_path: Auto-extending InnoDB files can consume a lot of disk space that is very difficult to reclaim later.

# NOTE innodb_flush_method: Most production database servers that use InnoDB should set innodb_flush_method to O_DIRECT to avoid double-buffering, unless the I/O system is very low performance.

-- 直接将log_output设置输出到表是很影响性能的
# WARN log_output: Directing log output to tables has a high performance impact.

# WARN myisam_recover_options: myisam_recover_options should be set to some value such as BACKUP,FORCE to ensure that table corruption is noticed.

# 先将show global variables生成文件，然后用pt-variable-advisor分析文件
mysql -uimooc -pImooc@123456 -e'show global variables' > /root/vars.txt
pt-variable-advisor --source-of-variables /root/vars.txt

# WARN delay_key_write: MyISAM index blocks are never flushed until necessary.

# WARN key_buffer_size: The key buffer size is set to its default value, which is not good  for most production systems.

# NOTE sort_buffer_size-1: The sort_buffer_size variable should generally be left at its default unless an expert determines it is necessary to change it.

# WARN expire_logs_days: Binary logs are enabled, but automatic purging is not enabled.

# NOTE innodb_data_file_path: Auto-extending InnoDB files can consume a lot of disk space that is very difficult to reclaim later.

# NOTE innodb_flush_method: Most production database servers that use InnoDB should set innodb_flush_method to O_DIRECT to avoid double-buffering, unless the I/O system is very low performance.

# WARN log_output: Directing log output to tables has a high performance impact.

# WARN myisam_recover_options: myisam_recover_options should be set to some value such as BACKUP,FORCE to ensure that table corruption is noticed.

这也可以告诉我们哪些变量是不合理的，和上面一样

pt-online-schema-change

• 官方文档：pt-online-schema-change

• MySQL从5.6开始，已支持online r功能，pt-online-schema-change越来越弱化了。

  • 有关Online DDL，可详见 Online DDL Operations
  • 有关online DDL和pt-online-schema-change之间的对比详见《 MySQL ONLINE DDL 和PT-ONLINE-SCHEMA-CHANGE对比 》

• 作用

在线修改表结构，无需锁表地ALTER表结构

• 原理
  • 创建一张一模一样的表，表名一般是_new后缀
  • 在新表上执行更改字段操作
  • 在原表上加三个触发器，分别对应于DELETE/UPDATE/INSERT操作，并将原表中要执行的语句也在新表中执行
  • 将原表的数据拷贝到新表中
  • 使用原子的RENAME TABLE操作同时重命名原始表和新表，完成此操作后，删除原始表。
• 语法

pt-online-schema-change [OPTIONS] DSN

• 常用OPTIONS

--dry-run											创建并修改新表的结构，但不会创建触发器、拷贝旧表数据也不会替换旧表
--execute											如果指定该选项，则会修改表结构，否则只会做一些安全检查
--charset											指定编码
--alter												修改表结构的语句（其实就是你alter table语句，去掉alter table后剩下的部分），多条语句使用,分隔。该选项有一些限制，详见 https://www.percona.com/doc/percona-toolkit/3.0/pt-online-schema-change.html#cmdoption-pt-online-schema-change-alter 
--no-version-check						是否检查版本
--alter-foreign-keys-method		处理带有外键约束的表，以保证它们可以引用到正确的表。取值：auto（自动选择最佳策略）、rebuild_constraints（适用于删除和重新添加引用新表的外键约束）、drop_swap（禁用外键检查，然后在重命名新表之前将其删除）、none（无）

• 常用DSN

  A    指定字符集
  D    指定连接的数据库
  h    连接数据库主机名
  p    连接数据库的密码
  P    连接数据库端口
  S    连接Socket file
  t    想要alter的表
  u    连接数据库用户名

DSN使用key=value的形式配置；多个DSN使用,分隔

• 使用示例

# 为employees库的employees表添加字段my_test_column
pt-online-schema-change -uroot -proot123 --alter='add column my_test_column int' --alter-foreign-keys-method=rebuild_constraints --execute D=employees,t=employees --charset=utf8mb4

# 修改字段
pt-online-schema-change -uroot -proot123 --alter='modify column my_test_column bigint(25)' --alter-foreign-keys-method=rebuild_constraints --execute D=employees,t=employees --charset=utf8mb4

# 添加索引
pt-online-schema-change -uroot -proot123 --alter='add key indx_my_test_column(my_test_column)' --alter-foreign-keys-method=rebuild_constraints --execute D=employees,t=employees

# 删除索引
pt-online-schema-change -uroot -proot123 --alter='drop key indx_my_test_column' --alter-foreign-keys-method=rebuild_constraints --execute D=employees,t=employees

# 删除字段
pt-online-schema-change -uroot -proot123 --alter='drop column my_test_column int' --alter-foreign-keys-method=rebuild_constraints --execute D=employees,t=employees

• 注意点
  • 尽管用pt-online-schema-change 在线修改表结构不会锁表，但是对性能还是有一定的影响的。这是因为在执行过程中会做全表扫描，所以大表应在业务低峰期执行该操作；
  • 对于主从复制架构，考虑到主从的一致性，应在主库上执行pt-online-schema-change操作。

其他工具

# 展示系统概要信息
pt-summary

# 展示MySQL相关的概要信息
pt-mysql-summary --user=root --password=root123 --host=localhost --port=3306

# 把explain的结果转换成树形展示（在早期MySQL中，没有explain format=tree时，比较有用，可以增强explain的可读性）
mysql -uroot -proot123 -e "explain select * from employees.employees" > test-explain.sql
pt-visual-explain --host=localhost --user=root --password=root123 test-explain.sql

遇到的问题

无法连接数据库，并报类似如下的异常：

DBI connect(';host=localhost;mysql_read_default_group=client','root',...) failed: Plugin caching_sha2_password could not be loaded: /usr/lib/x86_64-linux-gnu/mariadb19/plugin/caching_sha2_password.so: cannot open shared object file: No such file or directory at /usr/bin/pt-query-digest line 1001.

这是由于目前Percona Toolkit中的部分工具暂不支持caching_sha2_password导致的。

解决方案有两种：

• 方法一、连接数据，并输入类似如下命令：

mysql> ALTER USER 你的用户@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';

例如：

ALTER USER root@'localhost' IDENTIFIED WITH mysql_native_password BY 'root123';

• 方法二、修改mysql配置文件 my.cnf ，在其中添加如下内容，并重启。

[mysqld] default_authentication_plugin=mysql_native_password

所有工具官方文档

• pt-align ：对齐其他工具的输出
• pt-archiver ：将数据归档到其他表或文件
• pt-config-diff ：比较配置文件和变量
• pt-deadlock-logger ：记录MySQL死锁
• pt-diskstats ：交互式IO监控工具
• pt-duplicate-key-checker ：找到重复的索引或外键
• pt-fifo-split ：模拟分割文件并输出
• pt-find ：查找表，并执行命令
• pt-fingerprint ：将查询转换成fingerprint
• pt-fk-error-logger ：记录外键错误信息
• pt-heartbeat ：监控MySQL复制延迟
• pt-index-usage ：通过日志分析查询，并分析查询如何使用索引
• pt-ioprofile ：监控进程IO并打印IO活动表
• pt-kill ：kill掉符合条件查询
• pt-mext ：并行查询SHOW GLOBAL STATUS的样本信息
• pt-mongodb-query-digest ：通过汇总来自MongoDB查询分析器（query profiler）的查询来报告查询使用情况统计信息
• pt-mongodb-summary ：收集有关MongoDB集群的信息，它从多个来源收集信息从而提供集群的概要信息
• pt-mysql-summary ：展示MySQL相关的概要信息
• pt-online-schema-change ：在线修改表结构。无需锁表地ALTER表结构
• pt-pg-summary ：收集有关PostgreSQL集群的信息
• pt-pmp ：针对指定程序，聚合GDB的stack traces
• pt-query-digest ：从日志、processlist以及tcpdump中分析MySQL查询
• pt-secure-collect ：收集、清理、打包、加密数据
• pt-show-grants ：规范化打印MySQL授权
• pt-sift ：浏览由pt-stalk创建的文件
• pt-slave-delay ：使MySQL从属服务器滞后于其Master
• pt-slave-find ：查找和打印MySQL slave的复制层级树
• pt-slave-restart ：监控MySQL slave，并在发生错误后重启
• pt-stalk ：发生问题时收集有关MySQL的诊断数据
• pt-summary ：展示系统概要信息
• pt-table-checksum ：验证MySQL主从复制的一致性
• pt-table-sync ：高效同步表数据
• pt-table-usage ：分析查询是如何使用表的
• pt-upgrade ：验证不同服务器上的查询结果是否相同
• pt-variable-advisor ：分析MySQL变量，并对可能出现的问题提出建议
• pt-visual-explain ：将explain的结果格式化成树形展示

参考文档

• percona toolkit 学习记录
• Percona Toolkit 实战
• Percona Toolkit(pt)的安装与使用