materialize/chbenchmark

CH-benCHmark负载生成器Docker镜像文档

镜像概述

CH-benCHmark负载生成器Docker镜像是一个轻量级容器化工具，用于运行CH-benCHmark数据库性能基准测试。该镜像封装了CH-benCHmark工具及其运行依赖，可快速生成标准化的数据库访问负载，支持评估数据库系统在不同压力条件下的吞吐量、响应时间等关键性能指标。

核心功能与特性

• 多数据库兼容：支持主流关系型数据库（如MySQL、PostgreSQL等）的性能测试
• 可定制负载参数：支持配置并发用户数、查询类型（读/写/混合）、数据量大小等负载特征
• 标准化性能指标：自动生成吞吐量（TPS/QPS）、平均响应时间、95%/99%响应时间、错误率等关键指标
• 轻量级部署：基于Docker容器化，无需复杂环境配置，可快速集成到测试流程中
• 灵活场景模拟：支持模拟真实应用的数据库访问模式，包括事务处理、复杂查询等场景

使用场景与适用范围

• 数据库性能基准测试：为新部署的数据库系统建立基础性能指标
• 数据库配置调优：验证不同参数配置（如缓存大小、连接池等）对性能的影响
• 系统升级/迁移验证：比较数据库升级前后或迁移至新环境后的性能变化
• 高并发压力测试：模拟业务峰值场景，测试数据库系统的稳定性与瓶颈
• 多数据库性能对比：在相同硬件环境下对比不同数据库产品的性能表现

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本）
• 目标数据库已部署并可通过网络访问
• 数据库中已创建测试所需的基准数据表（可通过工具自带初始化脚本生成）

快速启动（Docker Run）

bash
docker run -d \
  --name chbenchmark-loadgen \
  -e DB_TYPE=mysql \
  -e DB_HOST=192.168.1.100 \
  -e DB_PORT=3306 \
  -e DB_USER=benchmark_user \
  -e DB_PASSWORD=benchmark_pass \
  -e DB_NAME=chbenchmark \
  -e CONCURRENT_USERS=20 \
  -e TEST_DURATION=600 \
  -e WORKLOAD_TYPE=mixed \
  docker.xuanyuan.run/chbenchmark/load-generator:latest

核心环境变量配置

Docker Compose配置示例

yaml
version: '3.8'

services:
  load-generator:
    image: docker.xuanyuan.run/chbenchmark/load-generator:latest
    container_name: chbenchmark-loadgen
    environment:
      - DB_TYPE=postgresql
      - DB_HOST=postgres-db
      - DB_PORT=5432
      - DB_USER=postgres
      - DB_PASSWORD=postgres
      - DB_NAME=benchmark_db
      - CONCURRENT_USERS=30
      - TEST_DURATION=1200
      - WORKLOAD_TYPE=mixed
      - SCALE_FACTOR=20
    depends_on:
      - postgres-db
    networks:
      - benchmark-net

  postgres-db:
    image: docker.xuanyuan.run/postgres:15-alpine
    container_name: postgres-db
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=benchmark_db
    ports:
      - "5432:5432"
    networks:
      - benchmark-net
    volumes:
      - postgres-data:/var/lib/postgresql/data

networks:
  benchmark-net:
    driver: bridge

volumes:
  postgres-data:

测试结果查看

测试过程中，负载生成器会实时输出性能指标到容器日志，可通过以下命令查看：

bash
docker logs chbenchmark-loadgen -f

测试结束后，会生成汇总报告，包含关键指标如：

• 平均吞吐量（Transactions Per Second, TPS）
• 平均响应时间（毫秒）
• 95%/99%百分位响应时间
• 错误率
• 各类型查询的执行次数与耗时分布

注意事项

• 测试前需确保目标数据库已完成基准数据初始化（可使用CH-benCHmark提供的init-db工具）
• 高并发测试可能会对数据库系统造成压力，建议在非生产环境中进行
• 根据目标数据库性能调整CONCURRENT_USERS和TEST_DURATION参数，避免系统过载
• 不同DB_TYPE可能需要调整数据库特定参数（如MySQL的max_connections、PostgreSQL的shared_buffers等）以获得准确测试结果