drk

drk

wrk but for databases and pronounced /dɜːk/.

Installation

Find the release that matches your architecture on the releases page.

Download the tar, extract the executable, and move it into your PATH. For example:

tar -xvf drk_0.0.1_macos_arm64.tar.gz

Usage

drk --help

Usage of drk:
  -config string
        absolute or relative path to config file (default "drk.yaml")
  -debug
        enable verbose logging
  -driver string
        database driver to use [pgx, mysql, dsql] (default "pgx")
  -dry-run
        if specified, prints config and exits
  -duration duration
        total duration of simulation (default 10m0s)
  -url string
        database connection string

Examples

For more examples see examples but here's the gist:

# CockroachDB / Postgres
drk \
--config examples/db_comparison/postgres.drk.yaml \
--driver pgx \
--url "postgres://root@localhost:26257?sslmode=disable"

# DSQL
AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID} \
AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY} \
AWS_REGION=${AWS_REGION} \
drk \
--config examples/db_comparison/postgres.drk.yaml \
--driver dsql \
--url "postgres://YOUR_ENDPOINT.dsql.us-east-1.on.aws:5432/postgres?user=admin&sslmode=verify-full&sslrootcert=AmazonRootCA1.pem"

# MySQL
drk \
--config examples/db_comparison/mysql.drk.yaml \
--driver mysql
--url "root:password@tcp(localhost:3306)/mysql"

Todos

• Cohorts (run these, then these)
• Commit and Rollover counts
• Support bulk activities (e.g. insert 1,000 instead of just 1)
• Add the ability to ensure uniqueness across two arg values (re-running until unique, or crashing after X attempts)
• Update ref to allow more than one item to be seleted (e.g. add multiple products to a basket)
• Optionally pass args in workflow queries
• Ramp VU's up and down