postgresql/contrib/pgbench/README.pgbench_jis
Tatsuo Ishii cdf4b9aff2 Apply patches from Neil Conway.
> Hi Tatsuo,
>
> I've attached a patch for the version of pgbench in CVS. It includes the
> following changes:
>
>     - fix some spelling mistakes, indentation stuff, etc.
>
>     - minor code cleanup -- (void) args instead of (), etc.
>
>     - allocate the state array dynamically, so that it is only as
>     large as needed. This reduces the memory consumption of pgbench
>     slightly, and makes a larger MAXCLIENTS setting possible
>
>     - (the only controversial change) add an option "-l" to log
>     transaction latencies to a file. The "transaction latency"
>     is the time between when the BEGIN is issued and the transaction
>     commits. This is written to a file, along with the client #
>     and the transaction #. The data in the file can then be used
>     for things like:
>
>         - consistency analysis: is the TPS the same through the
>         entire run of pgbench, or does it change?
>
>         - more detailed stats: what is the average latency, worse-case
>         latency, best-case latency?
>
>         - graphs: feed the data to gnuplot, graph latency versus. time
>
>         - etc.
>
>     I was going to store this data in memory and write it to disk
>     at the end of the pgbench run, but that isn't feasible because
>     the data can be very large: for example, ~70MB if benchmarking
>     128 clients doing 100,000 transactions each.
>
> Cheers,
>
> Neil
2002-07-20 03:02:01 +00:00

7.8 KiB

pgbench README 2002/07/20 Tatsuo Ishii (t-ishii@sra.co.jp)
 
$B"#pgbench $B$H$O!)
 
pgbench $B$O TPC-B$B$K;w$?%Y%s%A%^!<%/%F%9%H$r9T$J$&%W%m%0%i%`$G$9!%:#$N$H
$B$3$m PostgreSQL $B@lMQ$G$9!%
 
pgbench $B$O select/update/insert $B$r4^$`%H%i%s%6%/%7%g%s$r<B9T$7!$A4BN$N
$B<B9T;~4V$H<B:]$K40N;$7$?%H%i%s%6%/%7%g%s$N?t$+$i 1 $BIC4V$K<B9T$G$-$?%H
$B%i%s%6%/%7%g%s?t (tps) $B$rI=<($7$^$9!%=hM}$NBP>]$H$J$k%F!<%V%k$O%G%U%)
$B%k%H$G$O 10$BK|%?%W%k$N%G!<%?$r4^$_$^$9!%
 
$B<B:]$NI=<($O0J2<$N$h$&$J46$8$G$9!%
 
number of clients: 4
number of transactions per client: 100
number of processed transactions: 400/400
tps = 19.875015(including connections establishing)
tps = 20.098827(excluding connections establishing)
 
pgbench $B$O JDBCBench $B$H$$$&!$$b$H$b$H$O MySQL $BMQ$K=q$+$l$? JDBC $BMQ$N%Y
$B%s%A%^!<%/%W%m%0%i%`$r;29M$K:n@.$5$l$^$7$?!%
 
$B"#pgbench $B$NFCD'
 
o C $B8@8l$H libpq $B$@$1$G=q$+$l$F$$$k$N$G0\?"@-$,9b$/!$4JC1$K%$%s%9%H!<
$B%k$G$-$^$9!%
 
o pgbench $B$O libpq $B$NHsF14|=hM}5!G=$r;H$C$F%^%k%A%f!<%64D6-$r%7%_%e%l!<
$B%H$7$^$9!%MF0W$KF1;~@\B34D6-$r%F%9%H$G$-$^$9!%
 
$B"#pgbench $B$N%$%s%9%H!<%k
 
(1) PostgreSQL$B$rconfigure$B!$%3%s%Q%$%k$7$^$9!%pgbench$B$N%$%s%9%H!<%k$@$1
$B$,L\E*$G$"$l$P!$PostgreSQL$B$N$9$Y$F$r%3%s%Q%$%k$9$kI,MW$O$"$j$^$;$s!%
PostgreSQL$B%=!<%9$N%H%C%W%G%#%l%/%H%j$Gconfigure$B$r$7$?8e!$
src/interface/libpq $B$G "make all" $B$r<B9T$9$l$P=`Hw40N;$G$9!%
 
(2) $B$3$N%G%#%l%/%H%j$G make $B$r<B9T$7$^$9!%$=$&$9$k$H!$"pgbench" $B$H$$$&
$B<B9T%W%m%0%i%`$,$G$-$^$9!%$=$N$^$^<B9T$7$F$b9=$$$^$;$s$7!$"make
install" $B$r<B9T$7$F PostgreSQL $B$NI8=`<B9T%W%m%0%i%`%G%#%l%/%H%j
($B%G%U%)%k%H$G$O /usr/local/pgsql/bin) $B$K%$%s%9%H!<%k$9$k$3$H$b$G$-
$B$^$9!%
 
$B"#pgbench $B$N;H$$J}
 
$ pgbench [$B%G!<%?%Y!<%9L>]
 
$B$G$9!%%G!<%?%Y!<%9L>$r>JN,$9$k$H!$%f!<%6L>$HF1$8%G!<%?%Y!<%9$r;XDj$7$?
$B$b$N$H$_$J$7$^$9!%%G!<%?%Y!<%9$O8e=R$N -i $B%*%W%7%g%s$r;H$C$F$"$i$+$8$a
$B=i4|2=$7$F$*$/I,MW$,$"$j$^$9!%
 
pgbench $B$K$O$$$m$$$m$J%*%W%7%g%s$,$"$j$^$9!%
 
-h $B%[%9%HL> PostgreSQL$B$N%G!<%?%Y!<%9%G!<%b%s postmaster $B$NF0
$B$$$F$$$k%[%9%HL>$r;XDj$7$^$9!%>JN,$9$k$H<+%[%9%H$K Unix domain
socket $B$G@\B3$7$^$9!%
 
-p $B%]!<%HHV9f postmaster $B$N;HMQ$9$k%]!<%HHV9f$r;XDj$7$^$9!%>JN,$9$k$H 5432
$B$,;XDj$5$l$?$b$N$H$_$J$7$^$9!%
 
-c $B%/%i%$%"%s%H?t $BF1;~<B9T%/%i%$%"%s%H?t$r;XDj$7$^$9!%>JN,;~$O
1 $B$H$J$j$^$9!%pgbench $B$OF1;~<B9T%/%i%$%"%s%HKh$K
$B%U%!%$%k%G%#%9%/%j%W%?$r;HMQ$9$k$N$G!$;HMQ2DG=
$B%U%!%$%k%G%#%9%/%j%W%??t$r1[$($k%/%i%$%"%s%H?t$O
$B;XDj$G$-$^$;$s!%;HMQ2DG=%U%!%$%k%G%#%9%/%j%W%??t
$B$O limit $B$d ulimit $B%3%^%s%I$GCN$k$3$H$,$G$-$^$9!%
 
-t $B%H%i%s%6%/%7%g%s?t $B3F%/%i%$%"%s%H$,<B9T$9$k%H%i%s%6%/%7%g%s?t$r
$B;XDj$7$^$9!%>JN,;~$O 10 $B$H$J$j$^$9!%
 
-s $B%9%1!<%j%s%0%U%!%/%?!<
 
-i $B%*%W%7%g%s$H0l=o$K;HMQ$7$^$9!%
$B%9%1!<%j%s%0%U%!%/%?!<$O1$B0J>e$N@0?t!%%9%1!<%j%s%0%U%!
$B%/%?!<$rJQ$($k$3$H$K$h$j!$%F%9%H$NBP>]$H$J$k%F!<%V%k$N
$BBg$-$5$, 10$BK| x [$B%9%1!<%j%s%0%U%!%/%?!<]$B$K$J$j$^$9!%
$B%G%U%)%k%H$N%9%1!<%j%s%0%U%!%/%?!<$O 1 $B$G$9!%
 
-U login DB$B%f!<%6$N%m%0%$%sL>$r;XDj$7$^$9!%
 
-P password $B%Q%9%o!<%I$r;XDj$7$^$9!%$J$*!$$3$N%*%W%7%g%s$r;H$&$H!$
$B%Q%9%o!<%I$rps$B%3%^%s%I$G8+$i$l$k$J$I!$%;%-%e%j%F%#%[!<
$B%k$K$J$k2DG=@-$,$"$k$N$G!$%F%9%HMQ$K$N$_$*;H$$2<$5$$!%
 
-n $B$3$N%*%W%7%g%s$r;XDj$9$k$H!$%Y%s%A%^!<%/3+;OA0$K vacuum $B$H
history $B$N%/%j%"$r9T$J$$$^$;$s!%
 
-v $B$3$N%*%W%7%g%s$r;XDj$9$k$H!$%Y%s%A%^!<%/3+;OA0$K vacuum $B$H
history $B$N%/%j%"$r9T$J$$$^$9!%-v $B$H -n $B$r>JN,$9$k$H!$
$B:G>.8B$N vacuum $B$J$I$r9T$$$^$9!%$9$J$o$A!$history $B$N:o=|!$
$B$H history, branches, history $B$N vacuum $B$r9T$$$^$9!%
$B$3$l$O!$vacuum $B$N;~4V$r:G>.8B$K$7$J$,$i!$%Q%U%)!<%^%s%9$K
$B1F6A$9$k%4%_A]=|$r8z2LE*$K9T$$$^$9!%DL>o$O -v $B$H -n $B$r
$B>JN,$9$k$3$H$r$*$9$9$a$7$^$9!%
 
-S TPC-B$B$N%H%i%s%6%/%7%g%s$G$O$J$/!$8!:w$N$_$N%H%i%s%6%/%7%g%s$r
$B<B9T$7$^$9!%8!:w%9%T!<%I$rB,Dj$7$?$$$H$-$K;H$$$^$9!%
 
-N
"branches"$B$H"tellers"$B%F!<%V%k$N99?7$r9T$$$^$;$s!%$3$l
$B$K$h$C$F"branches"$B$H"tellers"$B$X$NBgNL$N99?7$N6%9g$N$J
$B$$>uBV$G$NB,Dj$r9T$$$^$9!%$7$?$,$C$FTPC-B$B$N%9%Z%C%/$K
$B$OE,9g$7$J$/$J$j$^$9$,!$$h$j8=<BE*$JIi2Y$r%F%9%H$9$k$3
$B$H$,$G$-$^$9!%
 
-C $B$3$N%*%W%7%g%s$r;XDj$9$k$H!$:G=i$K3NN)$7$?%3%M%/%7%g%s
$B$r;H$$2s$9$N$G$O$J$/!$3F%H%i%s%6%/%7%g%s$4$H$KDB$B$X$N@\
$BB3$r9T$$$^$9!%%3%M%/%7%g%s$N%*!<%P!<$X%C%I$rB,Dj$9$k$N
$B$KM-8z$G$9!%
 
-l $B8D!9$N%H%i%s%6%/%7%g%s$N<B9T;~4V$r5-O?$7$^$9!%5-O?@h$O
$B%+%l%s%H%G%#%l%/%H%j0J2<$Npgbench_log.xxx$B$H$$$&%U%!%$
$B%k$G$9!%%U%!%$%k$N%U%)!<%^%C%H$O!$
 
$B%/%i%$%"%s%HID $B%H%i%s%6%/%7%g%sHV9f $B;~4V
 
$B$H$J$C$F$$$^$9!%;~4V$O%^%$%/%mICC10L$G$9!%
 
-d $B%G%P%C%0%*%W%7%g%s!%MM!9$J>pJs$,I=<($5$l$^$9!%
 
$B"#%G!<%?%Y!<%9$N=i4|2=
 
pgbench $B$G%Y%s%A%^!<%/%F%9%H$r<B;\$9$k$?$a$K$O!$$"$i$+$8$a%G!<%?%Y!<%9
$B$r=i4|2=$7!$%F%9%H%G!<%?$r:n$kI,MW$,$"$j$^$9!%
 
$ pgbench -i [$B%G!<%?%Y!<%9L>]
 
$B$3$l$K$h$j0J2<$N%F!<%V%k$,:n$i$l$^$9($B%9%1!<%j%s%0%U%!%/%?!< == 1 $B$N>l9g)$B!%
 
$B!vCm0U!v
$BF1$8L>A0$N%F!<%V%k$,$"$k$H:o=|$5$l$F$7$^$&$N$G$4Cm0U2<$5$$!*!*
 
$B%F!<%V%kL> $B%?%W%k?t
-------------------------
branches 1
tellers 10
accounts 100000
history 0
 
$B%9%1!<%j%s%0%U%!%/%?!<$r 10,100,1000 $B$J$I$KJQ99$9$k$H!$>e5-%?%W%k?t$O
$B$=$l$K1~$8$F10$BG\!$100$BG\!$1000$BG\$K$J$j$^$9!%$?$H$($P!$%9%1!<%j%s%0%U%!
$B%/%?!<$r 10 $B$H$9$k$H!$
 
$B%F!<%V%kL> $B%?%W%k?t
-------------------------
branches 10
tellers 100
accounts 1000000
history 0
 
$B$K$J$j$^$9!%
 
$B"#!V%H%i%s%6%/%7%g%s!W$NDj5A
 
pgbench $B$G$O!$0J2<$N%7!<%1%s%9$rA4It40N;$7$F1$B%H%i%s%6%/%7%g%s$H?t$($F
$B$$$^$9!%
 
(1) begin;
 
(2) update accounts set abalance = abalance + :delta where aid = :aid;
$B$3$3$G!$:delta$B$O1$B$+$i1000$B$^$G$NCM$r<h$kMp?t!$:aid $B$O 1$B$+$i100000$B$^$G
$B$NCM$r<h$kMp?t$G$9!%0J2<!$Mp?t$NCM$O$=$l$>$l$3$N%H%i%s%6%/%7%g%s$N
$BCf$G$OF1$8CM$r;H$$$^$9!%
 
(3) select abalance from accounts where aid = :aid;
$B$3$3$G$O1$B7o$@$18!:w$5$l$^$9!%
 
(4) update tellers set tbalance = tbalance + :delta where tid = :tid;
$B$3$3$G :tid $B$O 1$B$+$i10$B$N4V$NCM$r$H$kMp?t$G$9!%
 
(5) update branches set bbalance = bbalance + :delta where bid = :bid;
$B$3$3$G :bid $B$O 1 $B$+$i[$B%9%1%j%s%0%U%!%/%?!<]$B$N4V$NCM$r<h$kMp?t$G$9!%
 
(6) insert into history(tid,bid,aid,delta) values(:tid,:bid,:aid,:delta);
 
(7) end;
 
$B"#:n<T$H%i%$%;%s%9>r7o
 
pgbench $B$O@P0f $BC#IW$K$h$C$F=q$+$l$^$7$?!%%i%$%;%s%9>r7o$O pgbench.c $B$N
$BKAF,$K=q$$$F$"$j$^$9!%$3$N>r7o$r<i$k8B$jL5=~$GMxMQ$7!$$^$?<+M3$K:FG[IU
$B$G$-$^$9!%
 
$B"#2~DjMzNr
 
2002/07/20
* Nei Conway$B$5$s$N%Q%C%A$rE,MQ!%
* -l $B%*%W%7%g%s$NDI2C!%
 
2002/02/24
* $B$3$3$+$i$O7.3$BMQ$NJQ99$G$9!%
* CHECKPOINT$B$NH/9T$r$d$a$^$7$?!%
* -N $B%*%W%7%g%s$rDI2C$7$^$7$?!%
 
2001/10/24
* PostgreSQL 7.2$B$G!$"time"$B$,M=Ls8l$K$J$C$?$N$G!$"mtime"$B$KJQ99
$B$7$?!%
 
2001/09/09
* PostgreSQL 7.2$BMQ$K!$-U, -P, -C $B%*%W%7%g%s$rDI2C$7$^$7$?!%
 
2000/1/15 pgbench-1.2 $B$O PostgreSQL $B$K contribute $B$5$l$^$7$?!%
* -v $B%*%W%7%g%sDI2C
 
1999/09/29 pgbench-1.1 $B%j%j!<%9
* $BC+ED$5$s$K$h$kcygwin$BBP1~%Q%C%A<h$j9~$_
* $B%P%C%/%(%s%I%/%i%C%7%e;~$NBP1~
* -S $B%*%W%7%g%sDI2C
 
1999/09/04 pgbench-1.0 $B%j%j!<%9