postgresql/contrib/pgbench/README.pgbench_jis

$PostgreSQL: pgsql/contrib/pgbench/README.pgbench_jis,v 1.19 2007/04/08 01:15:07 ishii Exp $
 
pgbench README
 
$B"#pgbench $B$H$O!)
 
pgbench $B$OPostgreSQL$B$N%Y%s%A%^!<%/%F%9%H$r9T$J$&%W%m%0%i%`$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
 
PostgreSQL$B$r%3%s%Q%$%k!$%$%s%9%H!<%k$7$?8e
 
$ make
$ make install
 
$B$H$7$^$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$*$/$3$H$,$G$-$^$9!%-f$B%*%W%7%g%s$r;H$C$FFH<+$N%H%i%s%6%/%7%g
$B%s$rDj5A$9$k>l9g$O!$<+J,$G%G!<%?%Y!<%9$N=i4|2=$r$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!%
-f $B%*%W%7%g%s$G;XDj$7$?%U%!%$%k$+$i%9%1!<%j%s%0%U%!%/
$B%?!<$r;2>H$9$k$K$O scale $B$H$$$&JQ?tL>$r;HMQ$7$^$9!%
$BCm0U: $B%9%1!<%j%s%0%U%!%/%?!<$O>/$J$/$H$b -c $B$G;XDj$5$l$kF1;~@\
$BB3%f!<%6?t$HF1$8$+$=$l$h$j$bBg$-$/$7$F$/$@$5$$!%$G$J$$$H!$
pgbench$B$N7k2L$OUPDATE$B$N6%9g$KBg$-$/1F6A$5$l$F$7$^$$$^$9!%
$BAH9~$_$N%Y%s%A%^!<%/%Q%?!<%s$G$O!$braches$B$N?t(=braches$B%F!<%V%k
$B$N9T?t)$B$,<+F0E*$K%9%1!<%j%s%0%U%!%/%?!<$K@_Dj$5$l$^$9!%
$B%+%9%?%`%/%(%j(-f$B%*%W%7%g%s;HMQ)$B$G$O!$%9%1!<%j%s%0%U%!%/%?!<$O
$B<+F0@_Dj$5$l$^$;$s!%
 
-D varname=value
 
$BJQ?t$rDj5A$7$^$9!%Dj5A$7$?JQ?t$O -f $B%*%W%7%g%s$G;XDj$7$?%U%!%$
$B%k$+$i;2>H$G$-$^$9!%-D $B%*%W%7%g%s$G$OJQ?tL>$HCM$r = ($B%$%3!<%k)
$B$G6h@Z$C$F;XDj$7$^$9!%-D $B%*%W%7%g%s$OJ#?t;XDj$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!$%G%U%)%k%H$N;vA0%/%j!<%s%"%C
$B%W=hM}$K2C$(!$accounts$B$rVACUUM ANALYZE$B$7$^$9!%
 
-v -n $B$NN>J}$r>JN,$7$?>l9g$N%G%U%)%k%H;vA0%/%j!<%s%"%C
$B%W=hM}$O!$0J2<$N=hM}$r9T$$$^$9!%
 
- history$B$+$i$NA49T:o=|
- branches, tellers, history$B$NVACUUM
 
$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!%
 
-f filename $B%H%i%s%6%/%7%g%s$NFbMF$,5-=R$5$l$?%U%!%$%kL>$r;XDj$7$^
$B$9!%$3$N%*%W%7%g%s$r;XDj$9$k$H!$%U%!%$%k$K5-=R$5$l$?Fb
$BMF$N%H%i%s%6%/%7%g%s$r<B9T$7$^$9!%$J$*!$%Y%s%A%^!<%/$N
$BBP>]$H$J$k%G!<%?%Y!<%9$O$"$i$+$8$a=i4|2=$7$F$*$/I,MW$,
$B$"$j$^$9!%F~NO%U%)!<%^%C%H$K$D$$$F$O8e=R$7$^$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%U%!%$%kHV9f Unix$B%?%$%`($BIC) $B%*%U%;%C%H
 
$B$H$J$C$F$$$^$9!%;~4V$O%^%$%/%mICC10L$G$9!%
 
$B%U%!%$%kHV9f$O%F%9%H$K;H$o$l$?%U%!%$%k$NHV9f$G$9(-f$B%*%W%7%g%s
$B$rJ#?t;XDj$7$?$H$-$KM-MQ$G$9)$B!%
 
$B!VUnix$B%?%$%`($BIC) $B%*%U%;%C%H!W$O!$%H%i%s%6%/%7%g%s$,40N;$7$?$H
$B$-$NUNIX$B%(%]%C%/%?%$%`$H%^%$%/%mICC10L$N%*%U%;%C%H$G$9(ISO
8601$B%?%$%`%9%?%s%W$HIC$NCf$NC<?t)$B!%
 
$B%m%0$N=PNONc$r<($7$^$9!%
 
0 199 2241 0 1175850568 995598
0 200 2465 0 1175850568 998079
0 201 2513 0 1175850569 608
0 202 2038 0 1175850569 2663
 
-F $B%U%#%k%U%!%/%?!<
accounts, tellers, bracnhes$B%F!<%V%k$r:n@.$9$k:]$K;XDj$5$l$?%U%#
$B%k%U%!%/%?!<$r;HMQ$7$^$9!%%U%#%k%U%!%/%?!<$N%G%U%)%k%H$O100$B$G
$B$9!%$3$N%*%W%7%g%s$O -i $B%*%W%7%g%s$HF1;~$K;HMQ$7$^$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!%-f$B%*%W%7%g%s$r;H$C$FFH<+
$B$N%H%i%s%6%/%7%g%s$rDj5A$9$k>l9g$O!$<+J,$G%G!<%?%Y!<%9$N=i4|2=$r$7$F$*
$B$/I,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!%%F!<%V%k$H%$%s%G%C%/%9$N%5
$B%$%:$O%G!<%?%Y!<%9%5%$%:$O35$M$=$l$>$l!$130MB$B!$1.3GB$B!$13GB$B$[$I$K$J$j$^
$B$9!%
 
$B$?$H$($P!$%9%1!<%j%s%0%U%!%/%?!<$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;
 
-N$B%*%W%7%g%s$r;HMQ$9$k$H!$(4)(5)$B$O<B9T$5$l$^$;$s!%
 
$B"#F~NO%U%!%$%k$N%U%)!<%^%C%H
 
-f $B%*%W%7%g%s$r;XDj$7$F%H%i%s%6%/%7%g%s$K4^$^$l$k SQL $B%3%^%s%I$NFbMF$r
$B5-=R$7$?%U%!%$%k$rFI$_9~$`$3$H$,$G$-$^$9!%F~NO%U%!%$%k$K$O 1 $B9T$K$D$-
1 $B$D$N%3%^%s%I$r5-=R$7$^$9!%6u9T$OL5;k$5$l!$Fs=E%O%$%U%s$G;O$^$k9T$O%3
$B%a%s%H$r0UL#$7$^$9!%
 
-f $B%*%W%7%g%s$OJ#?t;XDj$G$-$^$9!%$3$N>l9g$O3F%H%i%s%6%/%7%g%s$K$O%i%s
$B%@%`$KA*$P$l$?%U%!%$%k$K5-=R$5$l$?SQL$B$,<B9T$5$l$^$9!%
 
$B%3%^%s%I$K$O!$SQL $B%3%^%s%I$K2C$(!$%P%C%/%9%i%C%7%e$G;O$^$k%a%?%3%^%s%I
$B$r5-=R$G$-$^$9!%%a%?%3%^%s%I$O pgbench $B<+?H$K$h$C$F<B9T$5$l$^$9!%%a%?
$B%3%^%s%I$N7A<0$O%P%C%/%9%i%C%7%e!$$=$ND>8e$K%3%^%s%I$NF0;l!$$=$N<!$K0z
$B?t$,B3$-$^$9!%F0;l%3%^%s%I$H0z?t!$$^$?$=$l$>$l$N0z?t$O6uGrJ8;z$K$h$C$F
$B6h@Z$i$l$^$9!%
 
$B8=:_$N$H$3$m!$0J2<$N%a%?%3%^%s%I$,Dj5A$5$l$F$$$^$9!%
 
\set name operand1 [ operator operand2 ]
$BHo1i;;?t operand1 $B$H operand2 $B$r1i;;;R operator $B$K$h$C$F1i;;$7
$B$?7k2L$rJQ?t name $B$K@_Dj$7$^$9!%8=>u$G$O@0?t$N;MB'1i;;$N$_$KBP
$B1~$7$F$$$^$9!%$J$*!$1i;;;R$H 2 $B$DL\$NHo1i;;?t$r>JN,$9$k$HC1=c
$B$K 1 $B$DL\$NHo1i;;?t$rJQ?t$K@_Dj$7$^$9!%
 
$BJQ?t$K1i;;$N7k2L$r@_Dj$9$k$K$O!$\set $B%a%?%3%^%s%I$r;HMQ$7$F0J
$B2<$N$h$&$K5-=R$7$^$9!%
 
\set ntellers 10 * :tp
 
$B$3$l$O!$JQ?t ntellers $B$K%9%1!<%j%s%0%U%!%/%?!< (-s $B%*%W%7%g%s
$B$G;XDj$7$?) $B$r 10 $BG\$7$?7k2L$r@_Dj$7$^$9!%
 
\setrandom name min max
 
$B:G>.CM min $B$H:GBgCM max $B$N4V$NCM$r<h$kMp?t$r!$name $BJQ?t$K@_Dj
$B$7$^$9!%
 
$BJQ?t$KMp?t$r@_Dj$9$k$K$O!$\setrandom $B%a%?%3%^%s%I$r;HMQ$7$F0J2<$N$h$&
$B$K5-=R$7$^$9!%
 
\setrandom aid 1 100000
 
$B$3$l$O!$JQ?t aid $B$K 1 $B$+$i 100000 $B$N4V$NMp?t$r@_Dj$7$^$9!%
 
$BJQ?t$O SQL $B%3%^%s%I$*$h$S%a%?%3%^%s%I$+$i;2>H$G$-$^$9!%$=$l$K$O0J2<$N
$B$h$&$KJQ?tL>$NA0$K%3%m%s$rIU$1$^$9!%
 
SELECT abalance FROM accounts WHERE aid = :aid
 
$BJQ?t$rDj5A$9$k$K$O%a%?%3%^%s%I0J30$K -D $B%*%W%7%g%s$r;HMQ$9$k$3$H$b$G$-
$B$^$9!% -D $B%*%W%7%g%s$GDj5A$7$?JQ?t$bJQ?tL>$NA0$K%3%m%s$rIU$1$F;2>H$7$^
$B$9!%
 
$BNc$($P!$TCP-B $B$KN`;w$7$?%Y%s%A%^!<%/$r7WB,$9$k$K$O!$0J2<$N$h$&$K%H%i%s
$B%6%/%7%g%s$NFbMF$r%U%!%$%k$K5-=R$7!$-f $B%*%W%7%g%s$K$h$C$F$=$N%U%!%$%k
$B$r;XDj$7$F pgbench $B$r<B9T$7$^$9!%
 
\set nbranches :scale
\set ntellers 10 * :scale
\set naccounts 100000 * :scale
\setrandom aid 1 :naccounts
\setrandom bid 1 :nbranches
\setrandom tid 1 :ntellers
\setrandom delta 1 10000
BEGIN
UPDATE accounts SET abalance = abalance + :delta WHERE aid = :aid
SELECT abalance FROM accounts WHERE aid = :aid
UPDATE tellers SET tbalance = tbalance + :delta WHERE tid = :tid
UPDATE branches SET bbalance = bbalance + :delta WHERE bid = :bid
INSERT INTO history (tid, bid, aid, delta, mtime) VALUES (:tid, :bid, :aid, :delta, current_timestamp)
END
 
$B%9%1!<%j%s%0%U%!%/%?!<$r branches $B%F!<%V%k$N%?%W%k?t$+$i<+F0E*$K@_Dj$7
$B$?$$>l9g!$0J2<$N$h$&$K -s $B%*%W%7%g%s$H%7%'%k$N%3%^%s%ICV49$J$I$rAH$_9g
$B$o$;$^$9!%
 
pgbench -s $(psql -At -c "SELECT count(*) FROM branches") -f tpc_b.sql
 
$B$J$*!$-f $B%*%W%7%g%s$r;XDj$7$?>l9g!$%Y%s%A%^!<%/3+;OA0$K vacuum $B$H
history $B$N%/%j%"$O<+F0E*$K9T$o$l$^$;$s!%
 
$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"#PostgreSQL$B$Ncontrib$B%b%8%e!<%k$H$7$F<h$j9~$^$l$k$^$G$N2~DjMzNr
 
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