--- title: "OceanBase 数据库 TPC-C 测试 - OceanBase 数据库 V4.2.1 | OceanBase 文档中心" description: OceanBase 数据库 TPC-C 测试 什么是 TPC-C TPC-C 是一个对 OLTP（联机交易处理）系统进行测试的规范，使用一个商品销售模型对 OLTP 系统进行测试。详细信息，参考 TPC-C 中文简介 。 说明 为了提升用户体验和易用性，让每一个开发者在使用数据库时都能获得较好的性能，OceanBas… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.2.1 LTS # OceanBase 数据库 TPC-C 测试 更新时间：2026-04-16 00:11:36 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.1/zh-CN/700.reference/1100.performance-test/500.run-the-tpc-c-benchmark-on-oceanbase-database.md) ## 什么是 TPC-C TPC-C 是一个对 OLTP（联机交易处理）系统进行测试的规范，使用一个商品销售模型对 OLTP 系统进行测试。详细信息，参考 [TPC-C 中文简介](https://github.com/domino-succ/tpcc-hbase/wiki/%E4%B8%AD%E6%96%87-TPC-C%E7%AE%80%E4%BB%8B)。 #### 说明 为了提升用户体验和易用性，让每一个开发者在使用数据库时都能获得较好的性能，OceanBase 数据库在 V4.0.0 版本之后，做了大量的优化工作。本性能测试方法仅基于基础参数进行调优，让开发者获得较好的数据库性能体验。 ## 环境准备 - JDK：建议使用 1.8u131 及以上版本。 - JDBC：建议使用 mysql-connector-java-5.1.47 版本，其他版本可能存在语法兼容性问题。 - Ant：建议使用 apache-ant-1.10 及以上版本。 - Benchmark SQL：建议使用 Benchmark SQL 5.0。 - OBClient：详细信息，参考 [OBClient 文档](https://github.com/oceanbase/obclient/blob/master/README.md)。 - OceanBase 数据库：建议单独部署 ODP。详细信息，参考 [快速体验 OceanBase 数据库](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000217958)。 - iops：建议磁盘 iops 在 10000 以上。 - 租户规格： ```sql CREATE RESOURCE UNIT tpcc_unit max_cpu 26, memory_size '70g'; CREATE RESOURCE POOL tpcc_pool unit = 'tpcc_unit', unit_num = 1, zone_list=('zone1','zone2','zone3'); CREATE TENANT tpcc_tenant resource_pool_list=('tpcc_pool'), zone_list('zone1', 'zone2', 'zone3'), primary_zone=RANDOM, locality='F@zone1,F@zone2,F@zone3' set variables ob_compatibility_mode='mysql', ob_tcp_invited_nodes='%'; ``` #### 注意 - 上文的租户规格是基于 [OceanBase TPC-C 性能测试报告](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218147) 中的硬件配置进行配置的，您需根据自身数据库的硬件配置进行动态调整。 - 部署集群时，建议不要使用 `obd cluster autodeploy` 命令，该命令为了保证稳定性，不会最大化资源利用率（例如不会使用所有内存），建议单独对配置文件进行调优，最大化资源利用率。 。 ## 测试方案 1. 本次测试需要用到 4 台机器，Benchmark SQL、ODP 和 OBD 单独部署在一台机器上，作为客户端的压力机器。通过 OBD 部署 OceanBase 集群需要使用 3 台机器，OceanBase 集群规模为 1:1:1。 #### 说明 在 TPC-C 测试中，部署 Benchmark SQL、ODP 和 OBD 的机器有一定的灵活性，根据 OBServer 总核数的不同分为以下三种情况： - 当 OBServer 总核数小于等于 47 核时，该机器仅需要 8 核 64G 即可。 - 当 OBServer 总核数在 48 核和 72 核之间时，该机器需要 16 核 128G。 - 当 OBServer 总核数大于等于 73 核时，该机器需要 32 核 128G。 2. 部署成功后，新建执行 TPC-C 测试的租户及用户（sys 租户是管理集群的内置系统租户，请勿直接使用 sys 租户进行测试）。将租户的 `primary_zone` 设置为 `RANDOM`。`RANDOM` 表示新建表分区的 Leader 随机到这 3 台机器。 ### 测试规格 ```shell warehouses=1000 loadWorkers=40 terminals=600 runMins=5 newOrderWeight=45 paymentWeight=43 orderStatusWeight=4 deliveryWeight=4 stockLevelWeight=4 ``` ## OBD 一键测试 ```bash sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo sudo yum install obtpcc java obd test tpcc obperf --tenant=tpcc_mysql --warehouses 10 --run-mins 1 ``` ### 注意 - obd 运行 tpcc，详细参数介绍请参考 [obd test tpcc](https://www.oceanbase.com/docs/community-obd-cn-10000000000768424)。 - 在本例中，大幅参数使用的是默认参数，在用户场景下，可以根据自己的具体情况做一些参数上的调整。例如，在本例中使用的集群名为 `obperf`，租户名是 `tpcc_mysql`。 - 使用 OBD 进行一键测试时，集群的部署必须是由 OBD 进行安装和部署，否则无法获取集群的信息，将导致无法根据集群的配置进 行性能调优。 - 如果系统租户的密码通过终端登陆并修改，非默认空值，则需要您先在终端中将密码修改为默认值，之后通过 [obd cluster edit-config](https://www.oceanbase.com/docs/community-obd-cn-10000000000768422) 命令在配置文件中为系统租户设置密码，配置项是 `# root_password: # root user password`。在 `obd cluster edit-config` 命令执行结束后，您还需执行 `obd cluster reload` 命令使修改生效。 - 运行 `obd test tpcc` 后，系统会详细列出运行步骤和输出，数据量越大耗时越久。 - `obd test tpcc` 命令会自动完成所有操作，无需其他额外任何操作，包含测试数据的生成、传送、OceanBase 参数优化、加载和测试。当中间环节出错时，您可参考 [obd test tpcc](https://www.oceanbase.com/docs/community-obd-cn-10000000000768424) 进行重试。例如：跳过数据的生成和传送，直接进行加载和测试。 ## 手动进行 TPC-C 测试 ### 安装 Ant 按照以下步骤安装 Ant： 1. 下载 Ant。 ```bash wget "http://archive.apache.org/dist/ant/binaries/apache-ant-1.10.6-bin.zip" ``` 2. 安装 Ant ```bash unzip apache-ant-1.10.6-bin.zip ``` 3. 设置环境变量。 ```bash [admin@obtest004 ~]$ sudo vim /etc/profile #ant export ANT_HOME=xx/apache-ant-1.10.6 export PATH=xx/apache-ant-1.10.6/bin:$PATH [admin@obtest004 ~]$ source /etc/profile ``` 4. 检查是否安装成功。 ```bash [admin@obtest004 ~]$ant -version ``` 如果返回以下信息，则安装成功。 ```sql Apache Ant(TM) version 1.10.6 compiled on May 2 2019 ``` ### 安装 Benchmark SQL 按照以下步骤安装 Benchmark SQL： 1. 下载 Benchmark SQL。 详细信息参考 [Benchmark SQL 下载地址](https://sourceforge.net/projects/benchmarksql/files/latest/download/)。 2. 解压 Benchmark SQL。 ```bash unzip ./benchmarksql-5.0.zip ``` 3. 编译 Benchmark SQL。 进入 Benchmark SQL 解压后的目录，使用 Ant 编译 Benchmark SQL： ```bash [admin@obtest004 ~] $ cd benchmarksql-5.0 [admin@obtest004 benchmarksql-5.0] $ ant ``` ### 适配 Benchmark SQL5 由于 Benchmark SQL5 不支持 OceanBase 数据库的 TPC-C 测试，本节将详细介绍如何通过修改 BenchMarkSQL5 部分源码支持 OceanBase 数据库。 1. 修改 `benchmarksql-5.0/src/client/jTPCC.java` 文件，增加 OceanBase 数据库相关内容。 ```java if (iDB.equals("firebird")) dbType = DB_FIREBIRD; else if (iDB.equals("oracle")) dbType = DB_ORACLE; else if (iDB.equals("postgres")) dbType = DB_POSTGRES; else if (iDB.equals("oceanbase")) //增加 OceanBase 数据库相关内容 dbType = DB_OCEANBASE; else { log.error("unknown database type '" + iDB + "'"); return; } ``` 修改 `benchmarksql-5.0/src/client/jTPCCConfig.java` 文件，增加 OceanBase 数据库类型。 ```java public final static int DB_UNKNOWN = 0, DB_FIREBIRD = 1, DB_ORACLE = 2, DB_POSTGRES = 3, DB_OCEANBASE = 4; ``` 2. 修改 `benchmarksql-5.0/src/client/jTPCCConnection.java` 文件，在 SQL 子查询增加 "AS L" 别名。 ```java default: stmtStockLevelSelectLow = dbConn.prepareStatement( "SELECT count(*) AS low_stock FROM (" + " SELECT s_w_id, s_i_id, s_quantity " + " FROM bmsql_stock " + " WHERE s_w_id = ? AND s_quantity < ? AND s_i_id IN (" + " SELECT ol_i_id " + " FROM bmsql_district " + " JOIN bmsql_order_line ON ol_w_id = d_w_id " + " AND ol_d_id = d_id " + " AND ol_o_id >= d_next_o_id - 20 " + " AND ol_o_id < d_next_o_id " + " WHERE d_w_id = ? AND d_id = ? " + " ) " + " )AS L"); //增加 "AS L" 别名 break; ``` 3. 重新编译修改后的源码。 ```bash [admin@obtest004 ~]# cd benchmarksql-5.0 [admin@obtest004 benchmarksql-5.0]# ant ``` 4. 在 `benchmarksql-5.0/run` 目录下，创建文件 `prop.oceanbase`。 ```java db=oceanbase driver=com.mysql.jdbc.Driver conn=jdbc:mysql://$host_ip:$port/$db_name?rewriteBatchedStatements=true&allowMultiQueries=true&useLocalSessionState=true&useUnicode=true&characterEncoding=utf-8&socketTimeout=30000000 //请填写完整user信息 user=$user@$tenant password=***** warehouses=1000 loadWorkers=40 terminals=600 database=$db_name //To run specified transactions per terminal- runMins must equal zero runTxnsPerTerminal=0 //To run for specified minutes- runTxnsPerTerminal must equal zero runMins=5 //Number of total transactions per minute limitTxnsPerMin=0 //Set to true to run in 4.x compatible mode. Set to false to use the //entire configured database evenly. terminalWarehouseFixed=true //The following five values must add up to 100 //The default percentages of 45, 43, 4, 4 & 4 match the TPC-C spec newOrderWeight=45 paymentWeight=43 orderStatusWeight=4 deliveryWeight=4 stockLevelWeight=4 // Directory name to create for collecting detailed result data. // Comment this out to suppress. resultDirectory=my_result_%tY-%tm-%td_%tH%tM%tS osCollectorScript=./misc/os_collector_linux.py osCollectorInterval=1 //osCollectorSSHAddr=user@dbhost //osCollectorDevices=net_eth0 blk_sda ``` **prop.oceanbase 中的参数说明：** - JDBC 连接串：`conn=jdbc:mysql://x.x.x.x(ip):xx(port)/xxxx(dbname)?rewriteBatchedStatements=true&allowMultiQueries=true&useLocalSessionState=true&useUnicode=true&characterEncoding=utf-8&socketTimeout=3000000` - rewriteBatchedStatements： - 参数非常重要，会严重影响导数据效率，不可以忽略。 - 如果导数据较慢，可以用对应租户登录上去通过 `show full processlist` 检查是否开启。 - new order 事务中也用到了 batch update，因此导数和 benchmark 阶段都需要开启。 - 并发数量（terminals）：600，MySQL 租户配置下并发需要结合具体配置动态调整。 - useLocalSessionState：是否使用 autocommit，read_only 和 transaction isolation 的内部值（JDBC 端的本地值），建议设置为 true，如果设置为 false，则需要发语句到远端请求，增加发送请求频次，影响性能。 - warehouses/loadWorkers 这两项用于设置压测数据量，可以适当调整。 - numTerminals > 0 && numTerminals <= 10*numWarehouses，terminals 的范围需要在这个区间内。 5. 修改文件：`benchmarksql-5.0/run/funcs.sh`，添加 OceanBase 数据库类型。 ```shell function setCP() { case "$(getProp db)" in firebird) cp="../lib/firebird/*:../lib/*" ;; oracle) cp="../lib/oracle/*" if [ ! -z "${ORACLE_HOME}" -a -d ${ORACLE_HOME}/lib ] ; then cp="${cp}:${ORACLE_HOME}/lib/*" fi cp="${cp}:../lib/*" ;; postgres) cp="../lib/postgres/*:../lib/*" ;; oceanbase) #添加 OceanBase 数据库类型 cp="../lib/oceanbase/*:../lib/*" ;; esac myCP=".:${cp}:../dist/*" export myCP } ...省略 case "$(getProp db)" in firebird|oracle|postgres|oceanbase) #添加 OceanBase 数据库类型 ;; "") echo "ERROR: missing db= config option in ${PROPS}" >&2 exit 1 ;; *) echo "ERROR: unsupported database type 'db=$(getProp db)' in ${PROPS}" >&2 exit 1 ;; esac ``` 6. 添加 mysql java connector 驱动，推荐 mysql-connector-java-5.1.47.jar。 ```bash [admin@obtest004 benchmarksql-5.0]# mkdir lib/oceanbase/ [admin@obtest004 benchmarksql-5.0]# cp xx/mysql-connector-java-5.1.47.jar lib/oceanbase/ ``` 7. 修改 `benchmarksql-5.0/run/runDatabaseBuild.sh`。 ```shell AFTER_LOAD="indexCreates foreignKeys extraHistID buildFinish" # 修改为： AFTER_LOAD="indexCreates buildFinish" ``` 8. 改造 BenchMarkSQL5 中的 SQL。 备份并重写 `benchmarksql-5.0/run/sql.common/tableCreates.sql`。 ```sql CREATE TABLE bmsql_config ( cfg_name varchar(30) PRIMARY KEY, cfg_value varchar(50) ); CREATE TABLEGROUP IF NOT EXISTS tpcc_group binding true partition by hash partitions 96; CREATE TABLE bmsql_warehouse ( w_id integer not null, w_ytd decimal(12,2), w_tax decimal(4,4), w_name varchar(10), w_street_1 varchar(20), w_street_2 varchar(20), w_city varchar(20), w_state char(2), w_zip char(9), PRIMARY KEY(w_id) )tablegroup='tpcc_group' partition by hash(w_id) partitions 96; CREATE TABLE bmsql_district ( d_w_id integer not null, d_id integer not null, d_ytd decimal(12,2), d_tax decimal(4,4), d_next_o_id integer, d_name varchar(10), d_street_1 varchar(20), d_street_2 varchar(20), d_city varchar(20), d_state char(2), d_zip char(9), PRIMARY KEY (d_w_id, d_id) )tablegroup='tpcc_group' partition by hash(d_w_id) partitions 96; CREATE TABLE bmsql_customer ( c_w_id integer not null, c_d_id integer not null, c_id integer not null, c_discount decimal(4,4), c_credit char(2), c_last varchar(16), c_first varchar(16), c_credit_lim decimal(12,2), c_balance decimal(12,2), c_ytd_payment decimal(12,2), c_payment_cnt integer, c_delivery_cnt integer, c_street_1 varchar(20), c_street_2 varchar(20), c_city varchar(20), c_state char(2), c_zip char(9), c_phone char(16), c_since timestamp, c_middle char(2), c_data varchar(500), PRIMARY KEY (c_w_id, c_d_id, c_id) )tablegroup='tpcc_group' partition by hash(c_w_id) partitions 96; CREATE TABLE bmsql_history ( hist_id integer AUTO_INCREMENT, h_c_id integer, h_c_d_id integer, h_c_w_id integer, h_d_id integer, h_w_id integer, h_date timestamp, h_amount decimal(6,2), h_data varchar(24) )tablegroup='tpcc_group' partition by hash(h_w_id) partitions 96; CREATE TABLE bmsql_new_order ( no_w_id integer not null , no_d_id integer not null, no_o_id integer not null, PRIMARY KEY (no_w_id, no_d_id, no_o_id) )tablegroup='tpcc_group' partition by hash(no_w_id) partitions 96; CREATE TABLE bmsql_oorder ( o_w_id integer not null, o_d_id integer not null, o_id integer not null, o_c_id integer, o_carrier_id integer, o_ol_cnt integer, o_all_local integer, o_entry_d timestamp, PRIMARY KEY (o_w_id, o_d_id, o_id) )tablegroup='tpcc_group' partition by hash(o_w_id) partitions 96; CREATE TABLE bmsql_order_line ( ol_w_id integer not null, ol_d_id integer not null, ol_o_id integer not null, ol_number integer not null, ol_i_id integer not null, ol_delivery_d timestamp, ol_amount decimal(6,2), ol_supply_w_id integer, ol_quantity integer, ol_dist_info char(24), PRIMARY KEY (ol_w_id, ol_d_id, ol_o_id, ol_number) )tablegroup='tpcc_group' partition by hash(ol_w_id) partitions 96; CREATE TABLE bmsql_item ( i_id integer not null, i_name varchar(24), i_price decimal(5,2), i_data varchar(50), i_im_id integer, PRIMARY KEY (i_id) ); CREATE TABLE bmsql_stock ( s_w_id integer not null, s_i_id integer not null, s_quantity integer, s_ytd integer, s_order_cnt integer, s_remote_cnt integer, s_data varchar(50), s_dist_01 char(24), s_dist_02 char(24), s_dist_03 char(24), s_dist_04 char(24), s_dist_05 char(24), s_dist_06 char(24), s_dist_07 char(24), s_dist_08 char(24), s_dist_09 char(24), s_dist_10 char(24), PRIMARY KEY (s_w_id, s_i_id) )tablegroup='tpcc_group' partition by hash(s_w_id) partitions 96; ``` 备份并重写 `benchmarksql-5.0/run/sql.common/tableDrops.sql`。 ```sql DROP TABLE bmsql_config; DROP TABLE bmsql_new_order; DROP TABLE bmsql_order_line; DROP TABLE bmsql_oorder; DROP TABLE bmsql_history; DROP TABLE bmsql_customer; DROP TABLE bmsql_stock; DROP TABLE bmsql_item; DROP TABLE bmsql_district; DROP TABLE bmsql_warehouse; DROP TABLEGROUP tpcc_group; ``` 备份并重写 `benchmarksql-5.0/run/sql.common/indexCreates.sql`。 ```sql CREATE INDEX bmsql_customer_idx1 ON bmsql_customer (c_w_id, c_d_id, c_last, c_first) local; CREATE INDEX bmsql_oorder_idx1 ON bmsql_oorder (o_w_id, o_d_id, o_carrier_id, o_id) local; ``` 备份并重写 `benchmarksql-5.0/run/sql.common/indexDrops.sql`。 ```sql ALTER TABLE bmsql_customer DROP INDEX bmsql_customer_idx1; ALTER TABLE bmsql_oorder DROP INDEX bmsql_oorder_idx1; ``` ### 环境调优 1. ODP 调优，请在 sys 租户下执行。 执行 `obclient -h$host_ip -P$host_port -uroot@sys -A` 命令进入系统租户。 ```sql ALTER PROXYCONFIG SET proxy_mem_limited='4G'; ALTER PROXYCONFIG SET enable_compression_protocol=false; ``` 2. observer 调优，请在 sys 租户下执行 ```sql ALTER SYSTEM SET enable_sql_audit=false; select sleep(5); ALTER SYSTEM SET enable_perf_event=false; ALTER SYSTEM SET syslog_level='PERF'; ALTER SYSTEM SET enable_record_trace_log=false; ``` 3. 调优参数设置完毕后请执行 `obd cluster restart $cluster_name` 命令重启集群。 ### 操作步骤 以下命令均在 `benchmarksql-5.0/run` 目录下执行。按照以下步骤进行 TPC-C 测试： 1. 运行以下命令，初始化环境： ```bash ./runDatabaseDestroy.sh prop.oceanbase ``` 2. 运行以下命令，创建表并导入数据： ```bash ./runDatabaseBuild.sh prop.oceanbase ``` 3. 执行合并（需要使用 sys 租户登录） Major 合并将当前大版本的 SSTable 和 MemTable 与前一个大版本的全量静态数据进行合并，使存储层统计信息更准确，生成的执行计划更稳定。 ```sql MySQL [(none)]> USE oceanbase Database changed MySQL [oceanbase]> ALTER SYSTEM MAJOR FREEZE TENANT=; Query OK, 0 rows affected ``` 4. 查看合并是否完成 ```sql MySQL [oceanbase]> SELECT FROZEN_SCN, LAST_SCN FROM oceanbase.CDB_OB_MAJOR_COMPACTION; +---------------------+---------------------+ | FROZEN_SCN | LAST_SCN | +---------------------+---------------------+ | 1667239201167716767 | 1667239201167716767 | | 1667239200111919300 | 1667239200111919300 | | 1667239201167452168 | 1667239201167452168 | | 1667239201168053124 | 1667239201168053124 | | 1667239201167520213 | 1667239201167520213 | +---------------------+---------------------+ ``` 所有的 `FROZEN_SCN` 和 `LAST_SCN` 的值相等即表示合并完成。 5. 手动收集统计信息 执行 `obclient -h$host_ip -P$host_port -u$user@$tenant -p$password -A -D$database` 命令进入测试租户。 ```sql call dbms_stats.gather_schema_stats('$db_name',degree=>96); ``` 6. 运行以下命令，执行压力测试： ```bash ./runBenchmark.sh prop.oceanbase ``` #### 说明 测试结果可参考[OceanBase TPC-C 性能测试报告](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218147)。 ## FAQ - 如何停止 Benchmark SQL 工具。 到期自动停止：依赖 prop.oceanbase 中 runMins 设置的值。 强行停止：`ps auxf | grep java --` 删除 Java 程删除 runBenchmark 进程。 - 找不到 main 类型。报错信息如下： ```bash Could not find the main class: ExecJDBC. Program will exit. ``` 可能原因有两个：要么升级 JDK，要么升级 JDBC 版本。运行以下命令安装 Java： ```sql sudo yum install jdk ``` - 终端数量无效。报错信息如下： ```bash Invalid number of terminals! ``` 这是 prop.oceanbase 中设置的 terminals 值不对，需填写 `numTerminals > 0 && numTerminals <= 10 * numWarehouses` 范围内的 terminals 值。 - 事务超时。报错信息如下： ```bash transaction timeout ``` 需增大超时时间，测试租户下执行 `set global ob_query_timeout=36000000000;set global ob_trx_timeout=36000000000`。 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线