hugegraph · imbajin · Jul 21, 2026 · Mar 15, 2026 · Mar 15, 2026 · Mar 15, 2026
diff --git a/.github/scripts/bench_logs_to_pages.py b/.github/scripts/bench_logs_to_pages.py
diff --git a/.github/scripts/build_upstream_rocksdb.sh b/.github/scripts/build_upstream_rocksdb.sh
@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+# Build upstream facebook/rocksdb db_bench + memtablerep_bench into a staging prefix.
+# Usage: build_upstream_rocksdb.sh <git-ref> <dest-dir> [extra env assignments...]
+# Example: build_upstream_rocksdb.sh v8.10.2 "$BUNDLE/rocksdb-v8.10"
+#          build_upstream_rocksdb.sh main "$BUNDLE/rocksdb-master"
+set -euo pipefail
+
+REF="${1:?git ref required (tag/branch/sha)}"
+DEST="${2:?destination directory required}"
+shift 2 || true
+
+SRC_DIR="${RUNNER_TEMP:-/tmp}/rocksdb-src-${REF//\//_}"
+rm -rf "$SRC_DIR" "$DEST"
+mkdir -p "$SRC_DIR" "$DEST/bin" "$DEST/lib"
+
+echo "Cloning facebook/rocksdb @ ${REF} -> ${SRC_DIR}"
+if [[ "$REF" == "master" || "$REF" == "latest" ]]; then
+  # Upstream default branch is main; keep "master"/"latest" as aliases.
+  if ! git clone --depth 1 --branch main https://github.com/facebook/rocksdb.git "$SRC_DIR"; then
+    git clone --depth 1 --branch master https://github.com/facebook/rocksdb.git "$SRC_DIR"
+  fi
+else
+  git clone --depth 1 --branch "$REF" https://github.com/facebook/rocksdb.git "$SRC_DIR"
+fi
+
+
+# Allow caller to inject CC/CXX/CPU/EXTRA_* via environment
+export DEBUG_LEVEL="${DEBUG_LEVEL:-0}"
+cd "$SRC_DIR"
+make db_bench memtablerep_bench -j"$(nproc)" DEBUG_LEVEL="$DEBUG_LEVEL"
+
+test -x "$SRC_DIR/db_bench"
+test -x "$SRC_DIR/memtablerep_bench"
+cp -a "$SRC_DIR/db_bench" "$SRC_DIR/memtablerep_bench" "$DEST/bin/"
+
+# Shared libs if present (static-linked benches may have none)
+shopt -s nullglob
+for f in "$SRC_DIR"/librocksdb.so*; do
+  cp -a "$f" "$DEST/lib/"
+done
+shopt -u nullglob
+
+SHA="$(git -C "$SRC_DIR" rev-parse HEAD)"
+python3 - <<PY
+import json
+from pathlib import Path
+meta = {
+    "engine": "rocksdb",
+    "ref": "${REF}",
+    "git_sha": "${SHA}",
+}
+Path("${DEST}/engine-meta.json").write_text(json.dumps(meta, indent=2) + "\n", encoding="utf-8")
+PY
+
+echo "Staged upstream rocksdb ${REF} (${SHA}) -> ${DEST}"
+ldd "$DEST/bin/db_bench" || true
+
+# Drop clone + object tree; only DEST (bins/libs) is needed for the artifact.
+rm -rf "$SRC_DIR"
diff --git a/.github/testdata/db_bench.sample.log b/.github/testdata/db_bench.sample.log
@@ -0,0 +1,5 @@
+fillseq      :     1.234567 micros/op 810000 ops/sec 61.728 seconds 50000000 operations;    6.1 MB/s
+compact      :   123.456789 micros/op   8100 ops/sec 12.345 seconds   100000 operations;
+nextwithkey  :     0.250000 micros/op 4000000 ops/sec 12.500 seconds 50000000 operations;
+readseq      :     0.180000 micros/op 5555555 ops/sec 9.000 seconds 50000000 operations;
+readrandom   :     0.900000 micros/op 1111111 ops/sec 45.000 seconds 50000000 operations;
diff --git a/.github/testdata/memtablerep_bench-cspp.sample.log b/.github/testdata/memtablerep_bench-cspp.sample.log
@@ -0,0 +1,21 @@
+Running fillrandom
+Number of threads: 1
+Elapsed time: 987654 us
+Total bytes written: 1024.0 MiB
+Write throughput: 1036.0 MiB/s
+write us/op: 9.876
+Running readrandom
+Number of threads: 1
+Elapsed time: 876543 us
+Total bytes read: 512.0 MiB
+Read throughput: 584.0 MiB/s
+read us/op: 8.765
+Running readwrite
+Number of threads: 1
+Elapsed time: 765432 us
+Total bytes written: 256.0 MiB
+Write throughput: 334.0 MiB/s
+write us/op: 7.654
+Total bytes read: 128.0 MiB
+Read throughput: 167.0 MiB/s
+read us/op: 6.543
diff --git a/.github/testdata/memtablerep_bench-skiplist.sample.log b/.github/testdata/memtablerep_bench-skiplist.sample.log
@@ -0,0 +1,21 @@
+Running fillrandom
+Number of threads: 1
+Elapsed time: 1234567 us
+Total bytes written: 1024.0 MiB
+Write throughput: 829.0 MiB/s
+write us/op: 12.345
+Running readrandom
+Number of threads: 1
+Elapsed time: 2345678 us
+Total bytes read: 512.0 MiB
+Read throughput: 218.0 MiB/s
+read us/op: 23.456
+Running readwrite
+Number of threads: 1
+Elapsed time: 3456789 us
+Total bytes written: 256.0 MiB
+Write throughput: 74.0 MiB/s
+write us/op: 34.567
+Total bytes read: 128.0 MiB
+Read throughput: 37.0 MiB/s
+read us/op: 45.678
diff --git a/.github/testdata/rocksdb-master/db_bench-fillrandom.log b/.github/testdata/rocksdb-master/db_bench-fillrandom.log
@@ -0,0 +1,4 @@
+fillrandom   :     2.000000 micros/op 500000 ops/sec 100.000 seconds 50000000 operations;    5.0 MB/s
+compact      :   100.000000 micros/op  10000 ops/sec 10.000 seconds   100000 operations;
+readseq      :     0.200000 micros/op 5000000 ops/sec 10.000 seconds 50000000 operations;
+readrandom   :     1.000000 micros/op 1000000 ops/sec 50.000 seconds 50000000 operations;
diff --git a/.github/testdata/rocksdb-master/db_bench.log b/.github/testdata/rocksdb-master/db_bench.log
@@ -0,0 +1,4 @@
+fillseq      :     1.800000 micros/op 555555 ops/sec 90.000 seconds 50000000 operations;    4.2 MB/s
+compact      :   180.000000 micros/op   5555 ops/sec 18.000 seconds   100000 operations;
+readseq      :     0.280000 micros/op 3571428 ops/sec 14.000 seconds 50000000 operations;
+readrandom   :     1.400000 micros/op  714285 ops/sec 70.000 seconds 50000000 operations;
diff --git a/.github/testdata/rocksdb-master/memtablerep_bench-skiplist.log b/.github/testdata/rocksdb-master/memtablerep_bench-skiplist.log
@@ -0,0 +1,21 @@
+Running fillrandom
+Number of threads: 1
+Elapsed time: 1234567 us
+Total bytes written: 1024.0 MiB
+Write throughput: 829.0 MiB/s
+write us/op: 12.345
+Running readrandom
+Number of threads: 1
+Elapsed time: 2345678 us
+Total bytes read: 512.0 MiB
+Read throughput: 218.0 MiB/s
+read us/op: 23.456
+Running readwrite
+Number of threads: 1
+Elapsed time: 3456789 us
+Total bytes written: 256.0 MiB
+Write throughput: 74.0 MiB/s
+write us/op: 34.567
+Total bytes read: 128.0 MiB
+Read throughput: 37.0 MiB/s
+read us/op: 45.678
diff --git a/.github/testdata/rocksdb-master/shm_usage-fillrandom.txt b/.github/testdata/rocksdb-master/shm_usage-fillrandom.txt
@@ -0,0 +1,2 @@
+apparent_bytes=1476395008
+allocated_bytes=1493172224
diff --git a/.github/testdata/rocksdb-master/shm_usage-fillseq.txt b/.github/testdata/rocksdb-master/shm_usage-fillseq.txt
@@ -0,0 +1,2 @@
+apparent_bytes=1181116006
+allocated_bytes=1195376640
diff --git a/.github/testdata/rocksdb-master/shm_usage.txt b/.github/testdata/rocksdb-master/shm_usage.txt
@@ -0,0 +1,2 @@
+apparent_bytes=1181116006
+allocated_bytes=1195376640
diff --git a/.github/testdata/rocksdb-v8.10/db_bench-fillrandom.log b/.github/testdata/rocksdb-v8.10/db_bench-fillrandom.log
@@ -0,0 +1,4 @@
+fillrandom   :     2.000000 micros/op 500000 ops/sec 100.000 seconds 50000000 operations;    5.0 MB/s
+compact      :   100.000000 micros/op  10000 ops/sec 10.000 seconds   100000 operations;
+readseq      :     0.200000 micros/op 5000000 ops/sec 10.000 seconds 50000000 operations;
+readrandom   :     1.000000 micros/op 1000000 ops/sec 50.000 seconds 50000000 operations;
diff --git a/.github/testdata/rocksdb-v8.10/db_bench.log b/.github/testdata/rocksdb-v8.10/db_bench.log
@@ -0,0 +1,4 @@
+fillseq      :     2.000000 micros/op 500000 ops/sec 100.000 seconds 50000000 operations;    3.8 MB/s
+compact      :   200.000000 micros/op   5000 ops/sec 20.000 seconds   100000 operations;
+readseq      :     0.300000 micros/op 3333333 ops/sec 15.000 seconds 50000000 operations;
+readrandom   :     1.500000 micros/op  666666 ops/sec 75.000 seconds 50000000 operations;
diff --git a/.github/testdata/rocksdb-v8.10/memtablerep_bench-skiplist.log b/.github/testdata/rocksdb-v8.10/memtablerep_bench-skiplist.log
@@ -0,0 +1,21 @@
+Running fillrandom
+Number of threads: 1
+Elapsed time: 1234567 us
+Total bytes written: 1024.0 MiB
+Write throughput: 829.0 MiB/s
+write us/op: 12.345
+Running readrandom
+Number of threads: 1
+Elapsed time: 2345678 us
+Total bytes read: 512.0 MiB
+Read throughput: 218.0 MiB/s
+read us/op: 23.456
+Running readwrite
+Number of threads: 1
+Elapsed time: 3456789 us
+Total bytes written: 256.0 MiB
+Write throughput: 74.0 MiB/s
+write us/op: 34.567
+Total bytes read: 128.0 MiB
+Read throughput: 37.0 MiB/s
+read us/op: 45.678
diff --git a/.github/testdata/rocksdb-v8.10/shm_usage-fillrandom.txt b/.github/testdata/rocksdb-v8.10/shm_usage-fillrandom.txt
@@ -0,0 +1,2 @@
+apparent_bytes=1509949440
+allocated_bytes=1526726656
diff --git a/.github/testdata/rocksdb-v8.10/shm_usage-fillseq.txt b/.github/testdata/rocksdb-v8.10/shm_usage-fillseq.txt
@@ -0,0 +1,2 @@
+apparent_bytes=1207959552
+allocated_bytes=1224736768
diff --git a/.github/testdata/rocksdb-v8.10/shm_usage.txt b/.github/testdata/rocksdb-v8.10/shm_usage.txt
@@ -0,0 +1,2 @@
+apparent_bytes=1207959552
+allocated_bytes=1224736768
diff --git a/.github/testdata/topling-dictzip10/db_bench-fillrandom-omit.log b/.github/testdata/topling-dictzip10/db_bench-fillrandom-omit.log
@@ -0,0 +1,6 @@
+nextwithkey  :     0.100000 micros/op 10000000 ops/sec 5.000 seconds 50000000 operations;
+nextwithkey  :     0.095000 micros/op 10526315 ops/sec 4.750 seconds 50000000 operations;
+nextwithkey  :     0.090000 micros/op 11111111 ops/sec 4.500 seconds 50000000 operations;
+readseq      :     0.050000 micros/op 20000000 ops/sec 2.500 seconds 50000000 operations;
+readseq      :     0.048000 micros/op 20833333 ops/sec 2.400 seconds 50000000 operations;
+readseq      :     0.045000 micros/op 22222222 ops/sec 2.250 seconds 50000000 operations;
diff --git a/.github/testdata/topling-dictzip10/db_bench-fillrandom.log b/.github/testdata/topling-dictzip10/db_bench-fillrandom.log
@@ -0,0 +1,4 @@
+fillrandom   :     2.000000 micros/op 500000 ops/sec 100.000 seconds 50000000 operations;    5.0 MB/s
+compact      :   100.000000 micros/op  10000 ops/sec 10.000 seconds   100000 operations;
+readseq      :     0.200000 micros/op 5000000 ops/sec 10.000 seconds 50000000 operations;
+readrandom   :     1.000000 micros/op 1000000 ops/sec 50.000 seconds 50000000 operations;
diff --git a/.github/testdata/topling-dictzip10/db_bench-fillseq-omit.log b/.github/testdata/topling-dictzip10/db_bench-fillseq-omit.log
@@ -0,0 +1,6 @@
+nextwithkey  :     0.110000 micros/op 9090909 ops/sec 5.500 seconds 50000000 operations;
+nextwithkey  :     0.105000 micros/op 9523809 ops/sec 5.250 seconds 50000000 operations;
+nextwithkey  :     0.100000 micros/op 10000000 ops/sec 5.000 seconds 50000000 operations;
+readseq      :     0.055000 micros/op 18181818 ops/sec 2.750 seconds 50000000 operations;
+readseq      :     0.052000 micros/op 19230769 ops/sec 2.600 seconds 50000000 operations;
+readseq      :     0.050000 micros/op 20000000 ops/sec 2.500 seconds 50000000 operations;
diff --git a/.github/testdata/topling-dictzip10/db_bench.log b/.github/testdata/topling-dictzip10/db_bench.log
@@ -0,0 +1,4 @@
+fillseq      :     1.234567 micros/op 810000 ops/sec 61.728 seconds 50000000 operations;    6.1 MB/s
+compact      :   123.456789 micros/op   8100 ops/sec 12.345 seconds   100000 operations;
+readseq      :     0.180000 micros/op 5555555 ops/sec 9.000 seconds 50000000 operations;
+readrandom   :     0.900000 micros/op 1111111 ops/sec 45.000 seconds 50000000 operations;
diff --git a/.github/testdata/topling-dictzip10/shm_usage-fillrandom.txt b/.github/testdata/topling-dictzip10/shm_usage-fillrandom.txt
@@ -0,0 +1,2 @@
+apparent_bytes=534773760
+allocated_bytes=545259520
diff --git a/.github/testdata/topling-dictzip10/shm_usage-fillseq.txt b/.github/testdata/topling-dictzip10/shm_usage-fillseq.txt
@@ -0,0 +1,2 @@
+apparent_bytes=445644800
+allocated_bytes=452984832
diff --git a/.github/testdata/topling/db_bench-fillrandom-omit.log b/.github/testdata/topling/db_bench-fillrandom-omit.log
@@ -0,0 +1,6 @@
+nextwithkey  :     0.100000 micros/op 10000000 ops/sec 5.000 seconds 50000000 operations;
+nextwithkey  :     0.095000 micros/op 10526315 ops/sec 4.750 seconds 50000000 operations;
+nextwithkey  :     0.090000 micros/op 11111111 ops/sec 4.500 seconds 50000000 operations;
+readseq      :     0.050000 micros/op 20000000 ops/sec 2.500 seconds 50000000 operations;
+readseq      :     0.048000 micros/op 20833333 ops/sec 2.400 seconds 50000000 operations;
+readseq      :     0.045000 micros/op 22222222 ops/sec 2.250 seconds 50000000 operations;
diff --git a/.github/testdata/topling/db_bench-fillrandom.log b/.github/testdata/topling/db_bench-fillrandom.log
@@ -0,0 +1,4 @@
+fillrandom   :     2.000000 micros/op 500000 ops/sec 100.000 seconds 50000000 operations;    5.0 MB/s
+compact      :   100.000000 micros/op  10000 ops/sec 10.000 seconds   100000 operations;
+readseq      :     0.200000 micros/op 5000000 ops/sec 10.000 seconds 50000000 operations;
+readrandom   :     1.000000 micros/op 1000000 ops/sec 50.000 seconds 50000000 operations;
diff --git a/.github/testdata/topling/db_bench-fillseq-omit.log b/.github/testdata/topling/db_bench-fillseq-omit.log
@@ -0,0 +1,6 @@
+nextwithkey  :     0.110000 micros/op 9090909 ops/sec 5.500 seconds 50000000 operations;
+nextwithkey  :     0.105000 micros/op 9523809 ops/sec 5.250 seconds 50000000 operations;
+nextwithkey  :     0.100000 micros/op 10000000 ops/sec 5.000 seconds 50000000 operations;
+readseq      :     0.055000 micros/op 18181818 ops/sec 2.750 seconds 50000000 operations;
+readseq      :     0.052000 micros/op 19230769 ops/sec 2.600 seconds 50000000 operations;
+readseq      :     0.050000 micros/op 20000000 ops/sec 2.500 seconds 50000000 operations;
diff --git a/.github/testdata/topling/db_bench.log b/.github/testdata/topling/db_bench.log
@@ -0,0 +1,4 @@
+fillseq      :     1.234567 micros/op 810000 ops/sec 61.728 seconds 50000000 operations;    6.1 MB/s
+compact      :   123.456789 micros/op   8100 ops/sec 12.345 seconds   100000 operations;
+readseq      :     0.180000 micros/op 5555555 ops/sec 9.000 seconds 50000000 operations;
+readrandom   :     0.900000 micros/op 1111111 ops/sec 45.000 seconds 50000000 operations;
diff --git a/.github/testdata/topling/memtablerep_bench-cspp.log b/.github/testdata/topling/memtablerep_bench-cspp.log
@@ -0,0 +1,21 @@
+Running fillrandom
+Number of threads: 1
+Elapsed time: 987654 us
+Total bytes written: 1024.0 MiB
+Write throughput: 1036.0 MiB/s
+write us/op: 9.876
+Running readrandom
+Number of threads: 1
+Elapsed time: 876543 us
+Total bytes read: 512.0 MiB
+Read throughput: 584.0 MiB/s
+read us/op: 8.765
+Running readwrite
+Number of threads: 1
+Elapsed time: 765432 us
+Total bytes written: 256.0 MiB
+Write throughput: 334.0 MiB/s
+write us/op: 7.654
+Total bytes read: 128.0 MiB
+Read throughput: 167.0 MiB/s
+read us/op: 6.543
diff --git a/.github/testdata/topling/memtablerep_bench-skiplist.log b/.github/testdata/topling/memtablerep_bench-skiplist.log
@@ -0,0 +1,21 @@
+Running fillrandom
+Number of threads: 1
+Elapsed time: 1234567 us
+Total bytes written: 1024.0 MiB
+Write throughput: 829.0 MiB/s
+write us/op: 12.345
+Running readrandom
+Number of threads: 1
+Elapsed time: 2345678 us
+Total bytes read: 512.0 MiB
+Read throughput: 218.0 MiB/s
+read us/op: 23.456
+Running readwrite
+Number of threads: 1
+Elapsed time: 3456789 us
+Total bytes written: 256.0 MiB
+Write throughput: 74.0 MiB/s
+write us/op: 34.567
+Total bytes read: 128.0 MiB
+Read throughput: 37.0 MiB/s
+read us/op: 45.678
diff --git a/.github/testdata/topling/shm_usage-fillrandom.txt b/.github/testdata/topling/shm_usage-fillrandom.txt
@@ -0,0 +1,2 @@
+apparent_bytes=1207959552
+allocated_bytes=1224736768
diff --git a/.github/testdata/topling/shm_usage-fillseq.txt b/.github/testdata/topling/shm_usage-fillseq.txt
@@ -0,0 +1,2 @@
+apparent_bytes=891289600
+allocated_bytes=905969664
diff --git a/.github/testdata/topling/shm_usage.txt b/.github/testdata/topling/shm_usage.txt
@@ -0,0 +1,2 @@
+apparent_bytes=891289600
+allocated_bytes=905969664
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		apparent_bytes=1476395008
		allocated_bytes=1493172224
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		apparent_bytes=1181116006
		allocated_bytes=1195376640
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		apparent_bytes=1509949440
		allocated_bytes=1526726656
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		apparent_bytes=1207959552
		allocated_bytes=1224736768
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		apparent_bytes=534773760
		allocated_bytes=545259520
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		apparent_bytes=445644800
		allocated_bytes=452984832
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		apparent_bytes=891289600
		allocated_bytes=905969664