Skip to content

通用说明

本页汇总所有 Percona Toolkit 工具共有的"其他信息"内容(已知问题、调试安全提示、系统要求基线、环境变量),避免在每个工具页重复。各工具页只保留其特有内容(作者、特殊依赖、致谢),并在文末附上本页链接与官方英文文档链接。

已知问题(BUGS)

所有工具的已知问题统一在 Percona 的 Jira 项目跟踪:https://jira.percona.com/projects/PT/issues

报告新问题时请尽量附上:

  • 完整命令行;
  • --version 输出;
  • 涉及的数据库版本(MySQL / MongoDB / PostgreSQL);
  • 包含 STDERR 的完整输出;
  • 相关输入文件;
  • 如可能,用 PTDEBUG=1 附上调试输出(见下方安全提示)。

调试与 PTDEBUG 安全提示

所有工具均支持 PTDEBUG=1 开启调试输出,帮助排查问题。注意两点:

  • 调试输出量很大,可能达到数 MB;
  • 调试输出会暴露命令行参数中的密码——开启后请勿在公共环境分享输出。
bash
PTDEBUG=1 pt-toolname ... > FILE 2>&1

系统要求(基线)

所有工具需要:

  • Perl(较新版本自带所需核心包);
  • DBI 与 DBD::mysql(MySQL 系工具);
  • MongoDB 系工具需要 Perl 的 MongoDB 驱动;PostgreSQL 系工具需要相应的 Perl / psql 依赖。

部分工具有额外依赖(例如 Bash v3+、gdb、elfutils 的 eu-stack/proc 文件系统、seq 等),已在各工具页"其他信息"中注明。完整基线见 系统要求

环境变量

所有工具均支持 PTDEBUG=1(见上方安全提示)。部分工具不使用其他环境变量,详见各工具页。更完整的变量说明见 环境变量

Percona Toolkit 中文文档 · 社区维护的第三方学习站