miskolabor/pgbench-tester

pgBench PostgreSQL测试镜像

概述

该镜像用于对PostgreSQL数据库执行pgBench性能测试，测试结果将输出到日志中。它提供了灵活的参数配置，支持自定义测试场景，适用于自动化评估PostgreSQL在不同负载条件下的性能表现。

核心功能与特性

• 执行标准pgBench性能测试，支持自定义测试参数
• 测试结果记录到日志文件并在测试完成后显示
• 支持配置客户端数量、测试持续时间、并发任务数等关键参数
• 测试完成后容器自动随机休眠60-240秒，便于观察结果

使用场景

• PostgreSQL数据库性能基准测试
• 不同并发用户数下的数据库响应能力评估
• 数据库优化前后的性能对比测试
• 自动化性能测试流程集成

前置要求

1. 目标数据库准备：需提前创建并初始化目标数据库（DBNAME），例如使用以下命令初始化基准数据：

   bash
   pgbench -d ${DBNAME} -h ${SOCKET} -i -s 500
   

   注：此镜像仅运行基准测试，不包含数据库初始化功能。

2. 数据库连接配置：确保PostgreSQL的pg_hba.conf文件包含正确的访问控制条目，允许镜像连接数据库。示例配置（假设用户名为test，数据库名为pgbench，网络地址为172.16.16.0/24）：

   host pgbench test    172.16.16.0/24   md5
   

配置参数（环境变量）

使用方法

基本执行命令

容器内部执行的pgBench命令格式如下：

bash
pgbench -d ${DBNAME} -U ${PGUSER} -c ${CLIENTS_NO} -T ${TEST_DURATION_S} -h ${SOCKET} -j ${JOBS_NO} -p ${PORT} -r > ${TLOGS}

Docker运行示例

bash
docker run -e DBNAME=pgbench \
           -e PGUSER=test \
           -e CLIENTS_NO=20 \
           -e TEST_DURATION_S=120 \
           -e SOCKET=192.168.1.100 \
           -e PORT=5432 \
           -e JOBS_NO=4 \
           -e TLOGS=pgbench_result.log \
           your-image-name

测试流程说明

1. 容器启动后，根据环境变量配置执行pgBench测试
2. 测试结果写入TLOGS指定的日志文件
3. 测试完成后，自动输出日志文件内容（包含性能摘要）
4. 容器进入随机休眠状态（60-240秒），便于查看测试结果

结果查看

测试完成后，日志文件内容会自动显示在控制台输出中，包含以下关键性能指标：

• 事务吞吐量（tps）
• 平均事务延迟
• 不同百分位的事务响应时间
• 客户端连接数与并发任务数统计