pt-slave-find¶
名字¶
pt-slave-find-查找并打印MySQL slave的复制层次树。
剧情简介¶
使用¶
pt-奴隶-找到[选项][DSN]
pt-slave-find找到并打印MySQL slave的层次树。
例子¶
pt-slave-find——主机主服务器
风险¶
雷竞技下载官网Percona Toolkit是成熟的,在现实世界中得到了验证,并且经过了良好的测试,但所有数据库工具都可能对系统和数据库服务器构成风险。使用此工具前,请:
阅读工具的文档
检查工具已知的“bug”
在非生产服务器上测试该工具
备份您的生产服务器并验证备份
描述¶
pt-slave-find连接到MySQL复制主服务器并找到它的从服务器。目前它唯一能做的是打印复制层次结构的树状视图。
可以使用以下两种方法之一指定主主机。第一种方法是使用标准的连接相关命令行选项:——defaults-file
,——密码
,——主机
,——港口
,——套接字
或——用户
。
指定主主机的第二种方法是一个DSN。DSN是一种特殊的语法,它可以只是一个主机名(比如server.domain.com
或为1.2.3.4
),或键=值,键=值
字符串。钥匙是一个字母:
关键意义= = == = = = = = =h连接来主机P港口数量来使用为连接年代套接字文件来使用为连接你用户为登录如果不当前的用户p密码来使用当连接F只有读默认的选项从的鉴于文件
pt-slave-find读取所有正常的MySQL选项文件,如~/.my.cnf,所以你可能不需要指定用户名,密码和其他常见的选项。
退出状态¶
退出状态为0(有时也称为返回值或返回码)表示成功。任何其他值表示Perl进程本身的退出状态。
选项¶
该工具接受额外的命令行参数。详细信息请参考“概要”和使用信息。
- ——ask-pass ¶
-
连接MySQL时提示输入密码。
- ——字符集 ¶
-
简写形式:-A;类型:字符串
默认字符集。如果值为utf8,将Perl在STDOUT上的binmode设置为utf8,将mysql_enable_utf8选项传递给DBD::mysql,并在连接mysql后运行SET NAMES utf8。任何其他值在没有utf8层的STDOUT上设置binmode,并在连接到MySQL后运行SET NAMES。
- ——配置 ¶
-
类型:数组
读取以逗号分隔的配置文件列表;如果指定,则必须是命令行上的第一个选项。
- ——数据库 ¶
-
类型:字符串;简写形式:d
使用的数据库。
- ——defaults-file ¶
-
简写形式:-F;类型:字符串
只从给定文件中读取mysql选项。你必须给出一个绝对路径名。
- ——帮助 ¶
-
求救并离开。
- ——主机 ¶
-
简写形式:-h;类型:字符串
连接到主机。
- ——密码 ¶
-
简写形式:-p;类型:字符串
连接时使用的密码。如果password包含逗号,则必须用反斜杠转义:" exam,ple "
- ——pid ¶
-
类型:字符串
创建给定的PID文件。如果PID文件已经存在,并且其中包含的PID与当前PID不同,该工具将不会启动。但是,如果PID文件存在,并且其中包含的PID不再运行,该工具将用当前的PID覆盖PID文件。当工具退出时,PID文件将自动删除。
- ——港口 ¶
-
简写形式:-P;类型:int
用于连接的端口号。
- ——递归 ¶
-
类型:int
在层次结构中递归的层数。违约是无限的。
- ——recursion-method ¶
-
类型:数组;默认值:processlist,主机
首选的递归方法用于查找从库。
可能的方法有:
方法使用=============================processlist显示PROCESSLIST主机显示奴隶主机没有做不找到奴隶
processlist方法是首选的,因为SHOW SLAVE HOSTS不可靠。但是,如果服务器使用非标准端口(不是3306),则需要使用hosts方法。通常pt-slave-find做正确的事情,找到奴隶,但你可以给出一个首选的方法,它将被首先使用。如果没有找到任何slave,则会尝试其他方法。
- ——报告格式 ¶
-
类型:字符串;默认值:总结
设置打印关于slave的信息。报告格式可以是以下格式之一:
主机名
只打印从服务器的主机名。它看起来是这样的:
127.0.0.1:12345 + -127.0.0.1:12346+-127.0.0.1:12347
总结
打印每个从站设置的摘要。这个报告显示了每个奴隶的更多信息,比如:
127.0.0.1:12345版本5.1.34-log服务器ID12345正常运行时间04:56(开始201006-17t11:21:22)复制是不一个奴隶,有1奴隶连接滤波器日志记录声明的奴隶地位的奴隶模式严格的自动递增增量1,抵消1+-127.0.0.1:12346版本5.1.34-log服务器ID12346正常运行时间04: 54(开始201006-17t11:21:24)复制是一个奴隶,有1奴隶连接过滤器二进制日志记录声明奴隶状态0秒在后面,运行时,没有错误奴隶模式严格的自动递增增量1,抵消1
- ——resolve-address ¶
-
将ip-address解析为主机名。报告将打印IP和主机名。
例子:
10.10.7.14(dbase1.sample.net)
可能会使运行时延迟几秒钟。
- ——slave-user ¶
-
类型:字符串
设置用于连接从服务器的用户。此参数允许您拥有一个在slave上拥有较少权限的不同用户,但该用户必须存在于所有slave上。
- ——slave-password ¶
-
类型:字符串
设置用于连接从机的密码。它可以与-slave-user一起使用,并且所有slave上的用户密码必须相同。
- ——set-vars ¶
-
类型:数组
的列表中设置MySQL变量
变量=值
对。默认情况下,工具集:
wait_timeout=10000
在命令行上指定的变量将覆盖这些默认值。例如,指定
——set-varswait_timeout = 500
的默认值10000
。如果无法设置变量,该工具将打印警告并继续。
- ——套接字 ¶
-
简写形式:-S;类型:字符串
用于连接的套接字文件。
- ——用户 ¶
-
简写形式:-u;类型:字符串
如果不是当前用户,则为登录用户。
- ——版本 ¶
-
显示版本并退出。
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-find…>文件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 Baron Schwartz。
本程序按“现状”提供,不作任何明示或默示保证,包括但不限于对适销性和适合某一特定用途的默示保证。
本程序是免费软件;您可以根据由自由软件基金会发布的GNU通用公共许可证第2版的条款重新发布它和/或修改它;或者Perl艺术许可。在UNIX和类似的系统上,您可以发出' man perlgpl '或' man perlartistic '来读取这些许可证。
您应该已随本程序收到一份GNU通用公共许可证的副本;如果没有,请写信给自由软件基金会,59 Temple Place, Suite 330, Boston, MA 02111-1307 USA。
版本¶
pt-slave-find3.5.2