pt-slave-delay¶
名字¶
pt-slave-delay—使MySQL从服务器落后于主服务器。
剧情简介¶
使用¶
pt-奴隶-延迟[选项]SLAVE_DSN[MASTER_DSN]
pt-slave-delay根据需要启动和停止从服务器,使其落后于主服务器。SLAVE_DSN和MASTER_DSN使用DSN语法,如果省略,值将从SLAVE_DSN复制到MASTER_DSN。
让从主机比主主机慢一分钟,持续十分钟:
pt-slave-delay——延迟1米——时间间隔15秒——运行时10米slavehost
风险¶
雷竞技下载官网Percona Toolkit是成熟的,在现实世界中得到了验证,并且经过了良好的测试,但所有数据库工具都可能对系统和数据库服务器构成风险。使用此工具前,请:
阅读工具的文档
检查工具已知的“bug”
在非生产服务器上测试该工具
备份您的生产服务器并验证备份
描述¶
pt-slave-delay监视一个从线程,并根据需要启动和停止它的复制SQL线程,使它至少按照您的要求落后于主线程。在实践中,它通常会导致从服务器之间的延迟——延迟
和——延迟
+——时间间隔
在主人后面。
默认情况下,它将延迟基于从服务器中继日志中的binlog位置,因此不需要连接到主服务器。如果IO线程不太滞后于主线程,这工作得很好,这在大多数复制设置中是典型的;在快速网络中,IO线程延迟通常为毫秒。如果IO线程的延迟对您的目的来说太大,pt-slave-delay也可以连接到主机以获取有关binlog位置的信息。
如果从服务器的I/O线程报告它正在等待SQL线程释放一些中继日志空间,pt-slave-delay将自动连接到主机查找二进制日志位置。如果——ask-pass
和——daemonize
,这可能会导致它在守护过程中要求输入密码。在本例中,它退出。因此,如果您认为您的slave可能会遇到这种情况,您应该确保指定其中之一——使用主
在守护时显式地执行,或者不指定——ask-pass
。
SLAVE_DSN和可选的MASTER_DSN都是dsn。参见“深网选项”。缺少的MASTER_DSN值将用来自SLAVE_DSN的值填充,因此不需要在两个地方都指定它们。pt-slave-delay读取所有正常的MySQL选项文件,如~/.my.cnf,所以你可能不需要指定用户名,密码和其他常见的选项。
pt-slave-delay试图通过捕获Ctrl-C等信号优雅地退出。你不能绕过——(没有)继续
有可捕捉的信号。
特权¶
pt-slave-delay需要的权限包括:PROCESS、REPLICATION CLIENT和SUPER。
输出¶
如果你指定——安静
,没有输出。否则,正常的输出是一个状态消息,由时间戳和关于什么的信息组成pt-slave-delay正在做:启动奴隶,停止奴隶,或只是观察。
选项¶
该工具接受额外的命令行参数。详细信息请参考“概要”和使用信息。
- ——ask-pass ¶
-
连接MySQL时提示输入密码。
- ——字符集 ¶
-
简写形式:-A;类型:字符串
默认字符集。如果值为utf8,将Perl在STDOUT上的binmode设置为utf8,将mysql_enable_utf8选项传递给DBD::mysql,并在连接mysql后运行SET NAMES utf8。任何其他值在没有utf8层的STDOUT上设置binmode,并在连接到MySQL后运行SET NAMES。
- ——配置 ¶
-
类型:数组
读取以逗号分隔的配置文件列表;如果指定,则必须是命令行上的第一个选项。
- ——(没有)继续 ¶
-
默认值:是的
退出时继续正常复制。退出后,在没有UNTIL条件的情况下重新启动从进程的SQL线程,这样它将照常运行并赶上主进程。这在默认情况下是启用的,即使您终止也能正常工作pt-slave-delaycontrol - c。
- ——daemonize ¶
-
Fork到后台并从shell分离。仅支持POSIX操作系统。
- ——数据库 ¶
-
简写形式:-D;类型:字符串
用于连接的数据库。
- ——defaults-file ¶
-
简写形式:-F;类型:字符串
只从给定文件中读取mysql选项。你必须给出一个绝对路径名。
- ——延迟 ¶
-
类型:时间;默认值:1 h
奴隶应该落后主人多远。
- ——帮助 ¶
-
求救并离开。
- ——主机 ¶
-
简写形式:-h;类型:字符串
连接到主机。
- ——时间间隔 ¶
-
类型:时间;默认值:1米
的频率pt-slave-delay应该检查从机是否需要启动或停止。
- ——日志 ¶
-
类型:字符串
守护时将所有输出打印到此文件。
- ——密码 ¶
-
简写形式:-p;类型:字符串
连接时使用的密码。如果password包含逗号,则必须用反斜杠转义:" exam,ple "
- ——pid ¶
-
类型:字符串
创建给定的PID文件。如果PID文件已经存在,并且其中包含的PID与当前PID不同,该工具将不会启动。但是,如果PID文件存在,并且其中包含的PID不再运行,该工具将用当前的PID覆盖PID文件。当工具退出时,PID文件将自动删除。
- ——港口 ¶
-
简写形式:-P;类型:int
用于连接的端口号。
- ——安静 ¶
-
简写为-q
不要打印关于操作的信息信息。详见OUTPUT。
- ——运行时 ¶
-
类型:时间
多长时间pt-slave-delay应在退出前运行。默认是永远运行。
- ——set-vars ¶
-
类型:数组
的列表中设置MySQL变量
变量=值
对。默认情况下,工具集:
wait_timeout=10000
在命令行上指定的变量将覆盖这些默认值。例如,指定
——set-varswait_timeout = 500
的默认值10000
。如果无法设置变量,该工具将打印警告并继续。
- ——套接字 ¶
-
简写形式:-S;类型:字符串
用于连接的套接字文件。
- ——使用主 ¶
-
从主服务器获取binlog位置,而不是从服务器。不要相信从站中继日志中的binlog位置。连接到主服务器并获得binlog位置。如果指定此选项时没有在命令行上给出MASTER_DSN,pt-slave-delay检查从机的SHOW slave STATUS以确定连接到主机的主机名和端口。
pt-slave-delay主连接只使用SHOW SLAVE STATUS中的MASTER_HOST和MASTER_PORT值。它不使用MASTER_USER值。如果希望为主服务器指定不同于用于连接从服务器的用户名,则应该在命令行上显式指定MASTER_DSN选项。
- ——用户 ¶
-
简写形式:-u;类型:字符串
如果不是当前用户,则为登录用户。
- ——版本 ¶
-
显示版本并退出。
- ——(没有)版本检查 ¶
-
默认值:是的
检查最新版本的Percona Toolkit、MySQL和其他程雷竞技下载官网序。
这是一个标准的“自动检查更新”功能,还有两个附加功能。首先,该工具检查自己的版本,以及以下软件的版本:操作系统、Percona监控和管理(PMM)、MySQL、Perl、MySQL Perl驱动程序(DBD:: MySQL)和Percona Toolkit。雷竞技下载官网raybet雷竞技竞猜在线官网其次,它检查并警告存在已知问题的版本。例如,MySQL 5.5.25有一个严重的错误,并重新发布为5.5.25a。
通过与Percona的Version Chec雷竞技下载官网k数据库服务器的安全连接来执行这些检查。服务器记录每个请求,包括软件版本号和所检查系统的唯一ID。该ID由Percona Toolkit安装脚本或第一次雷竞技下载官网调用Version Check数据库时生成。
在工具正常输出之前,任何更新或已知问题都打印到STDOUT。该特性不应干扰工具的正常操作。
更多信息,请访问https://www.雷竞技下载官网percona.com/doc/percona-toolkit/LATEST/version-check.html。
DSN选项¶
这些DSN选项用于创建DSN。每个选项给出如下选项=值
。选项是区分大小写的,所以P和P不是同一个选项。的前面或后面不能有空格=
如果值包含空格,则必须加引号。DSN选项以逗号分隔。详细信息请参阅p雷竞技下载官网ercona-toolkit manpage。
一个
dsn:字符集;复制:是的
默认字符集。
D
dsn:数据库;复制:是的
默认数据库。
F
dsn: mysql_read_default_file;复制:是的
只从给定文件中读取默认选项
h
dsn:主机;复制:是的
连接到主机。
p
dsn:密码;复制:是的
连接时使用的密码。如果password包含逗号,则必须用反斜杠转义:" exam,ple "
P
dsn:港口;复制:是的
用于连接的端口号。
年代
dsn: mysql_socket;复制:是的
用于连接的套接字文件。
u
dsn:用户;复制:是的
如果不是当前用户,则为登录用户。
环境¶
环境变量PTDEBUG
打开详细调试输出到STDERR。要启用调试并将所有输出捕获到一个文件,运行如下工具:
PTDEBUG=1pt-slave-delay…>文件2>&1
注意:调试输出是大量的,可能会产生几兆字节的输出。
注意¶
使用
系统需求¶
您需要Perl、DBI、DBD::mysql和一些核心包,这些包应该安装在任何合理的Perl新版本中。
错误¶
有关已知错误的列表,请参见https://jira.雷竞技下载官网percona.com/projects/PT/issues。
请在https://jira.雷竞技下载官网percona.com/projects/PT。在错误报告中包含以下信息:
用于运行工具的完整命令行
工具
——版本
所有涉及的服务器的MySQL版本
工具的输出,包括STDERR
输入文件(日志/转储/配置文件等)
如果可能,通过运行工具包含调试输出PTDEBUG
;看到“环境”。
下载¶
访问http://www.雷竞技下载官网percona.com/software/percona-toolkit/下载最新版本的Percona Toolkit。雷竞技下载官网或者,从命令行获取最新版本:
wget雷竞技下载官网percona.com/get/percona-toolkit.tar.gz wget雷竞技下载官网percona.com/get/percona-toolkit.rpm wget雷竞技下载官网percona.com/get/percona-toolkit.deb
您还可以从最新版本中获得单独的工具:
wget雷竞技下载官网percona.com/get/TOOL
取代工具
使用任何工具的名称。
关于perc雷竞技下载官网ona工具箱¶
该工具是Percona Toolkit的一雷竞技下载官网部分,是Percona开发的MySQL高级命令行工具的集合。雷竞技下载官网Percona Toolkit在2011年6月从两个项目中分叉出来:Maatkit和Aspersa。这些项目是由Baron Schwartz创建的,主要由他和Daniel Nichter开发。访问http://www.雷竞技下载官网percona.com/software/以了解Percona的其他免费开源软件。雷竞技下载官网
版权、许可和保证¶
本节目版权归2011-2021 Percona LLC和/或其附属公司所雷竞技下载官网有,2007-2011 Sergey Zhuravle和Baron Schwartz
本程序按“现状”提供,不作任何明示或默示保证,包括但不限于对适销性和适合某一特定用途的默示保证。
本程序是免费软件;您可以根据由自由软件基金会发布的GNU通用公共许可证第2版的条款重新发布它和/或修改它;或者Perl艺术许可。在UNIX和类似的系统上,您可以发出' man perlgpl '或' man perlartistic '来读取这些许可证。
您应该已随本程序收到一份GNU通用公共许可证的副本;如果没有,请写信给自由软件基金会,59 Temple Place, Suite 330, Boston, MA 02111-1307 USA。
版本¶
pt-slave-delay3.5.2