percona/percona-toolkit

Percona Toolkit Docker镜像概述

Percona Toolkit Docker镜像是Percona Toolkit的容器化封装，提供一组用于MySQL和MongoDB数据库管理的开源命令行工具集。该镜像简化了工具的部署流程，无需手动配置依赖，可直接在容器化环境中运行，适用于数据库性能分析、数据迁移、结构变更等运维场景。

主要特性

• 完整工具集：包含pt-query-digest（慢查询分析）、pt-online-schema-change（无锁表结构变更）、pt-table-checksum（数据一致性校验）等数十个实用工具。
• 容器化优势：轻量级镜像，启动快速，支持Docker、containerd等主流容器运行时，便于集成到CI/CD或Kubernetes环境。
• 官方维护：由Percona官方更新，工具版本与上游同步，确保功能稳定性和安全性。
• 跨平台兼容：可在Linux、Windows、macOS等系统中使用，支持多种数据库版本（MySQL 5.6+、MongoDB 3.0+）。

典型使用场景

• 数据库性能诊断：通过pt-query-digest分析慢查询日志，定位性能瓶颈。
• 无锁结构变更：使用pt-online-schema-change在不中断业务的情况下修改表结构。
• 主从数据同步：通过pt-table-sync修复主从数据不一致问题。
• 数据迁移与备份：利用pt-dump高效导出数据，支持条件过滤和并行处理。

部署示例

1. 拉取镜像

bash
docker pull percona/percona-toolkit

2. 运行慢查询分析工具

分析本地慢查询日志文件（需挂载日志目录到容器）：

bash
docker run --rm -v $(pwd)/logs:/logs percona/percona-toolkit pt-query-digest /logs/slow.log

3. 连接MySQL容器执行数据校验

假设MySQL容器名为mysql-server，且在同一Docker网络：

bash
docker run --rm --network=mysql-network percona/percona-toolkit pt-table-checksum --user=admin --password=secret --host=mysql-server

注意事项

• 网络配置：确保工具容器与目标数据库网络互通，可通过--network指定Docker网络或--link连接容器。
• 权限管理：运行工具的数据库用户需具备足够权限（如SELECT、PROCESS、SUPER等）。
• 敏感信息：建议通过环境变量（-e）或配置文件挂载（-v）传入数据库密码，避免明文暴露。
• 版本控制：生产环境建议使用固定版本标签（如:3.5.5），而非latest。