配置文件（CONFIGURATION FILES）

Percona Toolkit 的工具可以从配置文件中读取选项。配置文件语法简单直接， 与 MySQL 命令行客户端工具有些相似，所有配置文件都遵循相同的约定。

工具内部的处理方式是：读取配置文件中的行，并将其作为命令行选项和参数追加给工具。 因此可以把配置文件理解为"把命令行写进文件里"的一种方式。

语法

• 空白字符后跟井号（#）表示该行其余部分是注释，会被删除。

• 所有行首尾的空白字符会被去除。

• 空行会被忽略。

• 每行只能是以下两种格式之一：

  option
  option=value

  选项前不要加 --；值不要加引号（即使包含空格），值按字面处理； 等号两边的空白会在处理时删除。

• 只识别长选项。

• 只包含两个连字符（--）的行表示选项解析结束，其后的行会被解释为程序的 附加参数（而非选项）。

示例

下面是 pt-stalk 的一个配置文件：

# Config for pt-stalk
variable=Threads_connected
cycles=2  # trigger if problem seen twice in a row
--
--user daniel

它等价于如下命令行：

pt-stalk --variable Threads_connected --cycles 2 -- --user daniel

-- 之后的选项会原样传递给 mysql 和 mysqladmin。

读取顺序

工具按以下顺序读取多个配置文件：

1. 全局 Percona Toolkit 配置文件 /etc/percona-toolkit/percona-toolkit.conf： 所有工具都会读取，只应放入希望对所有工具生效的选项。
2. 全局的工具专属配置文件 /etc/percona-toolkit/TOOL.conf （TOOL 是工具名，如 pt-query-digest）：只对该工具生效。
3. 用户的 Percona Toolkit 配置文件 $HOME/.percona-toolkit.conf： 所有工具都会读取，只应放入希望对所有工具生效的选项。
4. 用户的工具专属配置文件 $HOME/.TOOL.conf：只对该工具生效。

指定配置文件

特殊选项 --config 可以指定工具读取哪些配置文件，值为逗号分隔的文件列表。 但它的行为与其他命令行选项不同：

• 必须放在命令行的最前面（在任何其他选项之前），否则会报错。

• 不能写成 --config=/path/to/file，必须用空格分隔选项与路径：

  --config /path/to/file

• 如果不想读取任何配置文件，可以指定 --config '' 提供空列表。

更多细节请阅读 官方文档。