tpcorg/hammerdb

HammerDB Docker镜像文档

镜像概述和主要用途

HammerDB Docker镜像是TPC-Council官方提供的数据库性能测试工具镜像，支持Oracle、Microsoft SQL Server、MySQL、PostgreSQL、MariaDB等主流数据库（暂不支持IBM Db2，计划未来版本添加）。提供通用全功能镜像和轻量级数据库专用镜像，可快速部署，支持命令行（CLI）和图形界面（GUI）模式，适用于各类数据库性能测试场景。

核心功能和特性

• 官方认证：由TPC-Council维护，确保与HammerDB功能一致性和可靠性
• 多数据库支持：通用镜像支持多种主流数据库，专用镜像针对特定数据库优化，体积更轻量
• 灵活部署：可直接从DockerHub拉取预构建镜像，或使用Dockerfile自定义构建
• 双模式支持：支持CLI模式自动化测试和GUI模式可视化操作
• 内置测试脚本：包含TPROC-C和TPROC-H工作负载的Python/TCL示例脚本，简化测试流程

使用场景和适用范围

• 数据库性能评估：对Oracle、SQL Server、MySQL等数据库执行标准TPC工作负载测试
• 快速测试环境搭建：通过Docker容器化部署，无需手动配置依赖，缩短环境准备时间
• 云环境部署：轻量级专用镜像适合资源受限的云环境或容器编排平台
• 自动化测试集成：CLI模式和示例脚本可集成到CI/CD流程，实现性能回归测试

详细使用方法和配置说明

1. 获取镜像

1.1 从DockerHub拉取预构建镜像

通用镜像（支持所有兼容数据库）：

bash
# 拉取官方镜像
docker pull tpcorg/hammerdb
# 重命名镜像（可选）
docker tag tpcorg/hammerdb hammerdb

查看所有可用镜像标签：https://hub.docker.com/r/tpcorg/hammerdb/tags

数据库专用轻量级镜像：

bash
# MySQL专用镜像
docker pull tpcorg/hammerdb:mysql
# MariaDB专用镜像
docker pull tpcorg/hammerdb:maria
# Oracle专用镜像
docker pull tpcorg/hammerdb:oracle
# PostgreSQL专用镜像
docker pull tpcorg/hammerdb:postgres
# Microsoft SQL Server专用镜像
docker pull tpcorg/hammerdb:mssqls

1.2 从Dockerfile构建镜像

通用镜像构建：

1. 获取Dockerfile：https://github.com/TPC-Council/HammerDB/blob/master/Docker/Dockerfile
2. 进入Dockerfile所在目录，执行构建命令：

bash
docker build -t hammerdb .

数据库专用镜像构建： 各数据库专用Dockerfile位于https://github.com/TPC-Council/HammerDB/tree/master/Docker/%EF%BC%88%E5%A6%82MySQL%E7%9A%84Dockerfile%E5%9C%A8%60Docker/mysql/%60%E7%9B%AE%E5%BD%95%EF%BC%89%EF%BC%8C%E8%BF%9B%E5%85%A5%E5%AF%B9%E5%BA%94%E7%9B%AE%E5%BD%95%E5%90%8E%E6%9E%84%E5%BB%BA%EF%BC%9A

bash
# 以MySQL为例
cd Docker/mysql/
docker build -t hammerdb:mysql .

2. 创建和启动容器

2.1 基本CLI模式启动

创建并启动名为"hammerdb"的容器（需网络通信以连接远程数据库）：

bash
# 基本启动（需额外配置网络）
docker run -it --name hammerdb hammerdb bash

# 使用主机网络（推荐，便于与本地数据库通信）
docker run --network=host -it --name hammerdb hammerdb bash

2.2 数据库专用容器启动

使用专用镜像启动轻量级容器（以MySQL为例）：

bash
docker run --network=host -it --name hammerdb-mysql hammerdb:mysql bash

3. 使用内置测试脚本

镜像内置scripts目录包含CLI测试脚本，支持TPROC-C和TPROC-H工作负载，提供Python和TCL两种版本，适用于所有支持的数据库。

3.1 脚本结构与用途

脚本位于/home/hammerdb/scripts/目录，以MariaDB TPROC-C为例：

• maria_tprocc_buildschema.py：构建测试数据集（schema）
• maria_tprocc_run.py：执行TPROC-C工作负载测试
• maria_tprocc_deleteschema.py：清理测试数据集
• maria_tprocc_result.py：生成测试结果报告
• maria_tprocc_py.sh：整合上述步骤的一键执行脚本

3.2 执行流程

1. 进入HammerDB主目录：

bash
cd /home/hammerdb/

2. 关键步骤：编辑脚本中的数据库连接参数（如数据库地址、端口、用户名、密码）
3. 执行测试脚本（以MariaDB TPROC-C为例）：

bash
./scripts/python/maria/tprocc/maria_tprocc_py.sh

测试结果将保存至/home/hammerdb/TMP目录。其他数据库及TCL脚本使用方式类似。

4. 启用GUI界面

通过X11转发实现容器内GUI界面显示，需预先配置X11环境。

4.1 环境配置（以Ubuntu为例）

bash
# 设置显示环境变量
export DISPLAY=localhost:10.0
# 禁用X11主机访问控制
xhost +

4.2 启动GUI模式容器

bash
docker run -it --rm \
  -v ~/.Xauthority:/root/.Xauthority \
  -e DISPLAY=$DISPLAY \
  --network=host \
  --name hammerdb \
  hammerdb bash

容器启动后，在终端执行hammerdb命令即可打开GUI界面。

参考资料

更多详情请参考HammerDB官方博客：如何使用Docker快速部署HammerDB CLI