GrainDB

Requirements

GrainDB requires CMake to be installed and a C++11 compliant compiler (GCC 4.9 and newer, Clang 3.9 and newer).

Compiling

Run make in the root directory to compile the sources.

Experiments

Datasets

• JOB: third_party/imdb/data/
• LDBC10: third_party/ldbc/data/sf10/
• LDBC30: third_party/ldbc/data/sf30/

End-To-End Benchmarks

JOB: Relational Workload with Selective Many-to-Many Joins (8.2.1)

Run evaluations of DuckDB and GRainDB on JOB:

> ./build/release/benchmark/benchmark_runner "IMDB_113_Q[0-9][0-9][0-9]" --out=evaluations/job_duckdb.out
> ./build/release/benchmark/benchmark_runner "IMDB_113_Q[0-9][0-9][0-9]A" --out=evaluations/job_graindb.out

Processing of query evaluation results:

> python3 scripts/extract_query_latency.py evaluations/job_duckdb.out evaluations/job_duckdb_avg.out
> python3 scripts/extract_query_latency.py evaluations/job_graindb.out evaluations/job_graindb_avg.out

SNB-M: Graph Workload with Selective Many-to-Many Joins (8.2.2 & 8.2.3)

Run evaluations of DuckDB, DuckDB-MV and GRainDB on SNB-M:

> ./build/release/benchmark/benchmark_runner "LDBC_LIGHT_OPTIMIZED_Q[0-9][0-9][0-9]" --out=evaluations/snb_duckdb.out
> ./build/release/benchmark/benchmark_runner "LDBC_LIGHT_VIEWS_.*" --out=evaluations/duckdb_mv.out
> ./build/release/benchmark/benchmark_runner "LDBC_LIGHT_OPTIMIZED_Q[0-9][0-9][0-9]A" --out=evaluations/snb_graindb.out

Processing of query evaluation results:

> python3 scripts/extract_query_latency.py evaluations/job_duckdb.out evaluations/job_duckdb_avg.out
> python3 scripts/extract_query_latency.py evaluations/duckdb_mv.out evaluations/duckdb_mv_avg.out
> python3 scripts/extract_query_latency.py evaluations/job_graindb.out evaluations/job_graindb_avg.out

TPC-H: Traditional OLAP Workloads (8.2.4)

Run TPC-H evaluations on DuckDB and GRainDB:

> ./build/release/benchmark/benchmark_runner "TPCH_OPTIMIZED_Q[0-9][0-9]" --out=evaluations/tpch_duckdb.out
> ./build/release/benchmark/benchmark_runner "TPCH_OPTIMIZED_Q[0-9][0-9]A" --out=evaluations/tpch_graindb.out

Processing of query evaluation results:

> python3 scripts/extract_query_latency.py evaluations/tpch_duckdb.out evaluations/tpch_duckdb_avg.out
> python3 scripts/extract_query_latency.py evaluations/tpch_graindb.out evaluations/tpch_graindb_avg.out

Detailed Evaluation

Ablation Study (8.3.1)

Configurations for GRainDB:

• GR-FULL. Set both ENABLE_RAI_JOIN_MERGE and ENABLE_ALISTS to true.
• GR-JM. Set ENABLE_RAI_JOIN_MERGE to false, and keep ENABLE_ALISTS to true.
• GR-JM-RSJ. Set both ENABLE_RAI_JOIN_MERGE and ENABLE_ALISTS to false.

Under each configuration, re-compile the codebase, and run the following command to get GRainDB evaluation result on SNB-M under that configuration:

> ./build/release/benchmark/benchmark_runner "LDBC_LIGHT_OPTIMIZED_Q[0-9][0-9][0-9]A" --out=evaluations/snb_graindb_configuration_x.out

Performance of Predefined Joins Under Varying Entity vs Relationship Table Selectivity (8.3.2)

• DuckDB and GRainDB

> ./build/release/benchmark/benchmark_runner "LDBC_MICROP_Q0[0-9][0-9]" --out=evaluations/micro_p_duckdb.out
> ./build/release/benchmark/benchmark_runner "LDBC_MICROP_Q0[0-9][0-9]A" --out=evaluations/micro_p_graindb.out
> ./build/release/benchmark/benchmark_runner "LDBC_MICROK_Q0[0-9][0-9]A" --out=evaluations/micro_k_graindb.out
> ./build/release/benchmark/benchmark_runner "LDBC_MICROK_Q0[0-9][0-9]A" --out=evaluations/micro_k_graindb.out

Plan Spectrum Analyses (8.3.3)

spectrum_runner <JOS_INPUT_DIR> <QUERY_ID> <START_JOS_ID> <END_JOS_ID (not included)>

> ./build/release/examples/spectrum_runner/spectrum_runner spectrum_jos/Q01/ 1 1 225 > spectrum_q1a.out
> ./build/release/examples/spectrum_runner/spectrum_runner spectrum_jos/Q02/ 5 1 225 > spectrum_q2a.out
> ./build/release/examples/spectrum_runner/spectrum_runner spectrum_jos/Q03/ 9 1 41 > spectrum_q3a.out
> ./build/release/examples/spectrum_runner/spectrum_runner spectrum_jos/Q04/ 12 1 225 > spectrum_q4a.out
> ./build/release/examples/spectrum_runner/spectrum_runner spectrum_jos/Q05/ 15 1 225 > spectrum_q5a.out
> ./build/release/examples/spectrum_runner/spectrum_runner spectrum_jos/Q06/ 18 1 225 > spectrum_q6a.out