#apache-arrow #parquet #data-fusion #data-set #spark #tpc-ds #tpc-h

bin+lib tpctools

Utilities for generating and converting TPC-H and TPC-DS data sets

11 unstable releases (5 breaking)

0.7.0 Mar 3, 2024
0.6.0 Sep 27, 2023
0.5.0 Apr 30, 2023
0.4.0 Feb 3, 2023
0.1.1 May 24, 2021

#106 in Profiling

Download history 28/week @ 2024-07-27 18/week @ 2024-09-21 4/week @ 2024-09-28

243 downloads per month

Apache-2.0

60KB
1K SLoC

TPC Tools

Command-line tools for invoking TPC-H and TPC-DS data generators in parallel and re-organizing the output files into directory structures that can be consumed by tools such as Apache Spark or Apache Arrow DataFusion/Ballista.

Also supports converting the output to Parquet.

TPC-DS

Install dependencies.

sudo apt install gcc make flex bison byacc git

Download data generator from https://www.tpc.org/tpc_documents_current_versions/current_specifications5.asp

cd /path/to/DSGen-software-code-3.2.0rc1/tools
make

Generate data.

mkdir /tmp/tpcds/sf1000

cargo run --release -- generate --benchmark tpcds \
  --scale 1000 \
  --partitions 48 \
  --generator-path /path/to/DSGen-software-code-3.2.0rc1/tools \
  --output /tmp/tpcds/sf1000/

Example output.

Generated TPC-DS data at scale factor 1000 with 48 partitions in: 6247.155671938s

Convert to Parquet

mkdir /tmp/tpcds/sf1000-parquet

cargo run --release -- convert --benchmark tpcds \
  --input /tmp/tpcds/sf1000/
  --output /tmp/tpcds/sf1000-parquet/

TPC-H

Install dependencies.

git clone git@github.com:databricks/tpch-dbgen.git
cd tpch-dbgen
make
cd ..

Generate data.

mkdir /tmp/tpch

cargo run --release -- generate --benchmark tpch \
  --scale 1 \
  --partitions 2 \
  --generator-path ./tpch-dbgen/ \
  --output /tmp/tpch

Convert data to Parquet

mkdir /tmp/tpch-parquet

cargo run --release -- convert \
  --benchmark tpch \
  --input /tmp/tpch/ \
  --output /tmp/tpch-parquet/

Legal Stuff

TPC-H is Copyright © 1993-2022 Transaction Processing Performance Council. The full TPC-H specification in PDF format can be found here

TPC-DS is Copyright © 2021 Transaction Processing Performance Council. The full TPC-DS specification in PDF format can be found here

TPC, TPC Benchmark, TPC-H, and TPC-DS are trademarks of the Transaction Processing Performance Council.

Dependencies

~63MB
~1M SLoC