prestogres 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (393) hide show
  1. data/.gitignore +4 -0
  2. data/Gemfile +2 -0
  3. data/Gemfile.lock +20 -0
  4. data/LICENSE +202 -0
  5. data/NOTICE +22 -0
  6. data/README.md +217 -0
  7. data/Rakefile +13 -0
  8. data/VERSION +1 -0
  9. data/bin/prestogres +254 -0
  10. data/config/pcp.conf.sample +28 -0
  11. data/config/pgpool.conf +678 -0
  12. data/config/pool_hba.conf +84 -0
  13. data/config/pool_passwd +0 -0
  14. data/config/postgresql.conf +2 -0
  15. data/ext/.gitignore +6 -0
  16. data/ext/depend +26 -0
  17. data/ext/extconf.rb +4 -0
  18. data/ext/prestogres_config.c +12 -0
  19. data/pgpool2/.gitignore +36 -0
  20. data/pgpool2/AUTHORS +4 -0
  21. data/pgpool2/COPYING +12 -0
  22. data/pgpool2/ChangeLog +1 -0
  23. data/pgpool2/INSTALL +1 -0
  24. data/pgpool2/Makefile.am +159 -0
  25. data/pgpool2/Makefile.in +1187 -0
  26. data/pgpool2/NEWS +4960 -0
  27. data/pgpool2/README +1 -0
  28. data/pgpool2/README.euc_jp +1 -0
  29. data/pgpool2/README.online-recovery +62 -0
  30. data/pgpool2/TODO +103 -0
  31. data/pgpool2/ac_func_accept_argtypes.m4 +85 -0
  32. data/pgpool2/aclocal.m4 +1088 -0
  33. data/pgpool2/c-compiler.m4 +134 -0
  34. data/pgpool2/c-library.m4 +325 -0
  35. data/pgpool2/child.c +2097 -0
  36. data/pgpool2/config.guess +1532 -0
  37. data/pgpool2/config.h.in +332 -0
  38. data/pgpool2/config.sub +1640 -0
  39. data/pgpool2/configure +15752 -0
  40. data/pgpool2/configure.in +392 -0
  41. data/pgpool2/depcomp +522 -0
  42. data/pgpool2/doc/basebackup.sh +17 -0
  43. data/pgpool2/doc/pgpool-de.html +4220 -0
  44. data/pgpool2/doc/pgpool-en.html +5738 -0
  45. data/pgpool2/doc/pgpool-fr.html +4118 -0
  46. data/pgpool2/doc/pgpool-ja.css +198 -0
  47. data/pgpool2/doc/pgpool-ja.html +11279 -0
  48. data/pgpool2/doc/pgpool-zh_cn.html +4445 -0
  49. data/pgpool2/doc/pgpool.css +280 -0
  50. data/pgpool2/doc/pgpool_remote_start +13 -0
  51. data/pgpool2/doc/recovery.conf.sample +117 -0
  52. data/pgpool2/doc/tutorial-en.html +707 -0
  53. data/pgpool2/doc/tutorial-ja.html +422 -0
  54. data/pgpool2/doc/tutorial-memqcache-en.html +325 -0
  55. data/pgpool2/doc/tutorial-memqcache-ja.html +370 -0
  56. data/pgpool2/doc/tutorial-memqcache-zh_cn.html +322 -0
  57. data/pgpool2/doc/tutorial-watchdog-en.html +306 -0
  58. data/pgpool2/doc/tutorial-watchdog-ja.html +343 -0
  59. data/pgpool2/doc/tutorial-watchdog-zh_cn.html +301 -0
  60. data/pgpool2/doc/tutorial-zh_cn.html +537 -0
  61. data/pgpool2/doc/watchdog.png +0 -0
  62. data/pgpool2/doc/wd-en.html +236 -0
  63. data/pgpool2/doc/wd-en.jpg +0 -0
  64. data/pgpool2/doc/wd-ja.html +219 -0
  65. data/pgpool2/doc/wd-ja.jpg +0 -0
  66. data/pgpool2/doc/wd-zh_cn.html +201 -0
  67. data/pgpool2/doc/where_to_send_queries.odg +0 -0
  68. data/pgpool2/doc/where_to_send_queries.pdf +0 -0
  69. data/pgpool2/general.m4 +166 -0
  70. data/pgpool2/getopt_long.c +200 -0
  71. data/pgpool2/getopt_long.h +44 -0
  72. data/pgpool2/install-sh +251 -0
  73. data/pgpool2/ltmain.sh +8406 -0
  74. data/pgpool2/m4/libtool.m4 +7360 -0
  75. data/pgpool2/m4/ltoptions.m4 +368 -0
  76. data/pgpool2/m4/ltsugar.m4 +123 -0
  77. data/pgpool2/m4/ltversion.m4 +23 -0
  78. data/pgpool2/m4/lt~obsolete.m4 +92 -0
  79. data/pgpool2/main.c +2971 -0
  80. data/pgpool2/md5.c +444 -0
  81. data/pgpool2/md5.h +28 -0
  82. data/pgpool2/missing +360 -0
  83. data/pgpool2/mkinstalldirs +40 -0
  84. data/pgpool2/parser/Makefile.am +50 -0
  85. data/pgpool2/parser/Makefile.in +559 -0
  86. data/pgpool2/parser/copyfuncs.c +3310 -0
  87. data/pgpool2/parser/gram.c +39100 -0
  88. data/pgpool2/parser/gram.h +940 -0
  89. data/pgpool2/parser/gram.y +13408 -0
  90. data/pgpool2/parser/gramparse.h +74 -0
  91. data/pgpool2/parser/keywords.c +32 -0
  92. data/pgpool2/parser/keywords.h +39 -0
  93. data/pgpool2/parser/kwlist.h +425 -0
  94. data/pgpool2/parser/kwlookup.c +88 -0
  95. data/pgpool2/parser/list.c +1156 -0
  96. data/pgpool2/parser/makefuncs.c +518 -0
  97. data/pgpool2/parser/makefuncs.h +83 -0
  98. data/pgpool2/parser/memnodes.h +79 -0
  99. data/pgpool2/parser/nodes.c +29 -0
  100. data/pgpool2/parser/nodes.h +609 -0
  101. data/pgpool2/parser/outfuncs.c +5790 -0
  102. data/pgpool2/parser/parsenodes.h +2615 -0
  103. data/pgpool2/parser/parser.c +262 -0
  104. data/pgpool2/parser/parser.h +46 -0
  105. data/pgpool2/parser/pg_class.h +158 -0
  106. data/pgpool2/parser/pg_config_manual.h +273 -0
  107. data/pgpool2/parser/pg_list.h +352 -0
  108. data/pgpool2/parser/pg_trigger.h +147 -0
  109. data/pgpool2/parser/pg_wchar.h +492 -0
  110. data/pgpool2/parser/pool_memory.c +342 -0
  111. data/pgpool2/parser/pool_memory.h +77 -0
  112. data/pgpool2/parser/pool_parser.h +222 -0
  113. data/pgpool2/parser/pool_string.c +121 -0
  114. data/pgpool2/parser/pool_string.h +37 -0
  115. data/pgpool2/parser/primnodes.h +1280 -0
  116. data/pgpool2/parser/scan.c +4094 -0
  117. data/pgpool2/parser/scan.l +1451 -0
  118. data/pgpool2/parser/scanner.h +120 -0
  119. data/pgpool2/parser/scansup.c +221 -0
  120. data/pgpool2/parser/scansup.h +28 -0
  121. data/pgpool2/parser/snprintf.c +1102 -0
  122. data/pgpool2/parser/stringinfo.c +294 -0
  123. data/pgpool2/parser/stringinfo.h +178 -0
  124. data/pgpool2/parser/value.c +78 -0
  125. data/pgpool2/parser/value.h +62 -0
  126. data/pgpool2/parser/wchar.c +2048 -0
  127. data/pgpool2/pcp.conf.sample +28 -0
  128. data/pgpool2/pcp/Makefile.am +40 -0
  129. data/pgpool2/pcp/Makefile.in +771 -0
  130. data/pgpool2/pcp/libpcp_ext.h +250 -0
  131. data/pgpool2/pcp/md5.c +444 -0
  132. data/pgpool2/pcp/md5.h +28 -0
  133. data/pgpool2/pcp/pcp.c +1652 -0
  134. data/pgpool2/pcp/pcp.h +61 -0
  135. data/pgpool2/pcp/pcp_attach_node.c +172 -0
  136. data/pgpool2/pcp/pcp_detach_node.c +185 -0
  137. data/pgpool2/pcp/pcp_error.c +87 -0
  138. data/pgpool2/pcp/pcp_node_count.c +160 -0
  139. data/pgpool2/pcp/pcp_node_info.c +198 -0
  140. data/pgpool2/pcp/pcp_pool_status.c +166 -0
  141. data/pgpool2/pcp/pcp_proc_count.c +166 -0
  142. data/pgpool2/pcp/pcp_proc_info.c +261 -0
  143. data/pgpool2/pcp/pcp_promote_node.c +185 -0
  144. data/pgpool2/pcp/pcp_recovery_node.c +172 -0
  145. data/pgpool2/pcp/pcp_stop_pgpool.c +179 -0
  146. data/pgpool2/pcp/pcp_stream.c +385 -0
  147. data/pgpool2/pcp/pcp_stream.h +52 -0
  148. data/pgpool2/pcp/pcp_systemdb_info.c +194 -0
  149. data/pgpool2/pcp/pcp_watchdog_info.c +211 -0
  150. data/pgpool2/pcp_child.c +1493 -0
  151. data/pgpool2/pg_md5.c +305 -0
  152. data/pgpool2/pgpool.8.in +121 -0
  153. data/pgpool2/pgpool.conf +553 -0
  154. data/pgpool2/pgpool.conf.sample +666 -0
  155. data/pgpool2/pgpool.conf.sample-master-slave +665 -0
  156. data/pgpool2/pgpool.conf.sample-replication +664 -0
  157. data/pgpool2/pgpool.conf.sample-stream +664 -0
  158. data/pgpool2/pgpool.spec +264 -0
  159. data/pgpool2/pgpool_adm/TODO +7 -0
  160. data/pgpool2/pgpool_adm/pgpool_adm--1.0.sql +85 -0
  161. data/pgpool2/pgpool_adm/pgpool_adm.c +558 -0
  162. data/pgpool2/pgpool_adm/pgpool_adm.control +5 -0
  163. data/pgpool2/pgpool_adm/pgpool_adm.h +46 -0
  164. data/pgpool2/pgpool_adm/pgpool_adm.sql.in +85 -0
  165. data/pgpool2/pool.h +655 -0
  166. data/pgpool2/pool_auth.c +1390 -0
  167. data/pgpool2/pool_config.c +5007 -0
  168. data/pgpool2/pool_config.h +284 -0
  169. data/pgpool2/pool_config.l +3281 -0
  170. data/pgpool2/pool_config_md5.c +29 -0
  171. data/pgpool2/pool_connection_pool.c +812 -0
  172. data/pgpool2/pool_error.c +242 -0
  173. data/pgpool2/pool_globals.c +27 -0
  174. data/pgpool2/pool_hba.c +1723 -0
  175. data/pgpool2/pool_hba.conf.sample +67 -0
  176. data/pgpool2/pool_ip.c +567 -0
  177. data/pgpool2/pool_ip.h +65 -0
  178. data/pgpool2/pool_ipc.h +38 -0
  179. data/pgpool2/pool_lobj.c +242 -0
  180. data/pgpool2/pool_lobj.h +32 -0
  181. data/pgpool2/pool_memqcache.c +3818 -0
  182. data/pgpool2/pool_memqcache.h +268 -0
  183. data/pgpool2/pool_params.c +163 -0
  184. data/pgpool2/pool_passwd.c +249 -0
  185. data/pgpool2/pool_passwd.h +41 -0
  186. data/pgpool2/pool_path.c +193 -0
  187. data/pgpool2/pool_path.h +81 -0
  188. data/pgpool2/pool_process_context.c +247 -0
  189. data/pgpool2/pool_process_context.h +62 -0
  190. data/pgpool2/pool_process_query.c +5001 -0
  191. data/pgpool2/pool_process_reporting.c +1671 -0
  192. data/pgpool2/pool_process_reporting.h +44 -0
  193. data/pgpool2/pool_proto2.c +671 -0
  194. data/pgpool2/pool_proto_modules.c +3524 -0
  195. data/pgpool2/pool_proto_modules.h +185 -0
  196. data/pgpool2/pool_query_cache.c +1020 -0
  197. data/pgpool2/pool_query_context.c +1871 -0
  198. data/pgpool2/pool_query_context.h +105 -0
  199. data/pgpool2/pool_relcache.c +284 -0
  200. data/pgpool2/pool_relcache.h +78 -0
  201. data/pgpool2/pool_rewrite_outfuncs.c +9060 -0
  202. data/pgpool2/pool_rewrite_query.c +715 -0
  203. data/pgpool2/pool_rewrite_query.h +192 -0
  204. data/pgpool2/pool_select_walker.c +1150 -0
  205. data/pgpool2/pool_select_walker.h +68 -0
  206. data/pgpool2/pool_sema.c +161 -0
  207. data/pgpool2/pool_session_context.c +952 -0
  208. data/pgpool2/pool_session_context.h +203 -0
  209. data/pgpool2/pool_shmem.c +185 -0
  210. data/pgpool2/pool_signal.c +158 -0
  211. data/pgpool2/pool_signal.h +61 -0
  212. data/pgpool2/pool_ssl.c +339 -0
  213. data/pgpool2/pool_stream.c +962 -0
  214. data/pgpool2/pool_stream.h +61 -0
  215. data/pgpool2/pool_system.c +659 -0
  216. data/pgpool2/pool_timestamp.c +1215 -0
  217. data/pgpool2/pool_timestamp.h +38 -0
  218. data/pgpool2/pool_type.h +171 -0
  219. data/pgpool2/pool_worker_child.c +384 -0
  220. data/pgpool2/ps_status.c +404 -0
  221. data/pgpool2/recovery.c +435 -0
  222. data/pgpool2/redhat/pgpool.conf.sample.patch +52 -0
  223. data/pgpool2/redhat/pgpool.init +201 -0
  224. data/pgpool2/redhat/pgpool.sysconfig +7 -0
  225. data/pgpool2/redhat/rpm_installer/basebackup-replication.sh +53 -0
  226. data/pgpool2/redhat/rpm_installer/basebackup-stream.sh +55 -0
  227. data/pgpool2/redhat/rpm_installer/config_for_script +17 -0
  228. data/pgpool2/redhat/rpm_installer/failover.sh +64 -0
  229. data/pgpool2/redhat/rpm_installer/getsources.sh +141 -0
  230. data/pgpool2/redhat/rpm_installer/install.sh +1363 -0
  231. data/pgpool2/redhat/rpm_installer/pgpool_recovery_pitr +47 -0
  232. data/pgpool2/redhat/rpm_installer/pgpool_remote_start +15 -0
  233. data/pgpool2/redhat/rpm_installer/recovery.conf +4 -0
  234. data/pgpool2/redhat/rpm_installer/uninstall.sh +57 -0
  235. data/pgpool2/sample/dist_def_pgbench.sql +73 -0
  236. data/pgpool2/sample/pgpool.pam +3 -0
  237. data/pgpool2/sample/pgpool_recovery +20 -0
  238. data/pgpool2/sample/pgpool_recovery_pitr +19 -0
  239. data/pgpool2/sample/pgpool_remote_start +13 -0
  240. data/pgpool2/sample/replicate_def_pgbench.sql +18 -0
  241. data/pgpool2/sql/insert_lock.sql +15 -0
  242. data/pgpool2/sql/pgpool-recovery/pgpool-recovery.c +280 -0
  243. data/pgpool2/sql/pgpool-recovery/pgpool-recovery.sql.in +19 -0
  244. data/pgpool2/sql/pgpool-recovery/pgpool_recovery--1.0.sql +24 -0
  245. data/pgpool2/sql/pgpool-recovery/pgpool_recovery.control +5 -0
  246. data/pgpool2/sql/pgpool-recovery/uninstall_pgpool-recovery.sql +3 -0
  247. data/pgpool2/sql/pgpool-regclass/pgpool-regclass.c +206 -0
  248. data/pgpool2/sql/pgpool-regclass/pgpool-regclass.sql.in +4 -0
  249. data/pgpool2/sql/pgpool-regclass/pgpool_regclass--1.0.sql +7 -0
  250. data/pgpool2/sql/pgpool-regclass/pgpool_regclass.control +5 -0
  251. data/pgpool2/sql/pgpool-regclass/uninstall_pgpool-regclass.sql +1 -0
  252. data/pgpool2/sql/system_db.sql +38 -0
  253. data/pgpool2/strlcpy.c +85 -0
  254. data/pgpool2/test/C/test_extended.c +98 -0
  255. data/pgpool2/test/jdbc/.cvsignore +2 -0
  256. data/pgpool2/test/jdbc/AutoCommitTest.java +45 -0
  257. data/pgpool2/test/jdbc/BatchTest.java +55 -0
  258. data/pgpool2/test/jdbc/ColumnTest.java +60 -0
  259. data/pgpool2/test/jdbc/CreateTempTableTest.java +48 -0
  260. data/pgpool2/test/jdbc/InsertTest.java +34 -0
  261. data/pgpool2/test/jdbc/LockTest.java +36 -0
  262. data/pgpool2/test/jdbc/PgpoolTest.java +75 -0
  263. data/pgpool2/test/jdbc/README.euc_jp +73 -0
  264. data/pgpool2/test/jdbc/RunTest.java +83 -0
  265. data/pgpool2/test/jdbc/SelectTest.java +37 -0
  266. data/pgpool2/test/jdbc/UpdateTest.java +32 -0
  267. data/pgpool2/test/jdbc/expected/CreateTempTable +1 -0
  268. data/pgpool2/test/jdbc/expected/autocommit +10 -0
  269. data/pgpool2/test/jdbc/expected/batch +1 -0
  270. data/pgpool2/test/jdbc/expected/column +100 -0
  271. data/pgpool2/test/jdbc/expected/insert +1 -0
  272. data/pgpool2/test/jdbc/expected/lock +100 -0
  273. data/pgpool2/test/jdbc/expected/select +2 -0
  274. data/pgpool2/test/jdbc/expected/update +1 -0
  275. data/pgpool2/test/jdbc/pgpool.properties +7 -0
  276. data/pgpool2/test/jdbc/prepare.sql +54 -0
  277. data/pgpool2/test/jdbc/run.sh +6 -0
  278. data/pgpool2/test/parser/.cvsignore +6 -0
  279. data/pgpool2/test/parser/README +32 -0
  280. data/pgpool2/test/parser/expected/copy.out +17 -0
  281. data/pgpool2/test/parser/expected/create.out +64 -0
  282. data/pgpool2/test/parser/expected/cursor.out +37 -0
  283. data/pgpool2/test/parser/expected/delete.out +10 -0
  284. data/pgpool2/test/parser/expected/drop.out +12 -0
  285. data/pgpool2/test/parser/expected/insert.out +13 -0
  286. data/pgpool2/test/parser/expected/misc.out +28 -0
  287. data/pgpool2/test/parser/expected/prepare.out +4 -0
  288. data/pgpool2/test/parser/expected/privileges.out +31 -0
  289. data/pgpool2/test/parser/expected/scanner.out +30 -0
  290. data/pgpool2/test/parser/expected/select.out +89 -0
  291. data/pgpool2/test/parser/expected/transaction.out +38 -0
  292. data/pgpool2/test/parser/expected/update.out +11 -0
  293. data/pgpool2/test/parser/expected/v84.out +37 -0
  294. data/pgpool2/test/parser/expected/v90.out +25 -0
  295. data/pgpool2/test/parser/expected/var.out +22 -0
  296. data/pgpool2/test/parser/input/alter.sql +2 -0
  297. data/pgpool2/test/parser/input/copy.sql +17 -0
  298. data/pgpool2/test/parser/input/create.sql +64 -0
  299. data/pgpool2/test/parser/input/cursor.sql +37 -0
  300. data/pgpool2/test/parser/input/delete.sql +10 -0
  301. data/pgpool2/test/parser/input/drop.sql +12 -0
  302. data/pgpool2/test/parser/input/insert.sql +13 -0
  303. data/pgpool2/test/parser/input/misc.sql +28 -0
  304. data/pgpool2/test/parser/input/prepare.sql +4 -0
  305. data/pgpool2/test/parser/input/privileges.sql +31 -0
  306. data/pgpool2/test/parser/input/scanner.sql +34 -0
  307. data/pgpool2/test/parser/input/select.sql +89 -0
  308. data/pgpool2/test/parser/input/transaction.sql +38 -0
  309. data/pgpool2/test/parser/input/update.sql +11 -0
  310. data/pgpool2/test/parser/input/v84.sql +37 -0
  311. data/pgpool2/test/parser/input/v90.sql +38 -0
  312. data/pgpool2/test/parser/input/var.sql +22 -0
  313. data/pgpool2/test/parser/main.c +96 -0
  314. data/pgpool2/test/parser/parse_schedule +16 -0
  315. data/pgpool2/test/parser/pool.h +13 -0
  316. data/pgpool2/test/parser/run-test +62 -0
  317. data/pgpool2/test/pdo-test/README.euc_jp +58 -0
  318. data/pgpool2/test/pdo-test/SQLlist/test1.sql +3 -0
  319. data/pgpool2/test/pdo-test/SQLlist/test2.sql +3 -0
  320. data/pgpool2/test/pdo-test/collections.inc +11 -0
  321. data/pgpool2/test/pdo-test/def.inc +7 -0
  322. data/pgpool2/test/pdo-test/log.txt +0 -0
  323. data/pgpool2/test/pdo-test/mod/database.inc +36 -0
  324. data/pgpool2/test/pdo-test/mod/def.inc +0 -0
  325. data/pgpool2/test/pdo-test/mod/errorhandler.inc +27 -0
  326. data/pgpool2/test/pdo-test/pdotest.php +11 -0
  327. data/pgpool2/test/pdo-test/regsql.inc +56 -0
  328. data/pgpool2/test/pgpool_setup +898 -0
  329. data/pgpool2/test/regression/README +39 -0
  330. data/pgpool2/test/regression/clean.sh +21 -0
  331. data/pgpool2/test/regression/libs.sh +16 -0
  332. data/pgpool2/test/regression/regress.sh +166 -0
  333. data/pgpool2/test/regression/tests/001.load_balance/test.sh +128 -0
  334. data/pgpool2/test/regression/tests/002.native_replication/PgTester.java +47 -0
  335. data/pgpool2/test/regression/tests/002.native_replication/create.sql +6 -0
  336. data/pgpool2/test/regression/tests/002.native_replication/test.sh +71 -0
  337. data/pgpool2/test/regression/tests/003.failover/expected.r +6 -0
  338. data/pgpool2/test/regression/tests/003.failover/expected.s +6 -0
  339. data/pgpool2/test/regression/tests/003.failover/test.sh +45 -0
  340. data/pgpool2/test/regression/tests/004.watchdog/master.conf +12 -0
  341. data/pgpool2/test/regression/tests/004.watchdog/standby.conf +19 -0
  342. data/pgpool2/test/regression/tests/004.watchdog/test.sh +52 -0
  343. data/pgpool2/test/regression/tests/050.bug58/test.sh +50 -0
  344. data/pgpool2/test/regression/tests/051.bug60/bug.sql +12 -0
  345. data/pgpool2/test/regression/tests/051.bug60/database-clean.sql +6 -0
  346. data/pgpool2/test/regression/tests/051.bug60/database-setup.sql +28 -0
  347. data/pgpool2/test/regression/tests/051.bug60/test.sh +79 -0
  348. data/pgpool2/test/regression/tests/052.do_query/test.sh +44 -0
  349. data/pgpool2/test/regression/tests/053.insert_lock_hangs/test.sh +81 -0
  350. data/pgpool2/test/regression/tests/054.postgres_fdw/test.sh +67 -0
  351. data/pgpool2/test/regression/tests/055.backend_all_down/test.sh +52 -0
  352. data/pgpool2/test/regression/tests/056.bug63/jdbctest2.java +66 -0
  353. data/pgpool2/test/regression/tests/056.bug63/test.sh +47 -0
  354. data/pgpool2/test/regression/tests/057.bug61/test.sh +40 -0
  355. data/pgpool2/test/regression/tests/058.bug68/jdbctest3.java +45 -0
  356. data/pgpool2/test/regression/tests/058.bug68/test.sh +47 -0
  357. data/pgpool2/test/timestamp/expected/insert.out +16 -0
  358. data/pgpool2/test/timestamp/expected/misc.out +3 -0
  359. data/pgpool2/test/timestamp/expected/update.out +6 -0
  360. data/pgpool2/test/timestamp/input/insert.sql +16 -0
  361. data/pgpool2/test/timestamp/input/misc.sql +3 -0
  362. data/pgpool2/test/timestamp/input/update.sql +6 -0
  363. data/pgpool2/test/timestamp/main.c +129 -0
  364. data/pgpool2/test/timestamp/parse_schedule +3 -0
  365. data/pgpool2/test/timestamp/run-test +69 -0
  366. data/pgpool2/version.h +1 -0
  367. data/pgpool2/watchdog/Makefile.am +17 -0
  368. data/pgpool2/watchdog/Makefile.in +505 -0
  369. data/pgpool2/watchdog/test/stab.c +266 -0
  370. data/pgpool2/watchdog/test/test.c +85 -0
  371. data/pgpool2/watchdog/test/wd_child_t.c +87 -0
  372. data/pgpool2/watchdog/test/wd_lifecheck_t.c +87 -0
  373. data/pgpool2/watchdog/test/wd_packet_t.c +87 -0
  374. data/pgpool2/watchdog/test/wd_ping_t.c +20 -0
  375. data/pgpool2/watchdog/watchdog.c +408 -0
  376. data/pgpool2/watchdog/watchdog.h +209 -0
  377. data/pgpool2/watchdog/wd_child.c +444 -0
  378. data/pgpool2/watchdog/wd_ext.h +123 -0
  379. data/pgpool2/watchdog/wd_heartbeat.c +577 -0
  380. data/pgpool2/watchdog/wd_if.c +216 -0
  381. data/pgpool2/watchdog/wd_init.c +126 -0
  382. data/pgpool2/watchdog/wd_interlock.c +347 -0
  383. data/pgpool2/watchdog/wd_lifecheck.c +512 -0
  384. data/pgpool2/watchdog/wd_list.c +429 -0
  385. data/pgpool2/watchdog/wd_packet.c +1159 -0
  386. data/pgpool2/watchdog/wd_ping.c +330 -0
  387. data/pgpool2/ylwrap +223 -0
  388. data/pgsql/presto_client.py +346 -0
  389. data/pgsql/prestogres.py +156 -0
  390. data/pgsql/setup_functions.sql +21 -0
  391. data/pgsql/setup_language.sql +3 -0
  392. data/prestogres.gemspec +23 -0
  393. metadata +496 -0
data/pgpool2/doc/tutorial-watchdog-zh_cn.html ADDED
@@ -0,0 +1,301 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2
+ <html><head>
3
+ <title>pgpool-II 入门教程 [ 看门狗 ]</title>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
+ <link href="pgpool.css" rel="stylesheet" type="text/css">
6
+
7
+ <style type="text/css">
8
+ img {
9
+ border: 1px solid black;
10
+ padding: 10px;
11
+ margin-top: 15px;
12
+ margin-bottom: 15px;
13
+ }
14
+ </style>
15
+
16
+ </head>
17
+ <body bgcolor="#ffffff">
18
+
19
+
20
+ <div id="top" class="header_text">pgpool-II 入门教程 [ 看门狗 ]</div>
21
+
22
+ <div id="menu">
23
+ <div id="navcontainer">
24
+ <ul id="navlist">
25
+ <li><a href="#thisis">关于本文档</a></li>
26
+ <li><a href="#basic">基础配置</a>
27
+ <ul>
28
+ <li><a href="#basic_config">pgpool.conf</a></li>
29
+ <li><a href="#basic_start">启动 pgpool</a></li>
30
+ </ul>
31
+ </li>
32
+ <li><a href="#try">试用看门狗</a>
33
+ <ul>
34
+ <li><a href="#try_vip">连接到虚拟 IP</a></li>
35
+ <li><a href="#try_switch">切换虚拟 IP</a></li>
36
+ </ul>
37
+ </li>
38
+ <li><a href="start#more">更多内容</a>
39
+ <ul>
40
+ <li><a href="#more_lifecheck">存活检测（lifecheck）</a></li>
41
+ <li><a href="#more_switch">虚拟 IP</a></li>
42
+ </ul>
43
+ </li>
44
+ </ul>
45
+ </div>
46
+
47
+ <div class="header_small" align="center">
48
+ [<a href="tutorial-watchdog-en.html">英文页面</a>]
49
+ </div>
50
+ </div>
51
+
52
+ <div id="manual">
53
+
54
+ <!-- ================================================================================ -->
55
+
56
+ <h1 id="thisis">关于本文档</h1>
57
+
58
+ <p>在本教程中，我将讲解试用“看门狗”的简单方法。</p>
59
+ <p>你需要的是两台装有 pgpool-II 的 Linux 测试环境以及一个 PostgreSQL 安装在这些相同机器或者其他机器。
60
+ 只需要一个后端（PostgreSQL）节点就够了。
61
+ </p>
62
+ <p>你可以在任何模式中使用基于内存的查询缓存：复制模式，主/备模式和原始模式。</p>
63
+
64
+ <p>我使用 "osspc16" 作为活跃（Active）节点以及 "osspc20" 作为备用（Standby）节点。
65
+ "Someserver" 表示其中一台。</p>
66
+
67
+ <p><img src="watchdog.png" alt=""></p>
68
+
69
+ <p class="top_link"><a href="#Top">返回顶部</a></p>
70
+
71
+ <!-- ================================================================================ -->
72
+
73
+ <h1 id="basic">基础配置</h1>
74
+
75
+ <h2 id="basic_config">pgpool.conf</h2>
76
+
77
+ <h3>同时在活跃节点和备用节点中配置</h3>
78
+ <p>同时在活跃节点和备用节点中配置以下参数</p>
79
+
80
+ <h4 id="basic_config_ebable">启用看门狗</h4>
81
+ <p>首先，设置 "use_watchdog" 为 on 以启用看门狗。</p>
82
+ <pre>use_watchdog = <b>on</b>
83
+ # Activates watchdog
84
+ </pre>
85
+
86
+ <h4 id="basic_config_upper">上游服务器</h4>
87
+ <p>指定上游服务器（例如应用服务器）。留空就够了。</p>
88
+ <pre>trusted_servers = ''
89
+ # trusted server list which are used
90
+ # to confirm network connection
91
+ # (hostA,hostB,hostC,...)
92
+ </pre>
93
+
94
+ <h4 id="basic_config_watchdog">看门狗</h4>
95
+ <p>指定看门狗的端口</p>
96
+ <pre>wd_port = 9000
97
+ # port number for watchdog service
98
+ </pre>
99
+
100
+ <h4 id="basic_config_vip">虚拟 IP</h4>
101
+ <p>在 "delegate_IP" 中设置用于虚拟 IP 地址的 IP 地址，它不能被任何人使用。</p>
102
+ <pre>delegate_IP = '<b>133.137.177.143</b>'
103
+ # delegate IP address
104
+ </pre>
105
+
106
+ <h3 id="basic_config_lifecheck">监控</h3>
107
+ <p>下一步，为每个 pgpool 设置参数。</p>
108
+ <p>指定 "other_pgpool_hostname0"，"other_pgpool_port0" 和 "other_wd_port0"，对应要监控的 pgpool 和看门狗。</p>
109
+ <p>[*] other_pgpool_hostname0 必须是 hostname 命令返回的值。</p>
110
+
111
+ <h4>活跃节点 (osspc16)</h4>
112
+ <pre>other_pgpool_hostname0 = '<b>osspc20</b>'
113
+ # Host name or IP address to connect to for other pgpool 0
114
+ other_pgpool_port0 = 9999
115
+ # Port number for othet pgpool 0
116
+ other_wd_port0 = 9000
117
+ # Port number for othet watchdog 0
118
+ </pre>
119
+
120
+ <h4>备用节点 (osspc20)</h4>
121
+ <pre>other_pgpool_hostname0 = '<b>osspc16</b>'
122
+ # Host name or IP address to connect to for other pgpool 0
123
+ other_pgpool_port0 = 9999
124
+ # Port number for othet pgpool 0
125
+ other_wd_port0 = 9000
126
+ # Port number for othet watchdog 0
127
+ </pre>
128
+
129
+ <!-- -------------------------------------------------------------------------------- -->
130
+
131
+ <h2 id="basic_start">启动 pgpool</h2>
132
+
133
+ <p>以 root 身份使用 "-n" 参数（表示以非守护进程模式）启动每个 pgpool-II 并重定向日志消息到 pgpool.log 中。
134
+
135
+ <h3>启动活跃节点 (osspc16) 上的 pgpool</h3>
136
+ <p>启动活跃节点上的 pgpool。</p>
137
+ <pre>[user@osspc16]$ su -
138
+ [root@osspc16]# {installed_dir}/bin/pgpool -n -f {installed_dir}/etc/pgpool.conf &gt; pgpool.log 2&gt;&amp;1
139
+ </pre>
140
+
141
+ <p>日志显示 pgpool 获得了虚拟 IP 并启动了看门狗进程。</p>
142
+ <pre>ERROR: wd_create_send_socket: connect() is failed(Connection refused)
143
+ LOG: wd_escalation: eslcalated to master pgpool
144
+ ERROR: wd_create_send_socket: connect() is failed(Connection refused)
145
+ LOG: wd_escalation: <b>escaleted to delegate_IP holder</b>
146
+ LOG: wd_init: <b>start watchdog</b>
147
+ LOG: pgpool-II successfully started. version 3.2beta1 (namameboshi)
148
+ </pre>
149
+
150
+ <h3>启动备用节点 (osspc20) 上的 pgpool</h3>
151
+ <p>启动备用节点上的 pgpool。</p>
152
+ <pre>[user@osspc20]$ su -
153
+ [root@osspc20]# {installed_dir}/bin/pgpool -n -f {installed_dir}/etc/pgpool.conf &gt; pgpool.log 2&gt;&amp;1
154
+ </pre>
155
+
156
+ <p>当 other_pgpool_hostname 列出的所有看门狗已经启动，存活检测启动。
157
+ 在本例中，osspc16 是除了本节点之外的唯一的其他看门狗，因此存活检测已经启动了。</p>
158
+ <pre>LOG: wd_init: start watchdog
159
+ LOG: pgpool-II successfully started. version 3.2beta1 (namameboshi)
160
+ LOG: watchdog: <b>lifecheck started</b>
161
+ </pre>
162
+
163
+ <p>在活跃节点中，存活检测也启动了。</p>
164
+ <pre>LOG: watchdog: <b>lifecheck started</b>
165
+ </pre>
166
+
167
+ <p class="top_link"><a href="#Top">返回顶部</a></p>
168
+
169
+ <!-- ================================================================================ -->
170
+
171
+ <h1 id="try">试用</h1>
172
+
173
+ <h2 id="try_vip">连接到虚拟 IP</h2>
174
+ <p>通过 ping 确认虚拟 IP 地址。</p>
175
+ <pre>[user@someserver]$ ping 133.137.177.142
176
+ PING 133.137.177.143 (133.137.177.143) 56(84) bytes of data.
177
+ 64 bytes from 133.137.177.143: icmp_seq=1 ttl=64 time=0.328 ms
178
+ 64 bytes from 133.137.177.143: icmp_seq=2 ttl=64 time=0.264 ms
179
+ 64 bytes from 133.137.177.143: icmp_seq=3 ttl=64 time=0.412 ms
180
+ </pre>
181
+
182
+ <p>确定首先启动的活跃节点获得了虚拟 IP 地址。</p>
183
+ <pre>[root@osspc16]# ifconfig
184
+ eth0 ...
185
+
186
+ <b>eth0:0</b> inet addr:133.137.177.143 ...
187
+
188
+ lo ...
189
+ </pre>
190
+
191
+ <p>确定不是最先启动的备用节点没有获得虚拟 IP 地址。</p>
192
+ <pre>[root@osspc20]# ifconfig
193
+ eth0 ...
194
+
195
+ lo ...
196
+ </pre>
197
+
198
+ <p>尝试使用 "psql -h delegate_IP -p port" 连接到 PostgreSQL。</p>
199
+ <pre>[user@someserver]$ psql -h 133.137.177.142 -p 9999 -l
200
+ </pre>
201
+
202
+ <!-- -------------------------------------------------------------------------------- -->
203
+
204
+ <h2 id="try_switch">切换虚拟 IP</h2>
205
+
206
+ <p>确认在活跃节点无法提供服务的时候别用节点是如何工作的。</p>
207
+
208
+ <p>停止在活跃节点上的 pgpool。</p>
209
+ <pre>[root@osspc16]# {installed_dir}/bin/pgpool stop
210
+ </pre>
211
+
212
+ <p>然后，备用服务器开始使用虚拟 IP。日志显示：</p>
213
+ <pre>LOG: wd_escalation: <b>eslcalated to master pgpool</b>
214
+ ERROR: wd_create_send_socket: connect() is failed(Connection refused)
215
+ LOG: wd_escalation: escaleted to delegate_IP holder
216
+ </pre>
217
+
218
+ <p>通过 ping 这个 IP 地址以确认。</p>
219
+ <pre>[user@someserver]$ ping 133.137.177.142
220
+ PING 133.137.177.143 (133.137.177.143) 56(84) bytes of data.
221
+ 64 bytes from 133.137.177.143: icmp_seq=1 ttl=64 time=0.328 ms
222
+ 64 bytes from 133.137.177.143: icmp_seq=2 ttl=64 time=0.264 ms
223
+ 64 bytes from 133.137.177.143: icmp_seq=3 ttl=64 time=0.412 ms
224
+ </pre>
225
+
226
+ <p>确认原来活跃的服务器不在使用虚拟 IP 地址。</p>
227
+ <pre>[root@osspc16]# ifconfig
228
+ eth0 ...
229
+
230
+ lo ...
231
+ </pre>
232
+
233
+ <p>确认原来的备用节点使用了虚拟 IP 地址。</p>
234
+ <pre>[root@osspc20]# ifconfig
235
+ eth0 ...
236
+
237
+ <b>eth0:0</b> inet addr:133.137.177.143 ...
238
+
239
+ lo ...
240
+ </pre>
241
+
242
+ <p>尝试使用 "psql -h delegate_IP -p port" 连接到 PostgreSQL。</p>
243
+ <pre>[user@someserver]$ psql -h 133.137.177.142 -p 9999 -l
244
+ </pre>
245
+
246
+ <p class="top_link"><a href="#Top">返回顶部</a></p>
247
+
248
+ <!-- ================================================================================ -->
249
+
250
+ <h1 id="more">更多内容</h1>
251
+
252
+ <h2 id="more_lifecheck">存活检测（Lifecheck）</h2>
253
+
254
+ <p>以下为一些用于看门狗的监控的参数。</p>
255
+
256
+ <p>指定检测周期 "wd_interval"，重试次数 "wd_life_point" 以及检测用的查询语句 "wd_lifecheck_query"。</p>
257
+ <pre>wd_interval = 10
258
+ # lifecheck interval (sec) &gt; 0
259
+ wd_life_point = 3
260
+ # lifecheck retry times
261
+ wd_lifecheck_query = 'SELECT 1'
262
+ # lifecheck query to pgpool from watchdog
263
+ </pre>
264
+
265
+ <!-- -------------------------------------------------------------------------------- -->
266
+
267
+ <h2 id="more_switch">切换虚拟 IP 地址</h2>
268
+
269
+ <p>以下为一些用于切换虚拟 IP 地址的参数。</p>
270
+
271
+ <p>指定切换命令 "if_up_cmd" 和 "if_down_cmd" 以及到这些命令的路径 "ifconfig_path"，
272
+ 以及在发生切换后发送 ARP 请求的命令 "arping_cmd" 以及到这个命令的路径 "arping_path"。</p>
273
+
274
+ <pre>ifconfig_path = '/sbin'
275
+ # ifconfig command path
276
+ if_up_cmd = 'ifconfig eth0:0 inet $_IP_$ netmask 255.255.255.0'
277
+ # startup delegate IP command
278
+ if_down_cmd = 'ifconfig eth0:0 down'
279
+ # shutdown delegate IP command
280
+
281
+ arping_path = '/usr/sbin' # arping command path
282
+
283
+ arping_cmd = 'arping -U $_IP_$ -w 1'
284
+ </pre>
285
+
286
+ <p class="top_link"><a href="#Top">返回顶部</a></p>
287
+
288
+ </div>
289
+
290
+ <!-- ================================================================================ -->
291
+
292
+ <div class="copyright" style="clear: both">
293
+ <hr>
294
+ <copyright>
295
+ Copyright © 2003 – 2012 pgpool Global Development Group
296
+ </copyright>
297
+ </div>
298
+
299
+
300
+
301
+ </body></html>
data/pgpool2/doc/tutorial-zh_cn.html ADDED
@@ -0,0 +1,537 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2
+
3
+ <html>
4
+
5
+ <head>
6
+ <title>pgpool-II 入门教程</title>
7
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
8
+ <link href="pgpool.css" rel="stylesheet" type="text/css" />
9
+ </head>
10
+
11
+ <body>
12
+ <h1>pgpool-II 入门教程</h1>
13
+ <p>欢迎阅读 pgpool-II 入门教程。从本教程中，你将学会如何安装，设置 pgpool-II 以及使用 pgpool-II 运行并行查询和复制。我们假设你已经知道PostgreSQL的基础操作，所以如果有必要，请先参考 PostgreSQL 的文档。</p>
14
+
15
+ <dl>
16
+ <dt><em>目录</em></dt>
17
+ <dt>1. <a href="#start">让我们开始吧！</a></dt>
18
+ <dd>1.1. <a href="#install">安装 pgpool-II</a></dd>
19
+ <dd>1.2. <a href="#config">配置文件</a></dd>
20
+ <dd>1.3. <a href="#pcp-config">配置 PCP 命令</a></dd>
21
+ <dd>1.4. <a href="#db-node">准备数据库节点</a></dd>
22
+ <dd>1.5. <a href="#start-shutdown">启动/停止 pgpool-II</a></dd>
23
+ <dt>2. <a href="#replication">你的第一个复制</a></dt>
24
+ <dd>2.1. <a href="#replication-config">配置复制</a></dd>
25
+ <dd>2.2. <a href="#replication-check">检查复制</a></dd>
26
+ <dt>3. <a href="#parallel">你的第一个并行查询</a></dt>
27
+ <dd>3.1. <a href="#parallel-config">配置并行查询</a></dd>
28
+ <dd>3.2. <a href="#system-db">配置系统数据库</a></dd>
29
+ <dd>3.3. <a href="#dist-def">定义分发规则</a></dd>
30
+ <dd>3.4. <a href="#replicate-def">定义复制规则</a></dd>
31
+ <dd>3.5. <a href="#parallel-check">检查并行查询</a></dd>
32
+ </dl>
33
+
34
+
35
+ <h2>1. <a name="start">让我们开始吧！</a></h2>
36
+
37
+ <p>首先，在使用复制和并行查询前，我们必须学习如何安装、配置 pgpool-II 和数据库节点。</p>
38
+
39
+ <h3>1.1. <a name="install">安装 pgpool-II</a></h3>
40
+
41
+ <p>安装 pgpool-II 非常简单。在你解压源码 tar 包的目录中，执行以下命令。</p>
42
+
43
+ <pre>
44
+ $ ./configure
45
+ $ make
46
+ $ make install
47
+ </pre>
48
+
49
+ <p><code>configure</code> 脚本收集你的系统信息并用于编译过程。你可以通过传递命令行参数到 <code>configure</code> 脚本来改变它的默认行为，例如安装目录。默认情况下，pgpool-II将安装到 <code>/usr/local</code> 目录。</p>
50
+
51
+ <p><code>make</code> 命令编译源码，<code>make install</code> 命令将安装执行文件。你必须对安装目录有写入权限。</p>
52
+
53
+ <p>在本教材中，我们将安装 pgpool-II 到默认的 <code>/usr/local</code> 目录中。</p>
54
+
55
+ <p><em>注</em>: pgpool-II 需要 PostgreSQL 7.4 或更高版本（版本 3 的协议）的 libpq 。如果 <code>configure</code> 脚本显示以下的错误信息，则可能是 libpq 库没有被安装或者它不是版本 3 的。</p>
56
+
57
+ <pre>configure: error: libpq is not installed or libpq is old</pre>
58
+
59
+ <p>如果是版本 3 的库，但还是显示了以上消息，则你的 libpq 库可能无法被 <code>configure</code> 脚本识别。</p>
60
+
61
+ <p><code>configure</code> 脚本会在 <code>/usr/local/pgsql</code> 目录搜索 libpq 库。如果你安装 PostgreSQL 到 <code>/usr/local/pgsql</code> 之外的其他目录，在执行 <code>configure</code> 时，请使用 <code>--with-pgsql</code> ，或者同时使用 <code>--with-pgsql-includedir</code> 和 <code>--with-pgsql-libdir</code> 的命令行选项。</p>
62
+
63
+ <h3>1.2. <a name="config">配置文件</a></h3>
64
+
65
+ <p>pgpool-II 的配置参数保存在 <code>pgpool.conf</code> 文件中。文件以每行 “<code>parameter = value</code>” 的格式保存。当你安装 pgpool-II 后， <code>pgpool.conf.sample</code> 被自动建立。我们建议拷贝或者重命名它为 <code>pgpool.conf</code> ，然后你可以随意编辑它。</p>
66
+
67
+ <pre>$ cp /usr/local/etc/pgpool.conf.sample /usr/local/etc/pgpool.conf</pre>
68
+
69
+ <p>pgpool-II 默认只接受到 9999 端口的本地连接。如果你希望从其他主机接受连接，请设置 <code>listen_addresses</code> 为 '*'.</code></p>
70
+
71
+ <pre>
72
+ listen_addresses = 'localhost'
73
+ port = 9999
74
+ </pre>
75
+
76
+ <p>在本教程中我们将使用默认参数。</p>
77
+
78
+ <h3>1.3. <a name="pcp-config">配置 PCP 命令</a></h3>
79
+
80
+ <p>pgpool-II 有一个用于管理功能的接口，用于通过网络获取数据库节点信息、关闭 pgpool-II 等。要使用 PCP 命令，必须进行用户认证。这种认证和 PostgreSQL 的用户认证不同。这需要在 <code>pcp.conf<code> 文件中定义一个用户和密码。在这个文件中，一个用户名和密码成对地出现在每一行中，它们用冒号（:）隔开。密码为用 md5 哈希加密的格式。</p>
81
+
82
+ <pre>postgres:e8a48653851e28c69d0506508fb27fc5</pre>
83
+ <p>在你安装 pgpool-II时， <code>pcp.conf.sample</code> 被自动建立。我们建议复制一份并重命名为 <code>pcp.conf</code> 并且编辑它。</p>
84
+ <pre>$ cp /usr/local/etc/pcp.conf.sample /usr/local/etc/pcp.conf</pre>
85
+
86
+ <p>为了加密你的密码为 md5 哈希格式，请使用 pg_md5 命令，它作为 pgpool-II 执行文件套件的一部分被安装。<code>pg_md5</code> 使用一个命令行参数，并显示它的 md5 哈希文本。</p>
87
+
88
+ <p>例如，使用 “postgres” 作为命令行参数，<code>pg_md5</code> 会显示 md5 哈希的文本到标准输出。</p>
89
+
90
+ <pre>
91
+ $ /usr/bin/pg_md5 postgres
92
+ e8a48653851e28c69d0506508fb27fc5
93
+ </pre>
94
+
95
+ <p>PCP 命令通过网络执行，所以必须在 <code>pgpool.conf</code> 文件中配置 <code>pcp_port</code> 端口。</p>
96
+
97
+ <p>在本教程中，我们将使用默认的 9898 作为 <code>pcp_port</code> 的参数。</p>
98
+
99
+ <pre>pcp_port = 9898</pre>
100
+
101
+ <h3>1.4. <a name="db-node">准备数据库节点</a></h3>
102
+
103
+ <p>现在，我们需要设置用于 pgpool-II 的后台 PostgreSQL 服务器了。这些服务器可以与 pgpool-II 在同一台主机上，也可以在独立的主机上。如果你决定将所有服务器都放在同一台主机上，必须为每个服务分配不同的端口。如果服务器被安置在不同的机器上，他们必须被正确以便可以通过网络接受 pgpool-II 的连接。</p>
104
+
105
+ <p>在本教程中，我们将三台服务器放在与 pgpool-II 相同的机器上，分别给它们分配端口号 5432，5433，5434。要配置 pgpool-II，请如下编辑 <code>pgpool.conf</code>。<pre>
106
+ backend_hostname0 = 'localhost'
107
+ backend_port0 = 5432
108
+ backend_weight0 = 1
109
+ backend_hostname1 = 'localhost'
110
+ backend_port1 = 5433
111
+ backend_weight1 = 1
112
+ backend_hostname2 = 'localhost'
113
+ backend_port2 = 5434
114
+ backend_weight2 = 1
115
+ </pre>
116
+
117
+ <p>
118
+ 分别为 <code>backend_hostname</code>，<code>backend_port</code>，<code>backend_weight</code> 设置节点的主机名，端口号和负载均衡系数。在每个参数串的后面，必须通过添加从0开始（例如 0，1，2，&hellip;）的整数来指出节点编号。
119
+ </p>
120
+
121
+ <p><code>backend_weight</code> 参数都为 1 ，这意味着 SELECT 查询被平均分配到三台服务器上。</p>
122
+
123
+ <h3>1.5. <a name="start-shutdown">启动/停止 pgpool-II</a></h3>
124
+
125
+ <p>要启动 pgpool-II，在终端中执行以下命令。</p>
126
+
127
+ <pre>$ pgpool</pre>
128
+
129
+ <p>
130
+ 然而，以上的命令不打印日志信息，因为 pgpool 脱离终端了。如果你想显示 pgpool 日志信息，你需要传递 <code>-n</code> 到 pgpool 命令。此时 pgpool-II 作为非守护进程模式运行，也就不会脱离终端了。
131
+ </p>
132
+
133
+ <pre>
134
+ $ pgpool -n &
135
+ </pre>
136
+
137
+ <p>日志消息会打印到终端，所以推荐使用如下的选项。</p>
138
+
139
+ <pre>$ pgpool -n -d &gt; /tmp/pgpool.log 2&gt;&1 &</pre>
140
+
141
+ <p><code>-d</code> 选项启用调试信息生成。</p>
142
+
143
+ <p>
144
+ 以上命令持续追加日志消息到 <code>/tmp/pgpool.log</code> 中。如果你需要切换日志文件，可以将日志传递到一个支持日志轮换功能的外部命令。例如，你可以使用 Apache2 带的 rotatelogs 工具。
145
+ </p>
146
+
147
+ <pre>
148
+ $ pgpool -n 2>&1 | /usr/local/apache2/bin/rotatelogs \
149
+ -l -f /var/log/pgpool/pgpool.log.%A 86400 &
150
+ </pre>
151
+ <p>这将生成名称类似于 “<code>pgpool.log.Thursday</code>” 的日志文件，然后在每天午夜 00:00 轮换日志文件。如果日志文件已经存在，rotatelogs 将追加日志到这个文件中。如果想在轮换前删除旧日志文件，你可以使用 cron：</p>
152
+ <pre>
153
+ 55 23 * * * /usr/bin/find /var/log/pgpool -type f -mtime +5 -exec /bin/rm -f '{}' \;
154
+ </pre>
155
+ <p>
156
+ 请注意 rotatelogs 在某些发行版中可能存在于 <code> /usr/sbin/rotatelogs2 </code> 。-f 选项让 rotatelogs 在启动的时候生成一个日志文件，这个功能随 apache 2.2.9 或更高版本提供。
157
+ </p>
158
+
159
+ <p>
160
+ 而且 <a href="http://www.cronolog.org"><code>cronolog</code></a> 对你可能有用。
161
+ </p>
162
+
163
+ <pre>
164
+ $ pgpool -n 2>&1 | /usr/sbin/cronolog \
165
+ --hardlink=/var/log/pgsql/pgpool.log \
166
+ '/var/log/pgsql/%Y-%m-%d-pgpool.log' &
167
+ </pre>
168
+
169
+ <p>要停止 pgpool-II 进程，执行以下的命令。</p>
170
+
171
+ <pre>$ pgpool stop</pre>
172
+
173
+ <p>
174
+ 如果还有客户端连接着， pgpool-II 等待它们断开连接，然后才结束运行。如果你想强制关闭 pgpool-II ，执行以下的命令来代替之前的命令。
175
+ </p>
176
+
177
+ <pre>$ pgpool -m fast stop</pre>
178
+
179
+ <h2>2. <a name="replication">你的第一个复制</a></h2>
180
+
181
+ <p>复制可以让相同的数据拷贝到多个数据库节点。</p>
182
+
183
+ <p>
184
+ 在本节中，我们将使用三个已经在“1. <a href="#start">让我们开始吧！</a>”小节中设置好了的数据库节点，一步步建立数据库复制系统。用于复制的示例数据将由 pgbench 基准测试程序生成。
185
+ </p>
186
+
187
+ <h3>2.1. <a name="replication-config">配置复制</a></h3>
188
+
189
+ <p>要启用数据库复制功能，需要设置 <code>pgpool.conf</code> 文件中的 <code>replication_mode</code> 为 true 。</p>
190
+
191
+ <pre>replication_mode = true</pre>
192
+
193
+ <p>当 <code>replication_mode</code> 被设置为 true，pgpool-II 将发送一份接收到的查询的拷贝到所有的数据库节点。</p>
194
+
195
+ <p>当 <code>load_balance_mode</code> 被设置为 true，pgpool-II 将在数据库节点之间分发 SELECT 查询。</p>
196
+
197
+ <pre>load_balance_mode = true</pre>
198
+
199
+ <p>在本章中，我们将同时启用 <code>replication_mode</code> 和 <code>load_balance_mode</code> 。</p>
200
+
201
+ <h3>2.2. <a name="replication-check">检查复制</a></h3>
202
+
203
+ <p>要使 <code>pgpool.conf</code> 中的改动生效，必须重启 pgpool-II 。请参考“1.5 <a href="#start-shutdown">启动/停止 pgpool-II</a>”小节。</p>
204
+
205
+ <p>在配置完 <code>pgpool.conf</code> 且重新启动 pgpool-II 后，让我们试试复制，检查它是否工作正常。</p>
206
+
207
+ <p>首先，我们需要建立一个用于复制的数据库。我们将给它命名为“bench_replication”。这个数据库需要被建立在所有的节点中。在 pgpool-II 中使用 <code>createdb</code> 命令，数据库将被在所有节点中建立。</p>
208
+
209
+ <pre>$ createdb -p 9999 bench_replication</pre>
210
+
211
+ <p>然后，使用 <code>-i</code> 选项执行 pgbench。<code>-i</code> 使用预设的表和数据初始化这个数据库。</p>
212
+
213
+ <pre>$ pgbench -i -p 9999 bench_replication</pre>
214
+
215
+ <p>下表是通过 <code>pgbench -i</code> 建立的表和数据的摘要。如果在所有的节点中，列出的表和数据都被建立了，则说明复制运行正常。</p>
216
+
217
+ <table border="1" align="center">
218
+ <tr>
219
+ <th>表名</th>
220
+ <th>行数</th>
221
+ </tr>
222
+ <tr>
223
+ <td>branches</td>
224
+ <td>1</td>
225
+ </tr>
226
+ <tr>
227
+ <td>tellers</td>
228
+ <td>10</td>
229
+ </tr>
230
+ <tr>
231
+ <td>accounts</td>
232
+ <td>100000</td>
233
+ </tr>
234
+ <tr>
235
+ <td>history</td>
236
+ <td>0</td>
237
+ </tr>
238
+ </table>
239
+
240
+ <p>让我们使用一个简单的 shell 脚本在所有节点中检查以上内容。以下脚本将显示所有的节点中 branches，tellers，accounts 和 history 表的行数。</p>
241
+
242
+ <pre>$ for port in 5432 5433 5434; do
243
+ &gt; echo $port
244
+ &gt; for table_name in branches tellers accounts history; do
245
+ &gt; echo $table_name
246
+ &gt; psql -c &quot;SELECT count(*) FROM $table_name&quot; -p $port bench_replication
247
+ &gt; done
248
+ &gt; done
249
+ </pre>
250
+
251
+ <h2>3. <a name="parallel">你的第一个并行查询</a></h2>
252
+ <p>
253
+ 在并行查询中，不同范围的数据存储在两个或更多数据库节点中。这叫做分区。而且，即使在并行查询模式中，你也可以在数据库节点之间对一些表进行复制。
254
+ </p>
255
+
256
+ <p>为了在 pgpool-II 中启用并行查询，你必须设置另一个叫做“系统数据库”的数据库（本系统数据库为 pgpool-II 使用的用于存放信息的数据库）。</p>
257
+
258
+ <p>系统数据库包含用户定义的用来确定数据将包含到哪个数据库中的规则。另一个系统数据库的用途是使用 dblink 将从数据库节点发回的数据合并。</p>
259
+
260
+ <p>
261
+ 在本章，我们将使用我们在“1. <a href="#start">让我们开始吧！</a>”小节中设置好的三个数据库节点，并带领你一步步建立一个并行查询数据库系统。我们同样会再次使用 pgbench 来创建示例数据。
262
+ </p>
263
+
264
+ <h3>3.1. <a name="parallel-config">配置并行查询</a></h3>
265
+
266
+ <p>要启用并行查询功能，请设置 <code>pgpool.conf</code> 文件中的<code>parallel_mode</code> 为 true 。</p>
267
+
268
+ <pre>parallel_mode = true</pre>
269
+
270
+ <p>仅仅设置 <code>paralle_mode</code> 为 true 不会自动启动并行查询。pgpool-II 需要系统数据库和用于分发数据到数据库节点的规则。</p>
271
+
272
+ <p>而且，系统数据库使用的 dblink 需要连接到 pgpool-II。因此，需要设置 <code>listen_addresses</code> 以便 pgpool-II 接受这些连接。</p>
273
+
274
+ <pre>listen_addresses = '*'</pre>
275
+
276
+ <p>
277
+ 注意：进行了分区的表不会进行复制，不过并行查询和复制可以同时生效。
278
+ </p>
279
+
280
+ <p>
281
+ 注意：你可以同时拥有分区表和复制表。但是一个表不能同时被分区和复制。因为分区表和复制表的结构不同，“2. <a href="#replication">你的第一个复制</a>”小节中建立的“bench_replication”数据库无法用于并行查询模式。
282
+ </p>
283
+
284
+ <pre>
285
+ replication_mode = true
286
+ load_balance_mode = false
287
+ </pre>
288
+ <p>
289
+ 或者
290
+ </p>
291
+ <pre>
292
+ replication_mode = false
293
+ load_balance_mode = true
294
+ </pre>
295
+
296
+ <p>在本小节，我们将设置 <code>parallel_mode</code> 和 <code>load_balance_mode</code> 为 true，<code>listen_addresses</code> 为 '*'，<code>replication_mode</code>为 false 。</p>
297
+
298
+ <h3>3.2. <a name="system-db">配置系统数据库</a></h3>
299
+
300
+ <p>
301
+ “系统数据库”实际上就是一个普通的数据库。只是必须在系统数据库中安装 dblink 函数和用于描述分区规则的 dist_def 表。你可以让系统数据库存放于某个数据库节点中，也可以通过级联的方式配置 pgpool-II，让多个数据库节点拥有系统数据库。
302
+ </p>
303
+
304
+ <p>在本小节，我们将在 5432 端口的节点建立 SystemDB。以下列出了系统数据库的配置参数。</p>
305
+
306
+ <pre>
307
+ system_db_hostname = 'localhost'
308
+ system_db_port = 5432
309
+ system_db_dbname = 'pgpool'
310
+ system_db_schema = 'pgpool_catalog'
311
+ system_db_user = 'pgpool'
312
+ system_db_password = ''
313
+ </pre>
314
+
315
+ <p>实际上，以上为 <code>pgpool.conf</code> 的默认设置。现在，我们必须建立一个叫做“pgpool”的用户，并建立一个属主为“pgpool”的名为“pgpool”的数据库。</p>
316
+
317
+ <pre>
318
+ $ createuser -p 5432 pgpool
319
+ $ createdb -p 5432 -O pgpool pgpool
320
+ </pre>
321
+
322
+ <h4><p>3.2.1. 安装 dblink</p></h4>
323
+
324
+ <p>然后，我们必须在“pgpool”数据库中安装 dblink。dblink 是包含在 PostgreSQL 源码包 <code>contrib</code> 目录中包含的一个工具。</p>
325
+
326
+ <p>要在你的系统中安装 dblink，请执行以下命令。</p>
327
+
328
+ <pre>
329
+ $ USE_PGXS=1 make -C contrib/dblink
330
+ $ USE_PGXS=1 make -C contrib/dblink install
331
+ </pre>
332
+
333
+ <p>在 dblink 被安装到你的系统中后，我们将在“pgpool”数据库中定义 dblink 函数。如果 PostgreSQL 被安装到 <code>/usr/local/pgsql</code>，<code>dblink.sql</code>（一个包含函数定义的文件）应该被安装到了 <code>/usr/local/pgsql/share/contrib</code>。那么，执行以下的命令来定义 dblink 函数。</p>
334
+
335
+ <pre>$ psql -f /usr/local/pgsql/share/contrib/dblink.sql -p 5432 pgpool</pre>
336
+
337
+ <h4><p>3.2.2. 定义 dist_def 表</p></h4>
338
+
339
+ <p>
340
+ 在数据库“pgpool”中定义一个“dist_def”表，用于保存分区规则。在 pgpool-II 安装后，你会得到一个 <code>system_db.sql</code>，它是一个可用于生成系统数据库的 <code>psql</code> 脚本。
341
+ </p>
342
+ <pre>
343
+ $ psql -f /usr/local/share/system_db.sql -p 5432 -U pgpool pgpool
344
+ </pre>
345
+ <p> dist_def 表被建立到 pgpool_catalog 这个 schema 中。如果你配置 <code>system_db_schema</code> 使用了其他的 schema，你需要相应地编辑 <code>system_db.sql</code>。</p>
346
+
347
+ <p>“dist_def的定义如下，且表名不能被改变。</p>
348
+
349
+ <pre>
350
+ CREATE TABLE pgpool_catalog.dist_def (
351
+ dbname text, -- database name
352
+ schema_name text, -- schema name
353
+ table_name text, -- table name
354
+ col_name text NOT NULL CHECK (col_name = ANY (col_list)), -- distribution key-column
355
+ col_list text[] NOT NULL, -- list of column names
356
+ type_list text[] NOT NULL, -- list of column types
357
+ dist_def_func text NOT NULL, -- distribution function name
358
+ PRIMARY KEY (dbname, schema_name, table_name)
359
+ );
360
+ </pre>
361
+
362
+ <p>“dist_def”中保存的 tuple 可以被分为两类。</p>
363
+
364
+ <ul>
365
+ <li>分发规则 (col_name, dist_def_func)</li>
366
+ <li>表的元信息 (dbname, schema_name, table_name, col_list, type_list)</li>
367
+ </ul>
368
+
369
+ <p>
370
+ 分发规则确定如何分发数据到特定节点。数据将依赖“col_name”的值来进行分发。“dist_def_func”是一个函数，它使用“col_name”列的值做参数，返回一个指出数据将要存储的数据库节点 ID 的适当整数。
371
+ </p>
372
+
373
+ <p>元信息用于重写查询。并行查询必须重写查询比便让从后台节点返回的数据可以被合并为一个结果集。</p>
374
+
375
+ <h4><p>3.2.2. 定义 replicate_def 表</p></h4>
376
+ <p>
377
+ 如果你想在 SELECT 语句的并行模式中使用复制的表，你需要在一个叫做 replicate_def 的表中注册这些表的信息（复制规则）。replicate_def 表在定义 dist_def 表的时候已经由 system_db.sql 创建。replicate_def 表的定义如下。
378
+ </p>
379
+ <pre>
380
+ CREATE TABLE pgpool_catalog.replicate_def (
381
+ dbname text, -- database name
382
+ schema_name text, -- schema name
383
+ table_name text, -- table name
384
+ col_list text[] NOT NULL, -- list of column names
385
+ type_list text[] NOT NULL, -- list of column types
386
+ PRIMARY KEY (dbname, schema_name, table_name)
387
+ );
388
+ </pre>
389
+ <p>
390
+ replicate_def 包含了表的元数据信息 (dbname, schema_name, table_name, col_list, type_list)。
391
+ </p>
392
+ <p>
393
+ 所有的查询分析和查询重写过程都依赖于存储于 dist_def 以及/或 replicate_def 表中的这些信息（表，列以及类型）。
394
+ 如果信息不正确，分析和查询重写过程将导致错误的结果。
395
+ </p>
396
+
397
+ <h3>3.3. <a name="dist-def">定义分发规则</a></h3>
398
+
399
+ <p>
400
+ 在本教材中，我们将定义规则用于分发 pgbench 的示例数据到三个数据库节点中。示例数据将通过“<code>pgbench -i -s 3</code>”（例如比例因子为3）建立。在本小节，我们将建立一个叫“bench_parallel”的新数据库。
401
+ </p>
402
+
403
+ <p>
404
+ 在 pgpool-II 的源码中在，你可以在 <code>sample</code> 目录中找到 <code>dist_def_pgbench.sql</code> 文件。我们将使用这个示例文件来为 pgbench 建立分发规则。在解压后的 pgpool-II 的源码目录中执行以下命令。
405
+ </p>
406
+
407
+ <pre>$ psql -f sample/dist_def_pgbench.sql -p 5432 pgpool</pre>
408
+
409
+ <p>以下为 <code>dist_def_pgbench.sql</code> 的说明。</p>
410
+
411
+ <p>在 <code>dist_def_pgbench.sql</code>中，我们往“dist_def”表中插入一行。这里有一个为 accounts 表准备的分发函数。作为关键列，aid 被定义在每个 accounts 表中（也是主键）。</p>
412
+
413
+ <pre>
414
+ INSERT INTO pgpool_catalog.dist_def VALUES (
415
+ 'bench_parallel',
416
+ 'public',
417
+ 'accounts',
418
+ 'aid',
419
+ ARRAY['aid', 'bid', 'abalance', 'filler'],
420
+ ARRAY['integer', 'integer', 'integer', 'character(84)'],
421
+ 'pgpool_catalog.dist_def_accounts'
422
+ );
423
+ </pre>
424
+
425
+ <p>
426
+ 现在，我们必须为 accounts 表定义分发函数。注意你可以对不同的表使用相同的函数。而且，你可以使用 SQL 之外的语言定义函数（例如 PL/pgSQL，PL/Tcl 等等）。
427
+ </p>
428
+
429
+ <p>accounts 表在初始化时指定了比例因子为 3，aid 的值为 1 到 300000。函数被定义为使数据平均分布到三个数据库节点中。</p>
430
+
431
+ <p>
432
+ SQL 函数将定义为返回数据库节点的编号。</p>
433
+
434
+ </p>
435
+ <pre>CREATE OR REPLACE FUNCTION pgpool_catalog.dist_def_branches(anyelement)
436
+ RETURNS integer AS $$
437
+ SELECT CASE WHEN $1 &gt; 0 AND $1 &lt;= 1 THEN 0
438
+ WHEN $1 &gt; 1 AND $1 &lt;= 2 THEN 1
439
+ ELSE 2
440
+ END;
441
+ $$ LANGUAGE sql;
442
+ </pre>
443
+
444
+ <h3>3.4. <a name="replicate-def">定义复制规则</a></h3>
445
+ <p>复制规则是定义某个表是否被复制的规则。</p>
446
+
447
+ <p>
448
+ 以下表是 pgbench 生成的。branches 表和 tellers 表已经注册。作为结果，accounts 表和使用 branches 表和 tellers 表的查询已经可用。
449
+ </p>
450
+ <pre>
451
+ INSERT INTO pgpool_catalog.replicate_def VALUES (
452
+ 'bench_parallel',
453
+ 'public',
454
+ 'branches',
455
+ ARRAY['bid', 'bbalance', 'filler'],
456
+ ARRAY['integer', 'integer', 'character(88)']
457
+ );
458
+
459
+ INSERT INTO pgpool_catalog.replicate_def VALUES (
460
+ 'bench_parallel',
461
+ 'public',
462
+ 'tellers',
463
+ ARRAY['tid', 'bid', 'tbalance', 'filler'],
464
+ ARRAY['integer', 'integer', 'integer', 'character(84)']
465
+ );
466
+ </pre>
467
+ <p>
468
+ 在 sample 目录中已经准备好了 replicate_def_pgbench.sql 文件。在源码目录中使用以下方法来定义一个复制规则。执行以下 psql 命令。
469
+ </p>
470
+
471
+ <pre>
472
+ $ psql -f sample/replicate_def_pgbench.sql -p 5432 pgpool
473
+ </pre>
474
+
475
+ <h3>3.5. <a name="parallel-check">检查并行查询</a></h3>
476
+
477
+ <p>要使 <code>pgpool.conf</code> 中的改动生效，pgpool-II 必须重启。请参考“1.5 <a href="#start-shutdown">启动/停止 pgpool-II</a>”小节。</p>
478
+
479
+ <p>在配置好 <code>pgpool.conf</code> 并重启 pgpool-II 后，让我们试试并查看并行查询是否运行正常。</p>
480
+
481
+ <p>
482
+ 首先，我们需要建立一个用于分发的数据库。我们将给它命名为“bench_parallel”。这个数据库需要在所有节点上被建立。通过 pgpool-II 使用 <code>createdb</code> 命令，则数据库将被奖励在所有节点上。
483
+ </p>
484
+
485
+ <pre>$ createdb -p 9999 bench_parallel</pre>
486
+
487
+ <p>然后，我们将使用 <code>-i -s 3</code> 选项执行 pgbench 。<code>-i</code> 选项使用预定义的表和数据初始化数据库。 <code>-s</code> 选项指出用于初始化的比例因子。</p>
488
+
489
+ <pre>$ pgbench -i -s 3 -p 9999 bench_parallel</pre>
490
+
491
+ <p>建立的表和数据在 “3.3. <a href="#dist-def">定义分发规则</a>”小节中列出来了。</p>
492
+
493
+ <p>
494
+ 检查数据是否被正确分发的一个方法是通过 pgpool-II 和直接在后台节点执行一个 SELECT 查询，然后比较两个结果。如果所有都配置正确，“bench_parallel”应该按以下样子分布。
495
+ </p>
496
+
497
+ <table border="1" align ="center">
498
+ <tr>
499
+ <th >表名</th>
500
+ <th >行数</th>
501
+ </tr>
502
+ <tr>
503
+ <td>branches</td>
504
+ <td>3</td>
505
+ </tr>
506
+ <tr>
507
+ <td>tellers</td>
508
+ <td>30</td>
509
+ </tr>
510
+ <tr>
511
+ <td>accounts</td>
512
+ <td>300000</td>
513
+ </tr>
514
+ <tr>
515
+ <td>history</td>
516
+ <td>0</td>
517
+ </tr>
518
+ </table>
519
+
520
+ <p>
521
+ 让我们使用一段简单的 shell 脚本来在所有的节点上和通过 pgpool-II 检查以上的内容。以下脚本将使用 5432，5433,5434 和 9999 端口显示 accounts 表中最小和最大的值。
522
+ </p>
523
+
524
+ <pre>$ for port in 5432 5433 5434 9999; do
525
+ &gt; echo $port
526
+ &gt; psql -c &quot;SELECT min(aid), max(aid) FROM accounts&quot; -p $port bench_parallel
527
+ &gt; done
528
+ </pre>
529
+
530
+ <div class="copyright">
531
+ <hr>
532
+ <copyright>
533
+ Copyright &copy; 2003 &ndash; 2011 pgpool Global Development Group
534
+ </copyright>
535
+ </div>
536
+ </body>
537
+ </html>