Skip to content

Commit 32bb37d

Browse files
committed
updated README.md
1 parent 95e10fa commit 32bb37d

File tree

1 file changed

+52
-13
lines changed

1 file changed

+52
-13
lines changed

README.md

Lines changed: 52 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,58 @@
1-
Sysbench golang version
1+
# go-sysbench
22

3-
# Usage
3+
[![Go Report Card](https://goreportcard.com/badge/github.com/samitani/go-sysbench)](https://goreportcard.com/report/github.com/samitani/go-sysbench)
4+
[![License](https://img.shields.io/badge/license-GPLv2-blue.svg)](LICENSE)
45

5-
## How to install
6-
7-
# Incompatibility with sysbench
8-
9-
## Database benchmark only
6+
Yet another sysbench written in Golang
107

11-
## Few options
8+
`go-sysbench` runs the same SQL as sysbench and reports the results in the same format as sysbench.
129

13-
## Number of reconnects is not supported
10+
I would like to thank Peter Zaitsev, Alexy Kopytov and contributors for inventing great tool [sysbench](https://github.com/akopytov/sysbench).
1411

15-
## Lua script is not supported
16-
17-
# Additional feature
12+
## How to install
1813

19-
## Google Cloud Spanner
14+
```
15+
go install github.com/samitani/go-sysbench/cmd/go-sysbench@main
16+
```
17+
18+
## Incompatibility with sysbench
19+
20+
* `go-sysbench` supports only `oltp_read_only` and `oltp_read_write` database benchmarks. Linux benchmarks such as `fileio`, `cpu`, `memory`, etc. are not supported.
21+
* Some options are not implemented. `go-sysbench oltp_read_write run --help` shows available options.
22+
```
23+
$ go-sysbench oltp_read_write run --help
24+
2025/02/05 21:18:22 Usage:
25+
go-sysbench [OPTIONS] oltp_read_write run [run-OPTIONS]
26+
27+
Help Options:
28+
-h, --help Show this help message
29+
30+
[run command options]
31+
--threads= number of threads to use (default: 1)
32+
--events= limit for total number of events (default: 0)
33+
--time= limit for total execution time in seconds (default: 10)
34+
--report-interval= periodically report intermediate statistics with a specified interval in seconds. 0 disables intermediate reports (default: 0)
35+
--histogram=[on|off] print latency histogram in report (default: off)
36+
--tables= number of tables (default: 1)
37+
--table_size= number of rows per table (default: 10000)
38+
--db-driver=[mysql|pgsql|spanner] specifies database driver to use (default: mysql)
39+
--mysql-host= MySQL server host (default: localhost)
40+
--mysql-port= MySQL server port (default: 3306)
41+
--mysql-user= MySQL user (default: sbtest)
42+
--mysql-password= MySQL password [$MYSQL_PWD]
43+
--mysql-db= MySQL database name (default: sbtest)
44+
--pgsql-host= PostgreSQL server host (default: localhost)
45+
--pgsql-port= PostgreSQL server port (default: 5432)
46+
--pgsql-user= PostgreSQL user (default: sbtest)
47+
--pgsql-password= PostgreSQL password [$PGPASSWORD]
48+
--pgsql-db= PostgreSQL database name (default: sbtest)
49+
--spanner-project= Spanner Google Cloud project name
50+
--spanner-instance= Spanner instance id
51+
--spanner-db= Spanner database name (default: sbtest)
52+
```
53+
* Number of reconnects is not reported.
54+
* Lua scripts is not supported. To customize the benchmark scenario, you have to edit the code directly.
55+
56+
## Additional feature
57+
58+
### Google Cloud Spanner

0 commit comments

Comments
 (0)