避坑指南：在Linux/Mac上编译TPC-H工具（tpch-kit）时常见的5个错误及解决方法

2026/6/16 8:32:20

避坑指南：在Linux/Mac上编译TPC-H工具（tpch-kit）时常见的5个错误及解决方法

第一次接触TPC-H基准测试工具时，很多人都会选择从GitHub下载tpch-kit源码自行编译。这本应是个简单的过程，但实际操作中却可能遇到各种"坑"。本文将分享我在多个项目中部署TPC-H测试环境时遇到的典型问题及其解决方案。

1. 头文件配置错误：找不到数据库宏定义

最常见的错误发生在tpcd.h头文件配置环节。这个文件需要根据目标数据库类型进行相应修改，但新手往往会忽略这一点。

错误表现通常是编译时报错：

error: 'GEN_QUERY_PLAN' undeclared

根本原因是Makefile中指定的DATABASE宏与tpcd.h中的定义不匹配。比如你在Makefile中设置了DATABASE=MYSQL，但tpcd.h中却没有对应的MySQL定义块。

解决方法分三步：

打开dbgen/tpcd.h文件
检查是否存在你需要的数据库定义（如MySQL、PostgreSQL等）
如果不存在，添加对应的定义块。例如MySQL的定义应该是：

#ifdef MYSQL #define GEN_QUERY_PLAN "" #define START_TRAN "start transaction" #define END_TRAN "commit" #define SET_OUTPUT "" #define SET_ROWCOUNT "limit %d;\n" #define SET_DBASE "use %s;\n" #endif

注意：不同数据库的事务语法和分页语法差异很大，务必使用正确的定义。

2. Makefile参数配置错误

第二个高频错误源于Makefile的基础配置不当。典型错误包括：

未指定正确的DATABASE类型
MACHINE参数与当前系统不匹配
编译器路径错误

一个正确的Makefile配置示例如下：

CC = gcc DATABASE = MYSQL MACHINE = LINUX WORKLOAD = TPCH

常见问题排查表：

错误现象	可能原因	解决方案
make: gcc: Command not found	编译器未安装	安装gcc：`sudo apt install build-essential`
undefined reference to `pow'	数学库未链接	在Makefile的CFLAGS中添加`-lm`
fatal error: stdio.h: No such file	开发库缺失	安装开发工具包：`sudo apt install libc6-dev`

3. 环境变量DSS_QUERY未设置

成功编译后，运行qgen时可能出现：

./qgen: Cannot find query templates in ./queries/

这是因为qgen需要知道查询模板的存放位置。解决方法很简单：

export DSS_QUERY=/path/to/tpch-kit/dbgen/queries

为了让这个设置永久生效，可以将其加入shell配置文件：

echo 'export DSS_QUERY=/path/to/tpch-kit/dbgen/queries' >> ~/.bashrc source ~/.bashrc

4. 权限问题导致数据生成失败

当使用dbgen生成测试数据时，可能会遇到权限错误：

Could not open .../lineitem.tbl for writing

这是因为默认情况下，dbgen尝试在当前目录生成.tbl文件，但用户可能没有写入权限。有几种解决方案：

使用-f参数强制覆盖（如果文件已存在）
```
./dbgen -f -s 1
```

指定输出目录

mkdir -p /tmp/tpch_data ./dbgen -s 1 -f -b /tmp/tpch_data/

修改目录权限

sudo chown -R $USER /path/to/tpch-kit/dbgen

5. 大规模数据生成时的内存问题

当尝试生成较大规模的数据（如100GB以上）时，可能会遇到内存不足的问题：

Segmentation fault (core dumped)

这是因为默认情况下dbgen会尝试将所有数据缓存在内存中。对于大数据集，可以采用以下优化方案：

使用-S参数分片生成

# 生成10个1GB的分片 for i in {1..10}; do ./dbgen -s 1 -C 10 -S $i -f done

调整系统swap空间

sudo fallocate -l 8G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile

使用更高效的生成方式

# 只生成特定表的数据 ./dbgen -T L -s 100 # 仅生成lineitem表数据

高级技巧：自动化编译脚本

为了避免每次在新环境部署时重复踩坑，我通常会准备一个自动化安装脚本：

#!/bin/bash set -e # 安装依赖 sudo apt update sudo apt install -y git build-essential # 克隆代码 git clone https://github.com/gregrahn/tpch-kit.git cd tpch-kit/dbgen # 配置MySQL支持 sed -i 's/DATABASE =.*/DATABASE = MYSQL/' Makefile sed -i 's/MACHINE =.*/MACHINE = LINUX/' Makefile # 添加MySQL定义到头文件 if ! grep -q "MYSQL" tpcd.h; then cat <<EOF >> tpcd.h #ifdef MYSQL #define GEN_QUERY_PLAN "" #define START_TRAN "start transaction" #define END_TRAN "commit" #define SET_OUTPUT "" #define SET_ROWCOUNT "limit %d;\n" #define SET_DBASE "use %s;\n" #endif EOF fi # 编译 make # 设置环境变量 echo "export DSS_QUERY=$(pwd)/queries" >> ~/.bashrc source ~/.bashrc echo "TPC-H工具编译安装完成！"

这个脚本可以处理大多数Linux系统上的基础安装问题，节省了大量手动配置时间。