rroonga 3.0.9-x86-mingw32 → 3.1.0-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (438) hide show
  1. checksums.yaml +4 -4
  2. data/README.textile +10 -10
  3. data/bin/groonga-database-inspect +40 -0
  4. data/doc/text/news.textile +19 -0
  5. data/ext/groonga/extconf.rb +3 -1
  6. data/ext/groonga/rb-grn-expression.c +1 -1
  7. data/ext/groonga/rb-grn-operator.c +218 -8
  8. data/ext/groonga/rb-grn.h +4 -2
  9. data/lib/1.9/groonga.so +0 -0
  10. data/lib/2.0/groonga.so +0 -0
  11. data/lib/2.1/groonga.so +0 -0
  12. data/lib/groonga.rb +4 -1
  13. data/lib/groonga/column.rb +25 -0
  14. data/lib/groonga/database-inspector.rb +279 -0
  15. data/lib/groonga/database.rb +32 -2
  16. data/lib/groonga/dumper.rb +7 -13
  17. data/lib/groonga/index-column.rb +11 -1
  18. data/lib/groonga/statistic-measurer.rb +37 -0
  19. data/lib/groonga/table.rb +25 -0
  20. data/rroonga-build.rb +2 -2
  21. data/test/groonga-test-utils.rb +10 -10
  22. data/test/test-column.rb +26 -0
  23. data/test/test-database-inspector.rb +676 -0
  24. data/test/test-database.rb +25 -1
  25. data/test/test-expression-builder.rb +1 -0
  26. data/test/test-expression.rb +73 -0
  27. data/test/test-index-column.rb +23 -0
  28. data/test/test-statistic-measurer.rb +55 -0
  29. data/test/test-table.rb +40 -0
  30. data/vendor/local/bin/groonga-benchmark.exe +0 -0
  31. data/vendor/local/bin/groonga.exe +0 -0
  32. data/vendor/local/bin/libgroonga-0.dll +0 -0
  33. data/vendor/local/bin/libmecab-1.dll +0 -0
  34. data/vendor/local/bin/libmsgpack-3.dll +0 -0
  35. data/vendor/local/bin/libmsgpackc-2.dll +0 -0
  36. data/vendor/local/bin/mecab-config +0 -0
  37. data/vendor/local/bin/mecab.exe +0 -0
  38. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.a +0 -0
  39. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll +0 -0
  40. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll.a +0 -0
  41. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.la +0 -0
  42. data/vendor/local/lib/groonga/plugins/suggest/suggest.a +0 -0
  43. data/vendor/local/lib/groonga/plugins/suggest/suggest.dll +0 -0
  44. data/vendor/local/lib/groonga/plugins/suggest/suggest.dll.a +0 -0
  45. data/vendor/local/lib/groonga/plugins/suggest/suggest.la +0 -0
  46. data/vendor/local/lib/groonga/plugins/table/table.a +0 -0
  47. data/vendor/local/lib/groonga/plugins/table/table.dll +0 -0
  48. data/vendor/local/lib/groonga/plugins/table/table.dll.a +0 -0
  49. data/vendor/local/lib/groonga/plugins/table/table.la +0 -0
  50. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.a +0 -0
  51. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll +0 -0
  52. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll.a +0 -0
  53. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.la +0 -0
  54. data/vendor/local/lib/libgroonga.a +0 -0
  55. data/vendor/local/lib/libgroonga.dll.a +0 -0
  56. data/vendor/local/lib/libgroonga.la +0 -0
  57. data/vendor/local/lib/libmecab.a +0 -0
  58. data/vendor/local/lib/libmecab.dll.a +0 -0
  59. data/vendor/local/lib/libmecab.la +0 -0
  60. data/vendor/local/lib/libmsgpack.a +0 -0
  61. data/vendor/local/lib/libmsgpack.dll.a +0 -0
  62. data/vendor/local/lib/libmsgpack.la +0 -0
  63. data/vendor/local/lib/libmsgpackc.a +0 -0
  64. data/vendor/local/lib/libmsgpackc.dll.a +0 -0
  65. data/vendor/local/lib/libmsgpackc.la +0 -0
  66. data/vendor/local/lib/pkgconfig/groonga.pc +2 -2
  67. data/vendor/local/libexec/mecab/mecab-cost-train.exe +0 -0
  68. data/vendor/local/libexec/mecab/mecab-dict-gen.exe +0 -0
  69. data/vendor/local/libexec/mecab/mecab-dict-index.exe +0 -0
  70. data/vendor/local/libexec/mecab/mecab-system-eval.exe +0 -0
  71. data/vendor/local/libexec/mecab/mecab-test-gen.exe +0 -0
  72. data/vendor/local/sbin/groonga-httpd-restart +0 -0
  73. data/vendor/local/share/doc/groonga/en/html/.buildinfo +1 -1
  74. data/vendor/local/share/doc/groonga/en/html/_sources/install/centos.txt +7 -7
  75. data/vendor/local/share/doc/groonga/en/html/_sources/install/debian.txt +3 -3
  76. data/vendor/local/share/doc/groonga/en/html/_sources/install/fedora.txt +3 -3
  77. data/vendor/local/share/doc/groonga/en/html/_sources/install/mac_os_x.txt +3 -3
  78. data/vendor/local/share/doc/groonga/en/html/_sources/install/others.txt +3 -3
  79. data/vendor/local/share/doc/groonga/en/html/_sources/install/solaris.txt +3 -3
  80. data/vendor/local/share/doc/groonga/en/html/_sources/install/ubuntu.txt +3 -3
  81. data/vendor/local/share/doc/groonga/en/html/_sources/install/windows.txt +25 -39
  82. data/vendor/local/share/doc/groonga/en/html/_sources/news.txt +41 -0
  83. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/ruby_load.txt +1 -1
  84. data/vendor/local/share/doc/groonga/en/html/_sources/reference/executables/groonga-benchmark.txt +273 -0
  85. data/vendor/local/share/doc/groonga/en/html/_sources/suggest/completion.txt +16 -6
  86. data/vendor/local/share/doc/groonga/en/html/characteristic.html +5 -5
  87. data/vendor/local/share/doc/groonga/en/html/community.html +5 -5
  88. data/vendor/local/share/doc/groonga/en/html/contribution.html +5 -5
  89. data/vendor/local/share/doc/groonga/en/html/contribution/development.html +5 -5
  90. data/vendor/local/share/doc/groonga/en/html/contribution/development/com.html +5 -5
  91. data/vendor/local/share/doc/groonga/en/html/contribution/development/cooperation.html +5 -5
  92. data/vendor/local/share/doc/groonga/en/html/contribution/development/document.html +5 -5
  93. data/vendor/local/share/doc/groonga/en/html/contribution/development/query.html +5 -5
  94. data/vendor/local/share/doc/groonga/en/html/contribution/development/release.html +5 -5
  95. data/vendor/local/share/doc/groonga/en/html/contribution/development/repository.html +5 -5
  96. data/vendor/local/share/doc/groonga/en/html/contribution/development/test.html +5 -5
  97. data/vendor/local/share/doc/groonga/en/html/contribution/documentation.html +5 -5
  98. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/c-api.html +5 -5
  99. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/i18n.html +5 -5
  100. data/vendor/local/share/doc/groonga/en/html/contribution/report.html +5 -5
  101. data/vendor/local/share/doc/groonga/en/html/development.html +5 -5
  102. data/vendor/local/share/doc/groonga/en/html/development/travis-ci.html +5 -5
  103. data/vendor/local/share/doc/groonga/en/html/genindex.html +19 -19
  104. data/vendor/local/share/doc/groonga/en/html/geolocation_search.html +5 -5
  105. data/vendor/local/share/doc/groonga/en/html/index.html +7 -7
  106. data/vendor/local/share/doc/groonga/en/html/install.html +5 -5
  107. data/vendor/local/share/doc/groonga/en/html/install/centos.html +10 -10
  108. data/vendor/local/share/doc/groonga/en/html/install/debian.html +8 -8
  109. data/vendor/local/share/doc/groonga/en/html/install/fedora.html +8 -8
  110. data/vendor/local/share/doc/groonga/en/html/install/mac_os_x.html +8 -8
  111. data/vendor/local/share/doc/groonga/en/html/install/others.html +8 -8
  112. data/vendor/local/share/doc/groonga/en/html/install/solaris.html +8 -8
  113. data/vendor/local/share/doc/groonga/en/html/install/ubuntu.html +8 -8
  114. data/vendor/local/share/doc/groonga/en/html/install/windows.html +50 -45
  115. data/vendor/local/share/doc/groonga/en/html/limitations.html +5 -5
  116. data/vendor/local/share/doc/groonga/en/html/news.html +220 -172
  117. data/vendor/local/share/doc/groonga/en/html/news/0.x.html +5 -5
  118. data/vendor/local/share/doc/groonga/en/html/news/1.0.x.html +6 -6
  119. data/vendor/local/share/doc/groonga/en/html/news/1.1.x.html +5 -5
  120. data/vendor/local/share/doc/groonga/en/html/news/1.2.x.html +5 -5
  121. data/vendor/local/share/doc/groonga/en/html/news/senna.html +5 -5
  122. data/vendor/local/share/doc/groonga/en/html/objects.inv +0 -0
  123. data/vendor/local/share/doc/groonga/en/html/reference.html +7 -7
  124. data/vendor/local/share/doc/groonga/en/html/reference/api.html +5 -5
  125. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_cache.html +5 -5
  126. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_column.html +5 -5
  127. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_command_version.html +5 -5
  128. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ctx.html +5 -5
  129. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_db.html +5 -5
  130. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_encoding.html +5 -5
  131. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_expr.html +5 -5
  132. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_geo.html +5 -5
  133. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_hook.html +5 -5
  134. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ii.html +5 -5
  135. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_index_cursor.html +5 -5
  136. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_info.html +5 -5
  137. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_match_escalation.html +5 -5
  138. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_obj.html +5 -5
  139. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_proc.html +5 -5
  140. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_search.html +5 -5
  141. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table.html +5 -5
  142. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table_cursor.html +5 -5
  143. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_type.html +5 -5
  144. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_user_data.html +5 -5
  145. data/vendor/local/share/doc/groonga/en/html/reference/cast.html +5 -5
  146. data/vendor/local/share/doc/groonga/en/html/reference/command.html +5 -5
  147. data/vendor/local/share/doc/groonga/en/html/reference/command/command_version.html +5 -5
  148. data/vendor/local/share/doc/groonga/en/html/reference/command/output_format.html +5 -5
  149. data/vendor/local/share/doc/groonga/en/html/reference/command/return_code.html +5 -5
  150. data/vendor/local/share/doc/groonga/en/html/reference/commands/cache_limit.html +5 -5
  151. data/vendor/local/share/doc/groonga/en/html/reference/commands/check.html +5 -5
  152. data/vendor/local/share/doc/groonga/en/html/reference/commands/clearlock.html +5 -5
  153. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_create.html +5 -5
  154. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_list.html +5 -5
  155. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_remove.html +5 -5
  156. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_rename.html +5 -5
  157. data/vendor/local/share/doc/groonga/en/html/reference/commands/define_selector.html +5 -5
  158. data/vendor/local/share/doc/groonga/en/html/reference/commands/defrag.html +5 -5
  159. data/vendor/local/share/doc/groonga/en/html/reference/commands/delete.html +5 -5
  160. data/vendor/local/share/doc/groonga/en/html/reference/commands/dump.html +5 -5
  161. data/vendor/local/share/doc/groonga/en/html/reference/commands/load.html +5 -5
  162. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_level.html +5 -5
  163. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_put.html +5 -5
  164. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_reopen.html +5 -5
  165. data/vendor/local/share/doc/groonga/en/html/reference/commands/normalize.html +5 -5
  166. data/vendor/local/share/doc/groonga/en/html/reference/commands/quit.html +5 -5
  167. data/vendor/local/share/doc/groonga/en/html/reference/commands/register.html +5 -5
  168. data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_eval.html +5 -5
  169. data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_load.html +12 -5
  170. data/vendor/local/share/doc/groonga/en/html/reference/commands/select.html +5 -5
  171. data/vendor/local/share/doc/groonga/en/html/reference/commands/shutdown.html +5 -5
  172. data/vendor/local/share/doc/groonga/en/html/reference/commands/status.html +10 -10
  173. data/vendor/local/share/doc/groonga/en/html/reference/commands/suggest.html +5 -5
  174. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_create.html +5 -5
  175. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_list.html +5 -5
  176. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_remove.html +5 -5
  177. data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenize.html +5 -5
  178. data/vendor/local/share/doc/groonga/en/html/reference/commands/truncate.html +5 -5
  179. data/vendor/local/share/doc/groonga/en/html/reference/commands_not_implemented/add.html +5 -5
  180. data/vendor/local/share/doc/groonga/en/html/reference/commands_not_implemented/get.html +5 -5
  181. data/vendor/local/share/doc/groonga/en/html/reference/commands_not_implemented/set.html +5 -5
  182. data/vendor/local/share/doc/groonga/en/html/reference/executables.html +7 -7
  183. data/vendor/local/share/doc/groonga/en/html/reference/executables/grnslap.html +10 -10
  184. data/vendor/local/share/doc/groonga/en/html/reference/executables/grntest.html +5 -5
  185. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-benchmark.html +410 -0
  186. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-httpd.html +14 -14
  187. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-server-http.html +5 -5
  188. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-create-dataset.html +5 -5
  189. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-httpd.html +5 -5
  190. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-learner.html +5 -5
  191. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga.html +33 -33
  192. data/vendor/local/share/doc/groonga/en/html/reference/function.html +5 -5
  193. data/vendor/local/share/doc/groonga/en/html/reference/functions/edit_distance.html +5 -5
  194. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_distance.html +5 -5
  195. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_circle.html +5 -5
  196. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_rectangle.html +5 -5
  197. data/vendor/local/share/doc/groonga/en/html/reference/functions/html_untag.html +5 -5
  198. data/vendor/local/share/doc/groonga/en/html/reference/functions/now.html +5 -5
  199. data/vendor/local/share/doc/groonga/en/html/reference/functions/query.html +5 -5
  200. data/vendor/local/share/doc/groonga/en/html/reference/functions/rand.html +5 -5
  201. data/vendor/local/share/doc/groonga/en/html/reference/functions/snippet_html.html +5 -5
  202. data/vendor/local/share/doc/groonga/en/html/reference/functions/sub_filter.html +5 -5
  203. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr.html +5 -5
  204. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/query_syntax.html +5 -5
  205. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/script_syntax.html +5 -5
  206. data/vendor/local/share/doc/groonga/en/html/reference/indexing.html +5 -5
  207. data/vendor/local/share/doc/groonga/en/html/reference/log.html +5 -5
  208. data/vendor/local/share/doc/groonga/en/html/reference/normalizers.html +5 -5
  209. data/vendor/local/share/doc/groonga/en/html/reference/output.html +5 -5
  210. data/vendor/local/share/doc/groonga/en/html/reference/pseudo_column.html +5 -5
  211. data/vendor/local/share/doc/groonga/en/html/reference/query_expanders.html +5 -5
  212. data/vendor/local/share/doc/groonga/en/html/reference/query_expanders/tsv.html +5 -5
  213. data/vendor/local/share/doc/groonga/en/html/reference/tables.html +5 -5
  214. data/vendor/local/share/doc/groonga/en/html/reference/tokenizers.html +5 -5
  215. data/vendor/local/share/doc/groonga/en/html/reference/tuning.html +5 -5
  216. data/vendor/local/share/doc/groonga/en/html/reference/types.html +5 -5
  217. data/vendor/local/share/doc/groonga/en/html/search.html +5 -5
  218. data/vendor/local/share/doc/groonga/en/html/searchindex.js +1 -1
  219. data/vendor/local/share/doc/groonga/en/html/server.html +5 -5
  220. data/vendor/local/share/doc/groonga/en/html/server/gqtp.html +5 -5
  221. data/vendor/local/share/doc/groonga/en/html/server/http.html +5 -5
  222. data/vendor/local/share/doc/groonga/en/html/server/http/comparison.html +5 -5
  223. data/vendor/local/share/doc/groonga/en/html/server/http/groonga-httpd.html +5 -5
  224. data/vendor/local/share/doc/groonga/en/html/server/http/groonga.html +5 -5
  225. data/vendor/local/share/doc/groonga/en/html/server/package.html +5 -5
  226. data/vendor/local/share/doc/groonga/en/html/spec.html +5 -5
  227. data/vendor/local/share/doc/groonga/en/html/spec/gqtp.html +5 -5
  228. data/vendor/local/share/doc/groonga/en/html/spec/search.html +5 -5
  229. data/vendor/local/share/doc/groonga/en/html/suggest.html +5 -5
  230. data/vendor/local/share/doc/groonga/en/html/suggest/completion.html +21 -11
  231. data/vendor/local/share/doc/groonga/en/html/suggest/correction.html +5 -5
  232. data/vendor/local/share/doc/groonga/en/html/suggest/introduction.html +5 -5
  233. data/vendor/local/share/doc/groonga/en/html/suggest/suggestion.html +5 -5
  234. data/vendor/local/share/doc/groonga/en/html/suggest/tutorial.html +5 -5
  235. data/vendor/local/share/doc/groonga/en/html/troubleshooting.html +5 -5
  236. data/vendor/local/share/doc/groonga/en/html/troubleshooting/different_results_with_the_same_keyword.html +5 -5
  237. data/vendor/local/share/doc/groonga/en/html/troubleshooting/mmap_cannot_allocate_memory.html +5 -5
  238. data/vendor/local/share/doc/groonga/en/html/tutorial.html +5 -5
  239. data/vendor/local/share/doc/groonga/en/html/tutorial/data.html +5 -5
  240. data/vendor/local/share/doc/groonga/en/html/tutorial/drilldown.html +5 -5
  241. data/vendor/local/share/doc/groonga/en/html/tutorial/index.html +5 -5
  242. data/vendor/local/share/doc/groonga/en/html/tutorial/introduction.html +8 -8
  243. data/vendor/local/share/doc/groonga/en/html/tutorial/lexicon.html +5 -5
  244. data/vendor/local/share/doc/groonga/en/html/tutorial/match_columns.html +5 -5
  245. data/vendor/local/share/doc/groonga/en/html/tutorial/micro_blog.html +5 -5
  246. data/vendor/local/share/doc/groonga/en/html/tutorial/network.html +12 -12
  247. data/vendor/local/share/doc/groonga/en/html/tutorial/patricia_trie.html +5 -5
  248. data/vendor/local/share/doc/groonga/en/html/tutorial/query_expansion.html +5 -5
  249. data/vendor/local/share/doc/groonga/en/html/tutorial/search.html +5 -5
  250. data/vendor/local/share/doc/groonga/ja/html/.buildinfo +1 -1
  251. data/vendor/local/share/doc/groonga/ja/html/_sources/install/centos.txt +7 -7
  252. data/vendor/local/share/doc/groonga/ja/html/_sources/install/debian.txt +3 -3
  253. data/vendor/local/share/doc/groonga/ja/html/_sources/install/fedora.txt +3 -3
  254. data/vendor/local/share/doc/groonga/ja/html/_sources/install/mac_os_x.txt +3 -3
  255. data/vendor/local/share/doc/groonga/ja/html/_sources/install/others.txt +3 -3
  256. data/vendor/local/share/doc/groonga/ja/html/_sources/install/solaris.txt +3 -3
  257. data/vendor/local/share/doc/groonga/ja/html/_sources/install/ubuntu.txt +3 -3
  258. data/vendor/local/share/doc/groonga/ja/html/_sources/install/windows.txt +25 -39
  259. data/vendor/local/share/doc/groonga/ja/html/_sources/news.txt +41 -0
  260. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/ruby_load.txt +1 -1
  261. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/groonga-benchmark.txt +273 -0
  262. data/vendor/local/share/doc/groonga/ja/html/_sources/suggest/completion.txt +16 -6
  263. data/vendor/local/share/doc/groonga/ja/html/characteristic.html +5 -5
  264. data/vendor/local/share/doc/groonga/ja/html/community.html +5 -5
  265. data/vendor/local/share/doc/groonga/ja/html/contribution.html +5 -5
  266. data/vendor/local/share/doc/groonga/ja/html/contribution/development.html +5 -5
  267. data/vendor/local/share/doc/groonga/ja/html/contribution/development/com.html +5 -5
  268. data/vendor/local/share/doc/groonga/ja/html/contribution/development/cooperation.html +5 -5
  269. data/vendor/local/share/doc/groonga/ja/html/contribution/development/document.html +5 -5
  270. data/vendor/local/share/doc/groonga/ja/html/contribution/development/query.html +5 -5
  271. data/vendor/local/share/doc/groonga/ja/html/contribution/development/release.html +5 -5
  272. data/vendor/local/share/doc/groonga/ja/html/contribution/development/repository.html +5 -5
  273. data/vendor/local/share/doc/groonga/ja/html/contribution/development/test.html +5 -5
  274. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation.html +5 -5
  275. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/c-api.html +5 -5
  276. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/i18n.html +5 -5
  277. data/vendor/local/share/doc/groonga/ja/html/contribution/report.html +5 -5
  278. data/vendor/local/share/doc/groonga/ja/html/development.html +5 -5
  279. data/vendor/local/share/doc/groonga/ja/html/development/travis-ci.html +5 -5
  280. data/vendor/local/share/doc/groonga/ja/html/genindex.html +19 -19
  281. data/vendor/local/share/doc/groonga/ja/html/geolocation_search.html +5 -5
  282. data/vendor/local/share/doc/groonga/ja/html/index.html +7 -7
  283. data/vendor/local/share/doc/groonga/ja/html/install.html +5 -5
  284. data/vendor/local/share/doc/groonga/ja/html/install/centos.html +10 -10
  285. data/vendor/local/share/doc/groonga/ja/html/install/debian.html +8 -8
  286. data/vendor/local/share/doc/groonga/ja/html/install/fedora.html +8 -8
  287. data/vendor/local/share/doc/groonga/ja/html/install/mac_os_x.html +8 -8
  288. data/vendor/local/share/doc/groonga/ja/html/install/others.html +8 -8
  289. data/vendor/local/share/doc/groonga/ja/html/install/solaris.html +8 -8
  290. data/vendor/local/share/doc/groonga/ja/html/install/ubuntu.html +8 -8
  291. data/vendor/local/share/doc/groonga/ja/html/install/windows.html +39 -38
  292. data/vendor/local/share/doc/groonga/ja/html/limitations.html +5 -5
  293. data/vendor/local/share/doc/groonga/ja/html/news.html +234 -173
  294. data/vendor/local/share/doc/groonga/ja/html/news/0.x.html +5 -5
  295. data/vendor/local/share/doc/groonga/ja/html/news/1.0.x.html +6 -6
  296. data/vendor/local/share/doc/groonga/ja/html/news/1.1.x.html +5 -5
  297. data/vendor/local/share/doc/groonga/ja/html/news/1.2.x.html +5 -5
  298. data/vendor/local/share/doc/groonga/ja/html/news/senna.html +5 -5
  299. data/vendor/local/share/doc/groonga/ja/html/objects.inv +0 -0
  300. data/vendor/local/share/doc/groonga/ja/html/reference.html +7 -7
  301. data/vendor/local/share/doc/groonga/ja/html/reference/api.html +5 -5
  302. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_cache.html +5 -5
  303. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_column.html +5 -5
  304. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_command_version.html +5 -5
  305. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ctx.html +5 -5
  306. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_db.html +5 -5
  307. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_encoding.html +5 -5
  308. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_expr.html +5 -5
  309. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_geo.html +5 -5
  310. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_hook.html +5 -5
  311. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ii.html +5 -5
  312. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_index_cursor.html +5 -5
  313. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_info.html +5 -5
  314. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_match_escalation.html +5 -5
  315. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_obj.html +5 -5
  316. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_proc.html +5 -5
  317. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_search.html +5 -5
  318. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table.html +5 -5
  319. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table_cursor.html +5 -5
  320. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_type.html +5 -5
  321. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_user_data.html +5 -5
  322. data/vendor/local/share/doc/groonga/ja/html/reference/cast.html +5 -5
  323. data/vendor/local/share/doc/groonga/ja/html/reference/command.html +5 -5
  324. data/vendor/local/share/doc/groonga/ja/html/reference/command/command_version.html +5 -5
  325. data/vendor/local/share/doc/groonga/ja/html/reference/command/output_format.html +5 -5
  326. data/vendor/local/share/doc/groonga/ja/html/reference/command/return_code.html +5 -5
  327. data/vendor/local/share/doc/groonga/ja/html/reference/commands/cache_limit.html +5 -5
  328. data/vendor/local/share/doc/groonga/ja/html/reference/commands/check.html +5 -5
  329. data/vendor/local/share/doc/groonga/ja/html/reference/commands/clearlock.html +5 -5
  330. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_create.html +5 -5
  331. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_list.html +5 -5
  332. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_remove.html +5 -5
  333. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_rename.html +5 -5
  334. data/vendor/local/share/doc/groonga/ja/html/reference/commands/define_selector.html +5 -5
  335. data/vendor/local/share/doc/groonga/ja/html/reference/commands/defrag.html +5 -5
  336. data/vendor/local/share/doc/groonga/ja/html/reference/commands/delete.html +5 -5
  337. data/vendor/local/share/doc/groonga/ja/html/reference/commands/dump.html +5 -5
  338. data/vendor/local/share/doc/groonga/ja/html/reference/commands/load.html +5 -5
  339. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_level.html +5 -5
  340. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_put.html +5 -5
  341. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_reopen.html +5 -5
  342. data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalize.html +5 -5
  343. data/vendor/local/share/doc/groonga/ja/html/reference/commands/quit.html +5 -5
  344. data/vendor/local/share/doc/groonga/ja/html/reference/commands/register.html +5 -5
  345. data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_eval.html +5 -5
  346. data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_load.html +12 -5
  347. data/vendor/local/share/doc/groonga/ja/html/reference/commands/select.html +5 -5
  348. data/vendor/local/share/doc/groonga/ja/html/reference/commands/shutdown.html +5 -5
  349. data/vendor/local/share/doc/groonga/ja/html/reference/commands/status.html +10 -10
  350. data/vendor/local/share/doc/groonga/ja/html/reference/commands/suggest.html +5 -5
  351. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_create.html +5 -5
  352. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_list.html +5 -5
  353. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_remove.html +5 -5
  354. data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenize.html +5 -5
  355. data/vendor/local/share/doc/groonga/ja/html/reference/commands/truncate.html +5 -5
  356. data/vendor/local/share/doc/groonga/ja/html/reference/commands_not_implemented/add.html +5 -5
  357. data/vendor/local/share/doc/groonga/ja/html/reference/commands_not_implemented/get.html +5 -5
  358. data/vendor/local/share/doc/groonga/ja/html/reference/commands_not_implemented/set.html +5 -5
  359. data/vendor/local/share/doc/groonga/ja/html/reference/executables.html +7 -7
  360. data/vendor/local/share/doc/groonga/ja/html/reference/executables/grnslap.html +10 -10
  361. data/vendor/local/share/doc/groonga/ja/html/reference/executables/grntest.html +5 -5
  362. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-benchmark.html +411 -0
  363. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-httpd.html +14 -14
  364. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-server-http.html +5 -5
  365. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-create-dataset.html +5 -5
  366. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-httpd.html +5 -5
  367. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-learner.html +5 -5
  368. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga.html +33 -33
  369. data/vendor/local/share/doc/groonga/ja/html/reference/function.html +5 -5
  370. data/vendor/local/share/doc/groonga/ja/html/reference/functions/edit_distance.html +5 -5
  371. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_distance.html +5 -5
  372. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_circle.html +5 -5
  373. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_rectangle.html +5 -5
  374. data/vendor/local/share/doc/groonga/ja/html/reference/functions/html_untag.html +5 -5
  375. data/vendor/local/share/doc/groonga/ja/html/reference/functions/now.html +5 -5
  376. data/vendor/local/share/doc/groonga/ja/html/reference/functions/query.html +5 -5
  377. data/vendor/local/share/doc/groonga/ja/html/reference/functions/rand.html +5 -5
  378. data/vendor/local/share/doc/groonga/ja/html/reference/functions/snippet_html.html +5 -5
  379. data/vendor/local/share/doc/groonga/ja/html/reference/functions/sub_filter.html +5 -5
  380. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr.html +5 -5
  381. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/query_syntax.html +5 -5
  382. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/script_syntax.html +5 -5
  383. data/vendor/local/share/doc/groonga/ja/html/reference/indexing.html +5 -5
  384. data/vendor/local/share/doc/groonga/ja/html/reference/log.html +5 -5
  385. data/vendor/local/share/doc/groonga/ja/html/reference/normalizers.html +5 -5
  386. data/vendor/local/share/doc/groonga/ja/html/reference/output.html +5 -5
  387. data/vendor/local/share/doc/groonga/ja/html/reference/pseudo_column.html +5 -5
  388. data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders.html +5 -5
  389. data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders/tsv.html +5 -5
  390. data/vendor/local/share/doc/groonga/ja/html/reference/tables.html +5 -5
  391. data/vendor/local/share/doc/groonga/ja/html/reference/tokenizers.html +5 -5
  392. data/vendor/local/share/doc/groonga/ja/html/reference/tuning.html +5 -5
  393. data/vendor/local/share/doc/groonga/ja/html/reference/types.html +5 -5
  394. data/vendor/local/share/doc/groonga/ja/html/search.html +5 -5
  395. data/vendor/local/share/doc/groonga/ja/html/searchindex.js +1 -1
  396. data/vendor/local/share/doc/groonga/ja/html/server.html +5 -5
  397. data/vendor/local/share/doc/groonga/ja/html/server/gqtp.html +5 -5
  398. data/vendor/local/share/doc/groonga/ja/html/server/http.html +5 -5
  399. data/vendor/local/share/doc/groonga/ja/html/server/http/comparison.html +5 -5
  400. data/vendor/local/share/doc/groonga/ja/html/server/http/groonga-httpd.html +5 -5
  401. data/vendor/local/share/doc/groonga/ja/html/server/http/groonga.html +5 -5
  402. data/vendor/local/share/doc/groonga/ja/html/server/package.html +5 -5
  403. data/vendor/local/share/doc/groonga/ja/html/spec.html +5 -5
  404. data/vendor/local/share/doc/groonga/ja/html/spec/gqtp.html +5 -5
  405. data/vendor/local/share/doc/groonga/ja/html/spec/search.html +5 -5
  406. data/vendor/local/share/doc/groonga/ja/html/suggest.html +5 -5
  407. data/vendor/local/share/doc/groonga/ja/html/suggest/completion.html +21 -11
  408. data/vendor/local/share/doc/groonga/ja/html/suggest/correction.html +5 -5
  409. data/vendor/local/share/doc/groonga/ja/html/suggest/introduction.html +5 -5
  410. data/vendor/local/share/doc/groonga/ja/html/suggest/suggestion.html +5 -5
  411. data/vendor/local/share/doc/groonga/ja/html/suggest/tutorial.html +5 -5
  412. data/vendor/local/share/doc/groonga/ja/html/troubleshooting.html +5 -5
  413. data/vendor/local/share/doc/groonga/ja/html/troubleshooting/different_results_with_the_same_keyword.html +5 -5
  414. data/vendor/local/share/doc/groonga/ja/html/troubleshooting/mmap_cannot_allocate_memory.html +5 -5
  415. data/vendor/local/share/doc/groonga/ja/html/tutorial.html +5 -5
  416. data/vendor/local/share/doc/groonga/ja/html/tutorial/data.html +5 -5
  417. data/vendor/local/share/doc/groonga/ja/html/tutorial/drilldown.html +5 -5
  418. data/vendor/local/share/doc/groonga/ja/html/tutorial/index.html +5 -5
  419. data/vendor/local/share/doc/groonga/ja/html/tutorial/introduction.html +8 -8
  420. data/vendor/local/share/doc/groonga/ja/html/tutorial/lexicon.html +5 -5
  421. data/vendor/local/share/doc/groonga/ja/html/tutorial/match_columns.html +5 -5
  422. data/vendor/local/share/doc/groonga/ja/html/tutorial/micro_blog.html +5 -5
  423. data/vendor/local/share/doc/groonga/ja/html/tutorial/network.html +12 -12
  424. data/vendor/local/share/doc/groonga/ja/html/tutorial/patricia_trie.html +5 -5
  425. data/vendor/local/share/doc/groonga/ja/html/tutorial/query_expansion.html +5 -5
  426. data/vendor/local/share/doc/groonga/ja/html/tutorial/search.html +5 -5
  427. data/vendor/local/share/groonga/examples/dictionary/edict/edict-import.sh +0 -0
  428. data/vendor/local/share/groonga/examples/dictionary/edict/edict2grn.rb +0 -0
  429. data/vendor/local/share/groonga/examples/dictionary/eijiro/eijiro-import.sh +0 -0
  430. data/vendor/local/share/groonga/examples/dictionary/eijiro/eijiro2grn.rb +0 -0
  431. data/vendor/local/share/groonga/examples/dictionary/gene95/gene-import.sh +0 -0
  432. data/vendor/local/share/groonga/examples/dictionary/gene95/gene2grn.rb +0 -0
  433. data/vendor/local/share/groonga/examples/dictionary/init-db.sh +0 -0
  434. data/vendor/local/share/groonga/examples/dictionary/jmdict/jmdict.rb +0 -0
  435. data/vendor/local/share/man/ja/man1/groonga.1 +489 -491
  436. data/vendor/local/share/man/man1/groonga.1 +500 -498
  437. metadata +21 -8
  438. data/lib/groonga/view-record.rb +0 -50
@@ -7,7 +7,7 @@
7
7
  <head>
8
8
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
9
9
 
10
- <title>4.8. パトリシア木による前方一致検索 &mdash; Groonga v3.0.9ドキュメント</title>
10
+ <title>4.8. パトリシア木による前方一致検索 &mdash; Groonga v3.1.0ドキュメント</title>
11
11
 
12
12
  <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
13
13
  <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
15
15
  <script type="text/javascript">
16
16
  var DOCUMENTATION_OPTIONS = {
17
17
  URL_ROOT: '../',
18
- VERSION: '3.0.9',
18
+ VERSION: '3.1.0',
19
19
  COLLAPSE_INDEX: false,
20
20
  FILE_SUFFIX: '.html',
21
21
  HAS_SOURCE: true
@@ -26,7 +26,7 @@
26
26
  <script type="text/javascript" src="../_static/doctools.js"></script>
27
27
  <script type="text/javascript" src="../_static/translations.js"></script>
28
28
  <link rel="shortcut icon" href="../_static/favicon.ico"/>
29
- <link rel="top" title="Groonga v3.0.9ドキュメント" href="../index.html" />
29
+ <link rel="top" title="Groonga v3.1.0ドキュメント" href="../index.html" />
30
30
  <link rel="up" title="4. チュートリアル" href="../tutorial.html" />
31
31
  <link rel="next" title="4.9. 全文検索の語彙表に対する追加情報" href="lexicon.html" />
32
32
  <link rel="prev" title="4.7. match_columnsパラメータ" href="match_columns.html" />
@@ -61,7 +61,7 @@
61
61
  <li class="right" >
62
62
  <a href="match_columns.html" title="4.7. match_columnsパラメータ"
63
63
  accesskey="P">前へ</a> |</li>
64
- <li><a href="../index.html">Groonga v3.0.9ドキュメント</a> &raquo;</li>
64
+ <li><a href="../index.html">Groonga v3.1.0ドキュメント</a> &raquo;</li>
65
65
  <li><a href="../tutorial.html" accesskey="U">4. チュートリアル</a> &raquo;</li>
66
66
  </ul>
67
67
  </div>
@@ -290,7 +290,7 @@ select --table PatSuffix --filter &#39;_key @$ &quot;ゆき&quot; &amp;&amp; ori
290
290
  <li class="right" >
291
291
  <a href="match_columns.html" title="4.7. match_columnsパラメータ"
292
292
  >前へ</a> |</li>
293
- <li><a href="../index.html">Groonga v3.0.9ドキュメント</a> &raquo;</li>
293
+ <li><a href="../index.html">Groonga v3.1.0ドキュメント</a> &raquo;</li>
294
294
  <li><a href="../tutorial.html" >4. チュートリアル</a> &raquo;</li>
295
295
  </ul>
296
296
  </div>
@@ -7,7 +7,7 @@
7
7
  <head>
8
8
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
9
9
 
10
- <title>4.11. クエリ拡張 &mdash; Groonga v3.0.9ドキュメント</title>
10
+ <title>4.11. クエリ拡張 &mdash; Groonga v3.1.0ドキュメント</title>
11
11
 
12
12
  <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
13
13
  <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
15
15
  <script type="text/javascript">
16
16
  var DOCUMENTATION_OPTIONS = {
17
17
  URL_ROOT: '../',
18
- VERSION: '3.0.9',
18
+ VERSION: '3.1.0',
19
19
  COLLAPSE_INDEX: false,
20
20
  FILE_SUFFIX: '.html',
21
21
  HAS_SOURCE: true
@@ -26,7 +26,7 @@
26
26
  <script type="text/javascript" src="../_static/doctools.js"></script>
27
27
  <script type="text/javascript" src="../_static/translations.js"></script>
28
28
  <link rel="shortcut icon" href="../_static/favicon.ico"/>
29
- <link rel="top" title="Groonga v3.0.9ドキュメント" href="../index.html" />
29
+ <link rel="top" title="Groonga v3.1.0ドキュメント" href="../index.html" />
30
30
  <link rel="up" title="4. チュートリアル" href="../tutorial.html" />
31
31
  <link rel="next" title="5. サジェスト" href="../suggest.html" />
32
32
  <link rel="prev" title="4.10. マイクロブログ検索システムの作成" href="micro_blog.html" />
@@ -61,7 +61,7 @@
61
61
  <li class="right" >
62
62
  <a href="micro_blog.html" title="4.10. マイクロブログ検索システムの作成"
63
63
  accesskey="P">前へ</a> |</li>
64
- <li><a href="../index.html">Groonga v3.0.9ドキュメント</a> &raquo;</li>
64
+ <li><a href="../index.html">Groonga v3.1.0ドキュメント</a> &raquo;</li>
65
65
  <li><a href="../tutorial.html" accesskey="U">4. チュートリアル</a> &raquo;</li>
66
66
  </ul>
67
67
  </div>
@@ -324,7 +324,7 @@ select Doc --match_columns body --query &quot;シークヮーサー&quot; --quer
324
324
  <li class="right" >
325
325
  <a href="micro_blog.html" title="4.10. マイクロブログ検索システムの作成"
326
326
  >前へ</a> |</li>
327
- <li><a href="../index.html">Groonga v3.0.9ドキュメント</a> &raquo;</li>
327
+ <li><a href="../index.html">Groonga v3.1.0ドキュメント</a> &raquo;</li>
328
328
  <li><a href="../tutorial.html" >4. チュートリアル</a> &raquo;</li>
329
329
  </ul>
330
330
  </div>
@@ -7,7 +7,7 @@
7
7
  <head>
8
8
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
9
9
 
10
- <title>4.4. さまざまな検索条件の指定 &mdash; Groonga v3.0.9ドキュメント</title>
10
+ <title>4.4. さまざまな検索条件の指定 &mdash; Groonga v3.1.0ドキュメント</title>
11
11
 
12
12
  <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
13
13
  <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
15
15
  <script type="text/javascript">
16
16
  var DOCUMENTATION_OPTIONS = {
17
17
  URL_ROOT: '../',
18
- VERSION: '3.0.9',
18
+ VERSION: '3.1.0',
19
19
  COLLAPSE_INDEX: false,
20
20
  FILE_SUFFIX: '.html',
21
21
  HAS_SOURCE: true
@@ -26,7 +26,7 @@
26
26
  <script type="text/javascript" src="../_static/doctools.js"></script>
27
27
  <script type="text/javascript" src="../_static/translations.js"></script>
28
28
  <link rel="shortcut icon" href="../_static/favicon.ico"/>
29
- <link rel="top" title="Groonga v3.0.9ドキュメント" href="../index.html" />
29
+ <link rel="top" title="Groonga v3.1.0ドキュメント" href="../index.html" />
30
30
  <link rel="up" title="4. チュートリアル" href="../tutorial.html" />
31
31
  <link rel="next" title="4.5. ドリルダウン" href="drilldown.html" />
32
32
  <link rel="prev" title="4.3. いろいろなデータの保存" href="data.html" />
@@ -61,7 +61,7 @@
61
61
  <li class="right" >
62
62
  <a href="data.html" title="4.3. いろいろなデータの保存"
63
63
  accesskey="P">前へ</a> |</li>
64
- <li><a href="../index.html">Groonga v3.0.9ドキュメント</a> &raquo;</li>
64
+ <li><a href="../index.html">Groonga v3.1.0ドキュメント</a> &raquo;</li>
65
65
  <li><a href="../tutorial.html" accesskey="U">4. チュートリアル</a> &raquo;</li>
66
66
  </ul>
67
67
  </div>
@@ -608,7 +608,7 @@ select --table Site --query &quot;_id:1 OR _id:2&quot; --output_columns _key,loc
608
608
  <li class="right" >
609
609
  <a href="data.html" title="4.3. いろいろなデータの保存"
610
610
  >前へ</a> |</li>
611
- <li><a href="../index.html">Groonga v3.0.9ドキュメント</a> &raquo;</li>
611
+ <li><a href="../index.html">Groonga v3.1.0ドキュメント</a> &raquo;</li>
612
612
  <li><a href="../tutorial.html" >4. チュートリアル</a> &raquo;</li>
613
613
  </ul>
614
614
  </div>
@@ -1,6 +1,6 @@
1
- .TH "GROONGA" "1" "2013 年 1028 日" "3.0.9" "groonga"
1
+ .TH "GROONGA" "1" "2013 年 1127 日" "3.1.0" "Groonga"
2
2
  .SH NAME
3
- groonga \- groongaのドキュメント
3
+ groonga \- Groonga documentation
4
4
  .
5
5
  .nr rst2man-indent-level 0
6
6
  .
@@ -87,86 +87,66 @@ groonga は独自のカラムストアを持つ列指向のデータベースと
87
87
  32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
88
88
  .SS Windows
89
89
  .sp
90
- このセクションではWindows上でgroongaをインストールする方法を説明します。groongaをインストールするにはzipパッケージを展開する方法とインストーラーを実行する方法があります。
90
+ このセクションではWindows上でGroongaをインストールする方法を説明します。Groongaをインストールするにはzipパッケージを展開する方法とインストーラーを実行する方法があります。
91
91
  .sp
92
92
  32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
93
93
  .SS インストーラー
94
94
  .sp
95
95
  32\-bit環境の場合は、x86のバイナリをpackages.groonga.orgからダウンロードしてください。
96
- .sp
97
- コマンドラインの操作でバイナリをダウンロードすることができます。
98
- .sp
99
- コマンドプロンプト \fBcmd.exe\fP を起動し、x86バイナリをブラウザを使ってダウンロードします。:
100
96
  .INDENT 0.0
101
97
  .INDENT 3.5
102
- .sp
103
- .nf
104
- .ft C
105
- > "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-3.0.9\-x86.exe
106
- .ft P
107
- .fi
98
+ .INDENT 0.0
99
+ .IP \(bu 2
100
+ \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.0\-x86.exe\fP
101
+ .UNINDENT
108
102
  .UNINDENT
109
103
  .UNINDENT
110
104
  .sp
111
105
  その後、バイナリを実行します。
112
106
  .sp
113
107
  64\-bit環境の場合は、x64のバイナリをpackages.groonga.orgからダウンロードしてください。
114
- .sp
115
- コマンドプロンプト \fBcmd.exe\fP を起動し、x64バイナリをブラウザを使ってダウンロードします。:
116
108
  .INDENT 0.0
117
109
  .INDENT 3.5
118
- .sp
119
- .nf
120
- .ft C
121
- > "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-3.0.9\-x64.exe
122
- .ft P
123
- .fi
110
+ .INDENT 0.0
111
+ .IP \(bu 2
112
+ \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.0\-x64.exe\fP
113
+ .UNINDENT
124
114
  .UNINDENT
125
115
  .UNINDENT
126
116
  .sp
127
117
  その後、バイナリを実行します。
128
118
  .sp
129
- スタートメニュー内に \fB/reference/executables/groonga\fP 用のコマンドプロンプトがインストールされるのでそれを使ってください。
119
+ スタートメニュー内にあるコマンドプロンプトを使って \fB/reference/executables/groonga\fP を起動してください。
130
120
  .SS zip
131
121
  .sp
132
122
  32\-bit環境の場合は、x86のzipアーカイブをpackages.groonga.orgからダウンロードしてください。
133
- .sp
134
- コマンドラインの操作でバイナリをダウンロードすることができます。
135
- .sp
136
- コマンドプロンプト \fBcmd.exe\fP を起動し、x86バイナリをブラウザを使ってダウンロードします。:
137
123
  .INDENT 0.0
138
124
  .INDENT 3.5
139
- .sp
140
- .nf
141
- .ft C
142
- > "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-3.0.9\-x86.zip
143
- .ft P
144
- .fi
125
+ .INDENT 0.0
126
+ .IP \(bu 2
127
+ \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.0\-x86.zip\fP
128
+ .UNINDENT
145
129
  .UNINDENT
146
130
  .UNINDENT
147
131
  .sp
148
132
  その後、アーカイブを展開します。
149
133
  .sp
150
134
  64\-bit環境の場合は、x64のzipアーカイブをpackages.groonga.orgからダウンロードしてください。
151
- .sp
152
- コマンドプロンプト \fBcmd.exe\fP を起動し、x64バイナリをブラウザを使ってダウンロードします。:
153
135
  .INDENT 0.0
154
136
  .INDENT 3.5
155
- .sp
156
- .nf
157
- .ft C
158
- > "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-3.0.9\-x64.zip
159
- .ft P
160
- .fi
137
+ .INDENT 0.0
138
+ .IP \(bu 2
139
+ \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.0\-x64.zip\fP
140
+ .UNINDENT
161
141
  .UNINDENT
162
142
  .UNINDENT
163
143
  .sp
164
144
  その後、アーカイブを展開します。
165
145
  .sp
166
- \fB/reference/executables/groonga\fP は \fBbin\fP フォルダーにあります。
146
+ \fBbin\fP フォルダーに \fB/reference/executables/groonga\fP があるのでそれを起動してください。
167
147
  .SS ソースからビルド
168
148
  .sp
169
- まずWindows上でgroongaをビルドするために必須のツールをインストールします。以下が必須のツールです。
149
+ まずWindows上でGroongaをビルドするために必須のツールをインストールします。以下が必須のツールです。
170
150
  .INDENT 0.0
171
151
  .INDENT 3.5
172
152
  .INDENT 0.0
@@ -179,31 +159,24 @@ groonga は独自のカラムストアを持つ列指向のデータベースと
179
159
  .UNINDENT
180
160
  .sp
181
161
  zipアーカイブをpackages.groonga.orgからダウンロードしてください。
182
- .sp
183
- コマンドラインの操作でzipソースファイルをダウンロードすることができます。
184
- .sp
185
- Microsoft Visual Studio 2010 Expressがインストールする \fBVisual Studio コマンド プロンプト (2010)\fP を実行して、groongaのソースをブラウザでダウンロードしてください:
186
162
  .INDENT 0.0
187
163
  .INDENT 3.5
188
- .sp
189
- .nf
190
- .ft C
191
- > cd c:\eUsers\e%USERNAME%\eDownloads
192
- > "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/source/groonga/groonga\-3.0.9.zip
193
- .ft P
194
- .fi
164
+ .INDENT 0.0
165
+ .IP \(bu 2
166
+ \fI\%http://packages.groonga.org/source/groonga/groonga\-3.1.0.zip\fP
167
+ .UNINDENT
195
168
  .UNINDENT
196
169
  .UNINDENT
197
170
  .sp
198
171
  その後、アーカイブを展開します。
199
172
  .sp
200
- groongaのソースフォルダへと移動します:
173
+ Groongaのソースフォルダへと移動します:
201
174
  .INDENT 0.0
202
175
  .INDENT 3.5
203
176
  .sp
204
177
  .nf
205
178
  .ft C
206
- > cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-3.0.9
179
+ > cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-3.1.0
207
180
  .ft P
208
181
  .fi
209
182
  .UNINDENT
@@ -215,7 +188,7 @@ groongaのソースフォルダへと移動します:
215
188
  .sp
216
189
  .nf
217
190
  .ft C
218
- groonga\-3.0.9> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
191
+ groonga\-3.1.0> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
219
192
  .ft P
220
193
  .fi
221
194
  .UNINDENT
@@ -227,7 +200,7 @@ groonga\-3.0.9> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\
227
200
  .sp
228
201
  .nf
229
202
  .ft C
230
- groonga\-3.0.9> cmake \-\-build . \-\-config Release
203
+ groonga\-3.1.0> cmake \-\-build . \-\-config Release
231
204
  .ft P
232
205
  .fi
233
206
  .UNINDENT
@@ -239,7 +212,7 @@ groonga\-3.0.9> cmake \-\-build . \-\-config Release
239
212
  .sp
240
213
  .nf
241
214
  .ft C
242
- groonga\-3.0.9> cmake \-\-build . \-\-config Release \-\-target Install
215
+ groonga\-3.1.0> cmake \-\-build . \-\-config Release \-\-target Install
243
216
  .ft P
244
217
  .fi
245
218
  .UNINDENT
@@ -287,9 +260,9 @@ groonga\-3.0.9> cmake \-\-build . \-\-config Release \-\-target Install
287
260
  .sp
288
261
  .nf
289
262
  .ft C
290
- % curl \-O http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
291
- % tar xvzf groonga\-3.0.9.tar.gz
292
- % cd groonga\-3.0.9
263
+ % curl \-O http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
264
+ % tar xvzf groonga\-3.1.0.tar.gz
265
+ % cd groonga\-3.1.0
293
266
  .ft P
294
267
  .fi
295
268
  .UNINDENT
@@ -666,9 +639,9 @@ groongaをビルドするために必要なパッケージをインストール
666
639
  .sp
667
640
  .nf
668
641
  .ft C
669
- % wget http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
670
- % tar xvzf groonga\-3.0.9.tar.gz
671
- % cd groonga\-3.0.9
642
+ % wget http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
643
+ % tar xvzf groonga\-3.1.0.tar.gz
644
+ % cd groonga\-3.1.0
672
645
  .ft P
673
646
  .fi
674
647
  .UNINDENT
@@ -1190,9 +1163,9 @@ groongaをビルドするために必要なパッケージをインストール
1190
1163
  .sp
1191
1164
  .nf
1192
1165
  .ft C
1193
- % wget http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
1194
- % tar xvzf groonga\-3.0.9.tar.gz
1195
- % cd groonga\-3.0.9
1166
+ % wget http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
1167
+ % tar xvzf groonga\-3.1.0.tar.gz
1168
+ % cd groonga\-3.1.0
1196
1169
  .ft P
1197
1170
  .fi
1198
1171
  .UNINDENT
@@ -1326,7 +1299,7 @@ i386環境でRepoforge (RPMforge)リポジトリを有効にする:
1326
1299
  .sp
1327
1300
  .nf
1328
1301
  .ft C
1329
- % wget http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.2\-2.el5.rf.i386.rpm
1302
+ % wget http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.3\-1.el5.rf.i386.rpm
1330
1303
  % sudo rpm \-ivh rpmforge\-release\-0.5.2\-2.el5.rf.i386.rpm
1331
1304
  .ft P
1332
1305
  .fi
@@ -1339,7 +1312,7 @@ x86_64環境でRepoforge (RPMforge)リポジトリを有効にする:
1339
1312
  .sp
1340
1313
  .nf
1341
1314
  .ft C
1342
- % wget http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.2\-2.el5.rf.x86_64.rpm
1315
+ % wget http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.3\-1.el5.rf.x86_64.rpm
1343
1316
  % sudo rpm \-ivh rpmforge\-release\-0.5.2\-2.el5.rf.x86_64.rpm
1344
1317
  .ft P
1345
1318
  .fi
@@ -1508,9 +1481,9 @@ groongaをビルドするために必要なパッケージをインストール
1508
1481
  .sp
1509
1482
  .nf
1510
1483
  .ft C
1511
- % wget http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
1512
- % tar xvzf groonga\-3.0.9.tar.gz
1513
- % cd groonga\-3.0.9
1484
+ % wget http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
1485
+ % tar xvzf groonga\-3.1.0.tar.gz
1486
+ % cd groonga\-3.1.0
1514
1487
  .ft P
1515
1488
  .fi
1516
1489
  .UNINDENT
@@ -1696,9 +1669,9 @@ groongaをビルドするために必要なパッケージをインストール
1696
1669
  .sp
1697
1670
  .nf
1698
1671
  .ft C
1699
- % wget http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
1700
- % tar xvzf groonga\-3.0.9.tar.gz
1701
- % cd groonga\-3.0.9
1672
+ % wget http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
1673
+ % tar xvzf groonga\-3.1.0.tar.gz
1674
+ % cd groonga\-3.1.0
1702
1675
  .ft P
1703
1676
  .fi
1704
1677
  .UNINDENT
@@ -1762,9 +1735,9 @@ groongaをビルドするために必要なパッケージをインストール
1762
1735
  .sp
1763
1736
  .nf
1764
1737
  .ft C
1765
- % wget http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
1766
- % gtar xvzf groonga\-3.0.9.tar.gz
1767
- % cd groonga\-3.0.9
1738
+ % wget http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
1739
+ % gtar xvzf groonga\-3.1.0.tar.gz
1740
+ % cd groonga\-3.1.0
1768
1741
  .ft P
1769
1742
  .fi
1770
1743
  .UNINDENT
@@ -1885,9 +1858,9 @@ groongaはGNUビルドシステムを使っています。以下は一番簡単
1885
1858
  .sp
1886
1859
  .nf
1887
1860
  .ft C
1888
- % wget http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
1889
- % tar xvzf groonga\-3.0.9.tar.gz
1890
- % cd groonga\-3.0.9
1861
+ % wget http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
1862
+ % tar xvzf groonga\-3.1.0.tar.gz
1863
+ % cd groonga\-3.1.0
1891
1864
  % ./configure
1892
1865
  % make
1893
1866
  % sudo make install
@@ -2247,10 +2220,10 @@ status
2247
2220
  # "max_command_version": 2,
2248
2221
  # "n_queries": 0,
2249
2222
  # "cache_hit_rate": 0.0,
2250
- # "version": "3.0.7",
2251
- # "alloc_count": 154,
2223
+ # "version": "3.1.0",
2224
+ # "alloc_count": 159,
2252
2225
  # "command_version": 1,
2253
- # "starttime": 1377493494,
2226
+ # "starttime": 1385359899,
2254
2227
  # "default_command_version": 1
2255
2228
  # }
2256
2229
  # ]
@@ -3401,10 +3374,10 @@ status
3401
3374
  # "max_command_version": 2,
3402
3375
  # "n_queries": 0,
3403
3376
  # "cache_hit_rate": 0.0,
3404
- # "version": "3.0.7",
3405
- # "alloc_count": 133,
3377
+ # "version": "3.1.0",
3378
+ # "alloc_count": 138,
3406
3379
  # "command_version": 1,
3407
- # "starttime": 1377493621,
3380
+ # "starttime": 1385359920,
3408
3381
  # "default_command_version": 1
3409
3382
  # }
3410
3383
  # ]
@@ -3512,14 +3485,14 @@ status
3512
3485
  # 0.000355720520019531
3513
3486
  # ],
3514
3487
  # {
3515
- # "uptime": 1,
3488
+ # "uptime": 0,
3516
3489
  # "max_command_version": 2,
3517
3490
  # "n_queries": 0,
3518
3491
  # "cache_hit_rate": 0.0,
3519
- # "version": "3.0.7",
3520
- # "alloc_count": 134,
3492
+ # "version": "3.1.0",
3493
+ # "alloc_count": 139,
3521
3494
  # "command_version": 1,
3522
- # "starttime": 1377493621,
3495
+ # "starttime": 1385359920,
3523
3496
  # "default_command_version": 1
3524
3497
  # }
3525
3498
  # ]
@@ -7938,7 +7911,11 @@ RKはローマ字(Romaji)とカタカナ(Katakana)を意味していま
7938
7911
  .sp
7939
7912
  例えば、"日本"という語が登録されているとします。そして、その読みとして"ニホン"(カタカナにしないといけません)が登録されているとします。このとき、ユーザの入力が"ni"でも"二"でも"に"でも"日本"を見つけることができます。
7940
7913
  .sp
7941
- If you create dataset which is named as example by \fB/reference/executables/groonga\-suggest\-create\-dataset\fP command, you can update pairs of registered word and its reading by loading data to \(aq_key\(aq and \(aqkana\(aq column of item_example table explicitly for prefix RK search.
7914
+ If you create dataset which is named as example by
7915
+ \fB/reference/executables/groonga\-suggest\-create\-dataset\fP command,
7916
+ you can update pairs of registered word and its reading by loading
7917
+ data to \(aq_key\(aq and \(aqkana\(aq column of item_example table explicitly for
7918
+ prefix RK search.
7942
7919
  .SS 共起検索
7943
7920
  .sp
7944
7921
  共起検索は入力途中のユーザのクエリから登録されている語を見つけます。共起検索では検索データベースとしてユーザの入力シーケンスを使います。これはクエリログやアクセスログなどから学習します。
@@ -8307,11 +8284,14 @@ suggest \-\-table item_query \-\-column kana \-\-types complete \-\-frequency_th
8307
8284
  .UNINDENT
8308
8285
  .UNINDENT
8309
8286
  .sp
8310
- Without loading above RK data, you can\(aqt complete registered word "日本" by query \- "nihon".
8287
+ Without loading above RK data, you can\(aqt complete registered word "日本"
8288
+ by query \- "nihon".
8311
8289
  .sp
8312
- As the column type of item_query table is VECTOR_COLUMN, you can register multiple readings for registered word.
8290
+ As the column type of item_query table is VECTOR_COLUMN, you can
8291
+ register multiple readings for registered word.
8313
8292
  .sp
8314
- This is the reason that you can also complete the registered word "日本" by query \- "nippon".
8293
+ This is the reason that you can also complete the registered word "日本"
8294
+ by query \- "nippon".
8315
8295
  .sp
8316
8296
  実行例:
8317
8297
  .INDENT 0.0
@@ -8353,9 +8333,12 @@ suggest \-\-table item_query \-\-column kana \-\-types complete \-\-frequency_th
8353
8333
  .UNINDENT
8354
8334
  .UNINDENT
8355
8335
  .sp
8356
- This feature is very convenient because you can search registered word even though Japanese IM is disabled.
8336
+ This feature is very convenient because you can search registered word
8337
+ even though Japanese IM is disabled.
8357
8338
  .sp
8358
- If there are multiple candidates as completed result, you can customize priority to set the value of "boost" column in item_query table.
8339
+ If there are multiple candidates as completed result, you can
8340
+ customize priority to set the value of "boost" column in item_query
8341
+ table.
8359
8342
  .sp
8360
8343
  Here is the example to customize priority for RK search.
8361
8344
  .sp
@@ -9773,662 +9756,662 @@ gqtpでリクエストします。gqtpのリクエストをLF区切り形式で
9773
9756
  .fi
9774
9757
  .UNINDENT
9775
9758
  .UNINDENT
9776
- .SS grntest
9759
+ .SS groongaコマンド
9777
9760
  .SS 名前
9778
9761
  .sp
9779
- grntest \- groongaテストプログラム
9762
+ groonga \- 列指向データベース機能を持つ全文検索エンジンソフトウェア
9780
9763
  .SS 書式
9781
9764
  .INDENT 0.0
9782
9765
  .INDENT 3.5
9783
9766
  .sp
9784
9767
  .nf
9785
9768
  .ft C
9786
- grntest [options...] [script] [db]
9769
+ groonga [options] [dest] [command [args]]
9787
9770
  .ft P
9788
9771
  .fi
9789
9772
  .UNINDENT
9790
9773
  .UNINDENT
9791
9774
  .SS 説明
9792
9775
  .sp
9793
- grntestは、groonga汎用テストツールです。
9794
- .sp
9795
- groongaを単独のプロセスとして利用する場合はもちろん、サーバプログラムとして利用する場合の動作確認や実行速度測定が可能です。
9796
- .sp
9797
- grntest用のデータファイルは自分で作成することも既存のものを利用することもできます。既存のデータファイルは、ftp.groonga.orgから必要に応じダウンロードします。そのため、groonga及びgrntestが動作し、インターネットに接続できる環境であればgroongaコマンドの知識がなくてもgroongaの動作を確認できます。
9798
- .sp
9799
- 現在は、Linux 及びWindows上で動作します。make installしてもインストールは行われません。
9776
+ groongaは列指向のデータベース機能を持つ高速でスケーラブルな全文検索エンジンです。
9777
+ groongaのデータベースは、groongaコマンドかCライブラリインタフェースを通して操作することができます。このマニュアルページでは、groongaコマンドの使い方について説明します。
9800
9778
  .SS オプション
9801
9779
  .INDENT 0.0
9802
9780
  .TP
9803
- .B \-i, \-\-host <ip/hostname>
9804
- 接続するgroongaサーバを、ipアドレスまたはホスト名で指定します。指定先にgroongaサーバが立ち上がっていない場合、接続不能となることに注意してください。このオプションを指定しない場合、grntestは自動的にlocalhostのgroongaサーバを起動して接続します。
9781
+ .B \-n
9782
+ 新たなデータベースを作成します。
9805
9783
  .UNINDENT
9806
9784
  .INDENT 0.0
9807
9785
  .TP
9808
- .B \-p, \-\-port <port number>
9809
- 自動的に起動するgroongaサーバ、または明示的に指定した接続先のgroonga サーバが利用するポート番号を指定します。接続先のgroongaサーバが利用しているポートと、このオプションで指定したポート番号が異なる場合、接続不能となることに注意してください。
9786
+ .B \-c
9787
+ クライアントモードで実行します。
9810
9788
  .UNINDENT
9811
9789
  .INDENT 0.0
9812
9790
  .TP
9813
- .B \-\-dir
9814
- ftp.groonga.org に用意されているスクリプトファイルを表示します。
9791
+ .B \-s
9792
+ サーバモードで実行します。
9815
9793
  .UNINDENT
9816
9794
  .INDENT 0.0
9817
9795
  .TP
9818
- .B \-\-ftp
9819
- ftp.groonga.orgとFTP通信を行い、scriptファイルの同期やログファイルの送信を行います。
9796
+ .B \-d
9797
+ デーモンモードで実行します。(forkする点がサーバモードと異なる)
9820
9798
  .UNINDENT
9821
9799
  .INDENT 0.0
9822
9800
  .TP
9823
- .B \-\-log\-output\-dir
9824
- デフォルトでは、grntest終了後のログファイルの出力先ははカレントディレクトリです。このオプションを利用すると、任意のディレクトリに出力先を変更することができます。
9801
+ .B \-e, \-\-encoding <encoding>
9802
+ データベースで使用する文字エンコーディング方式を指定します。新たなデータベースを作成する時のみ有効です。none, euc, utf8, sjis, latin, koi8rのいずれかが指定できます。
9825
9803
  .UNINDENT
9826
9804
  .INDENT 0.0
9827
9805
  .TP
9828
- .B \-\-groonga <groonga_path>
9829
- groongaコマンドのパスを指定します。デフォルトでは、PATHの中からgroongaコマンドを探します。
9806
+ .B \-l, \-\-log\-level <log level>
9807
+ ログレベルを指定します。0〜8までの数値が指定可能で、数が大きいほど多くのログが出力されます。
9830
9808
  .UNINDENT
9831
9809
  .INDENT 0.0
9832
9810
  .TP
9833
- .B \-\-protocol <gqtp|http>
9834
- groongaコマンドが使うプロトコルとして \fIgqtp\fP または \fIhttp\fP を指定します。
9811
+ .B \-a, \-\-address <ip/hostname>
9812
+ バージョン 1.2.2 で撤廃: Use \fI\-\-bind\-address\fP instead.
9813
+
9835
9814
  .UNINDENT
9836
- .SS 引数
9837
9815
  .INDENT 0.0
9838
9816
  .TP
9839
- .B script
9840
- grntestの動作方法(以下、grntest命令と呼びます)を記述したテキストファイルです。拡張子は.scrです。
9817
+ .B \-\-bind\-address <ip/hostname>
9818
+ バージョン 1.2.2 で追加.
9819
+
9820
+ .sp
9821
+ サーバモードかデーモンモードで実行するとき、listenするアドレスを指定します。(デフォルトは \fIhostname\fP の返すホスト名)
9841
9822
  .UNINDENT
9842
9823
  .INDENT 0.0
9843
9824
  .TP
9844
- .B db
9845
- grntestが利用するgroonga データベースです。指定されたデータベースが存在しない場合、grntestが新規に作成します。またgroonga サーバを自動的に起動する場合もこの引数で指定したデータベースが利用されます。接続するgroonga サーバを明示的に指定した場合に利用するデータベースは、接続先サーバが使用中のデータベースになることに注意してください。
9825
+ .B \-p, \-\-port <port number>
9826
+ クライアント、サーバ、またはデーモンモードで使用するTCPポート番号。
9827
+ (デフォルトは10041番)
9846
9828
  .UNINDENT
9847
- .SS 使い方
9848
- .sp
9849
- まず、シェル上(Windowsならコマンドプロンプト上)で:
9850
9829
  .INDENT 0.0
9851
- .INDENT 3.5
9852
- .sp
9853
- .nf
9854
- .ft C
9855
- grntest test.scr 任意のDB名
9856
- .ft P
9857
- .fi
9830
+ .TP
9831
+ .B \-i, \-\-server\-id <ip/hostname>
9832
+ サーバモードかデーモンモードで実行するとき、サーバのIDとなるアドレスを指定します。(デフォルトは\(gahostname\(gaの返すホスト名)
9858
9833
  .UNINDENT
9834
+ .INDENT 0.0
9835
+ .TP
9836
+ .B \-h, \-\-help
9837
+ ヘルプメッセージを出力します。
9859
9838
  .UNINDENT
9860
- .sp
9861
- とタイプしてください。もしgrntestが正常に動作すれば、:
9862
9839
  .INDENT 0.0
9863
- .INDENT 3.5
9840
+ .TP
9841
+ .B \-\-document\-root <path>
9842
+ httpサーバとしてgroongaを使用する場合に静的ページを格納するディレクトリを指定します。
9864
9843
  .sp
9865
- .nf
9866
- .ft C
9867
- test\-ユーザ名\-数字.log
9868
- .ft P
9869
- .fi
9870
- .UNINDENT
9844
+ デフォルトでは、データベースを管理するための汎用的なページに対応するファイルが/usr/share/groonga/admin_html以下にインストールされます。このディレクトリをdocument\-rootオプションの値に指定して起動した場合、ウェブブラウザでhttp://hostname:port/index.htmlにアクセスすると、ウェブベースのデータベース管理ツールを使用できます。
9871
9845
  .UNINDENT
9872
- .sp
9873
- というファイルが作成されるはずです。作成されない場合、このドキュメントの「トラブルシューティング」の章を参照してください。
9874
- .SS スクリプトファイル
9875
- .sp
9876
- スクリプトファイルは、grntest命令を記述したテキストファイルです。
9877
- ";"セミコロンを利用して、一行に複数のgrntest命令を記述することができます。一行に複数のgrntest命令がある場合、各命令は並列に実行されます。
9878
- "#"で始まる行はコメントとして扱われます。
9879
- .SS grntest命令
9880
- .sp
9881
- 現在サポートされているgrntest命令は以下の8つです。
9882
- .INDENT 0.0
9883
- .INDENT 3.5
9884
- do_local コマンドファイル [スレッド数] [繰り返し数]
9885
9846
  .INDENT 0.0
9886
- .INDENT 3.5
9887
- コマンドファイルをgrntest単体で実行します。スレッド数が指定されている場合、複数のスレッドで同じコマンドファイルを同時に実行します。繰り返し数が指定されてい場合、コマンドファイルの内容を繰り返し実行します。スレッド数、繰り返し数とも省略時は1です。1スレッドで複数回動作させたい場合は、do_local コマンドファイル 1 [繰り返し数]と明示的に指定してください。
9888
- .UNINDENT
9847
+ .TP
9848
+ .B \-\-protocol <protocol>
9849
+ http,gqtpのいずれかを指定します。(デフォルトはgqtp)
9889
9850
  .UNINDENT
9890
- .sp
9891
- do_gqpt コマンドファイル [スレッド数] [繰り返し数]
9892
9851
  .INDENT 0.0
9893
- .INDENT 3.5
9894
- コマンドファイルをgroongaサーバで実行します。スレッド数や繰り返し数の意味はdo_localの場合と同じです。
9895
- .UNINDENT
9852
+ .TP
9853
+ .B \-\-log\-path <path>
9854
+ ログを出力するファイルのパスを指定します。(デフォルトは/var/log/groonga/groonga.logです)
9896
9855
  .UNINDENT
9897
- .sp
9898
- rep_local コマンドファイル [スレッド数] [繰り返し数]
9899
9856
  .INDENT 0.0
9900
- .INDENT 3.5
9901
- コマンドファイルをgrntest単体で実行し、より詳細な報告を行います。
9902
- .UNINDENT
9857
+ .TP
9858
+ .B \-\-query\-log\-path <path>
9859
+ クエリーログを出力するファイルのパスを指定します。(デフォルトでは出力されません)
9903
9860
  .UNINDENT
9904
- .sp
9905
- rep_gqpt コマンドファイル [スレッド数] [繰り返し数]
9906
9861
  .INDENT 0.0
9907
- .INDENT 3.5
9908
- コマンドファイルをgroongaサーバで実行し、より詳細な報告を行います。 スレッド数や繰り返し数の意味はdo_localと 同じです。
9909
- .UNINDENT
9862
+ .TP
9863
+ .B \-t, \-\-max\-threads <max threasd>
9864
+ 最大で利用するスレッド数を指定します。(デフォルトはマシンのCPUコア数と同じ数です)
9910
9865
  .UNINDENT
9911
- .sp
9912
- out_local コマンドファイル 入力ファイル名
9913
9866
  .INDENT 0.0
9914
- .INDENT 3.5
9915
- コマンドファイルをgrntest単体で実行し、各コマンドの実行結果をすべて”出力ファイル"に書きだします。この結果は、test_local, test_gqtp命令で利用します。なおこの命令の「出力ファイル」とは、grntest実行時に自動的に作成されるログとは別のものです。grntestではコメントが利用できる以外、:
9867
+ .TP
9868
+ .B \-\-pid\-path <path>
9869
+ PIDを保存するパスを指定します。(デフォルトでは保存しません)
9870
+ .UNINDENT
9916
9871
  .INDENT 0.0
9872
+ .TP
9873
+ .B \-\-config\-path <path>
9874
+ 設定ファイルのパスを指定します。設定ファイルは以下のようなフォーマットになります。:
9875
+ .INDENT 7.0
9917
9876
  .INDENT 3.5
9918
9877
  .sp
9919
9878
  .nf
9920
9879
  .ft C
9921
- groonga < コマンドファイル > 出力ファイル
9880
+ # \(aq#\(aq以降はコメント。
9881
+ ; \(aq;\(aq以降もコメント。
9882
+
9883
+ # \(aqキー = 値\(aqでオプションを指定。
9884
+ pid\-file = /var/run/groonga.pid
9885
+
9886
+ # \(aq=\(aqの前後の空白はは無視される。↓は↑と同じ意味。
9887
+ pid\-file=/var/run/groonga.pid
9888
+
9889
+ # \(aqキー\(aqは\(aq\-\-XXX\(aqスタイルのオプション名と同じものが使える。
9890
+ # 例えば、\(aq\-\-pid\-path\(aqに対応するキーは\(aqpid\-path\(aq。
9891
+ # ただし、キーが\(aqconfig\-path\(aqのオプションは無視される。
9922
9892
  .ft P
9923
9893
  .fi
9924
9894
  .UNINDENT
9925
9895
  .UNINDENT
9926
- .sp
9927
- とした場合と同じです。
9928
9896
  .UNINDENT
9897
+ .INDENT 0.0
9898
+ .TP
9899
+ .B \-\-cache\-limit <limit>
9900
+ キャッシュ数の最大値を指定します。(デフォルトは100です)
9929
9901
  .UNINDENT
9930
- .sp
9931
- out_gqtp コマンドファイル 出力ファイル名
9932
9902
  .INDENT 0.0
9933
- .INDENT 3.5
9934
- コマンドファイルをgroongaサーバで実行します。その他はout_local命令と同等です。
9903
+ .TP
9904
+ .B \-\-default\-match\-escalation\-threshold <threshold>
9905
+ 検索の挙動をエスカレーションする閾値を指定します。(デフォルトは0です)
9935
9906
  .UNINDENT
9907
+ .SS 引数
9908
+ .INDENT 0.0
9909
+ .TP
9910
+ .B dest
9911
+ 使用するデータベースのパス名を指定します。
9912
+ .sp
9913
+ クライアントモードの場合は接続先のホスト名とポート番号を指定します(デフォルト値は\(aqlocalhost:10041\(aq)。ポート番号を指定しない場合には、10041が指定されたものとします。
9936
9914
  .UNINDENT
9937
9915
  .INDENT 0.0
9938
9916
  .TP
9939
- .B test_local コマンドファイル 入力ファイル名
9940
- コマンドファイルをgrntest単体で実行し、各コマンドの実行結果を入力ファイルと比較します。処理時間など本質的要素以外に差分があった場合、差分を、入力ファイル.diffというファイルに書きだします。
9917
+ .B command [args]
9918
+ スタンドアロンおよびクライアントモードの場合は、実行するコマンドとその引数をコマンドライン引数に指定できます。コマンドライン引数にcommandを与えなかった場合は、標準入力から一行ずつEOFに達するまでコマンド文字列を読み取り、順次実行します。
9941
9919
  .UNINDENT
9920
+ .SS コマンド
9921
+ .sp
9922
+ groongaコマンドを通してデータベースを操作する命令をコマンドと呼びます。コマンドは主にC言語で記述され、groongaプロセスにロードすることによって使用できるようになります。
9923
+ それぞれのコマンドは一意な名前と、0個以上の引数を持ちます。
9924
+ .sp
9925
+ 引数は以下の2種類の方法のいずれかで指定することができます。:
9926
+ .INDENT 0.0
9927
+ .INDENT 3.5
9928
+ .sp
9929
+ .nf
9930
+ .ft C
9931
+ 形式1: コマンド名 値1 値2,..
9932
+
9933
+ 形式2: コマンド名 \-\-引数名1 値1 \-\-引数名2 値2,..
9934
+ .ft P
9935
+ .fi
9942
9936
  .UNINDENT
9943
9937
  .UNINDENT
9944
- .SS コマンドファイル
9945
9938
  .sp
9946
- コマンドファイルは、groonga組み込みコマンドを1行に1つずつ記述したテキストファイルです。拡張子に制限はありません。groonga組み込みコマンドに関しては \fB/reference/command\fP を参照してください。
9947
- .SS サンプル
9939
+ 形式1でコマンドを実行する場合は、定義された順番で値を指定しなければならず、途中の引数の値を省略することはできません。形式2でコマンドを実行する場合は、「\-\-引数名」のように引数の名前を明示しなければならない代わりに、任意の順番で引数を指定することが可能で、途中の引数の指定を省略することもできます。
9948
9940
  .sp
9949
- スクリプトファイルのサンプルです。:
9941
+ 標準入力からコマンド文字列を与える場合は、コマンド名と引数名と値は、空白( )で区切ります。空白や、記号「"\(aq()」のうちいずれかを含む値を指定したい場合は、シングルクォート(\(aq)かダブルクォート(")で値を囲みます。値として指定する文字列の中では、改行文字は\(aqn\(aqに置き換えて指定します。また、引用符に使用した文字を値の中で指定する場合には、その文字の前にバックスラッシュ(\(aq\(aq) を指定します。バックスラッシュ文字自身を値として指定する場合には、その前にバックスラッシュを指定します。
9942
+ .sp
9943
+ \(aq\e\(aq文字で継続行であることを明示してコマンドリストを記述することができます。
9950
9944
  .INDENT 0.0
9951
9945
  .INDENT 3.5
9952
9946
  .sp
9953
9947
  .nf
9954
9948
  .ft C
9955
- # sample script
9956
- rep_local test.ddl
9957
- do_local test.load;
9958
- do_gqtp test.select 10 10; do_local test.status 10
9949
+ table_create \-\-name Terms \e
9950
+ \-\-flags TABLE_PAT_KEY \e
9951
+ \-\-key_type ShortText \e
9952
+ \-\-default_tokenizer TokenBigram
9959
9953
  .ft P
9960
9954
  .fi
9961
9955
  .UNINDENT
9962
9956
  .UNINDENT
9957
+ .SS 組み込みコマンド
9963
9958
  .sp
9964
- 上記の意味は以下のとおりです。
9959
+ 以下のコマンドは組み込みコマンドとして予め定義されています。
9965
9960
  .INDENT 0.0
9966
9961
  .INDENT 3.5
9967
9962
  .INDENT 0.0
9968
9963
  .TP
9969
- .B 1行目
9970
- コメント行。
9964
+ .B \fBstatus\fP
9965
+ groongaプロセスの状態を表示します。
9971
9966
  .TP
9972
- .B 2行目
9973
- test.dll というコマンドファイルをgroonga単体で実行し、詳細に報告する。
9967
+ .B \fBtable_list\fP
9968
+ DBに定義されているテーブルのリストを表示します。
9974
9969
  .TP
9975
- .B 3行目
9976
- test.load というコマンドファイルをgroonga単体で実行する。(最後の";"セミコロンは複数のgrntest命令を記述する場合に必要ですが、この例のように1つのgrntest命令を実行する場合に付与しても問題ありません。)
9970
+ .B \fBcolumn_list\fP
9971
+ テーブルに定義されているカラムのリストを表示します。
9977
9972
  .TP
9978
- .B 4行目
9979
- test.select というコマンドファイルをgroongaサーバで10個のスレッドで同時に実行する。各スレッドはtest.selectの中身を10回繰り返す。また同時に、groonga単体でtest.statusというコマンドファイルを10個のスレッドで実行する。
9973
+ .B \fBtable_create\fP
9974
+ DBにテーブルを追加します。
9975
+ .TP
9976
+ .B \fBcolumn_create\fP
9977
+ テーブルにカラムを追加します。
9978
+ .TP
9979
+ .B \fBtable_remove\fP
9980
+ DBに定義されているテーブルを削除します。
9981
+ .TP
9982
+ .B \fBcolumn_remove\fP
9983
+ テーブルに定義されているカラムを削除します。
9984
+ .TP
9985
+ .B \fBload\fP
9986
+ テーブルにレコードを挿入します。
9987
+ .TP
9988
+ .B \fBselect\fP
9989
+ テーブルに含まれるレコードを検索して表示します。
9990
+ .TP
9991
+ .B \fBdefine_selector\fP
9992
+ 検索条件をカスタマイズした新たな検索コマンドを定義します。
9993
+ .TP
9994
+ .B \fBquit\fP
9995
+ データベースとのセッションを終了します。
9996
+ .TP
9997
+ .B \fBshutdown\fP
9998
+ サーバ(デーモン)プロセスを停止します。
9999
+ .TP
10000
+ .B \fBlog_level\fP
10001
+ ログ出力レベルを設定します。
10002
+ .TP
10003
+ .B \fBlog_put\fP
10004
+ ログ出力を行います。
10005
+ .TP
10006
+ .B \fBclearlock\fP
10007
+ ロックを解除します。
9980
10008
  .UNINDENT
9981
10009
  .UNINDENT
9982
10010
  .UNINDENT
9983
- .SS 特殊命令
10011
+ .SS
9984
10012
  .sp
9985
- スクリプトファイルのコメント行には特殊コマンドを埋め込むことが可能です。現在サポートされている特殊命令は以下の二つです。
10013
+ 新しいデータベースを作成します。:
9986
10014
  .INDENT 0.0
9987
10015
  .INDENT 3.5
9988
- .INDENT 0.0
9989
- .TP
9990
- .B #SET_HOST <ip/hostname>
9991
- \-i, \-\-hostオプションと同等の機能です。コマンドラインオプションに指定したIPアドレス/ホスト名と、SET_HOSTで指定したIPアドレス/ホスト名が異なる場合、またコマンドラインオプションを指定しなかった場合にもSET_HOSTが優先されます。SET_HOSTを利用した場合、サーバが自動的には起動されないのもコマンドラインオプションで指定した場合と同様です。
9992
- .TP
9993
- .B #SET_PORT <port number>
9994
- \-p, \-\-port オプションと同等の機能です。コマンドラインオプションに指定したポート番号とSET_PORTで指定したポート番号が異なる場合、またコマンドラインオプションを指定しなかった場合にもSET_PORTが優先されます。
9995
- .UNINDENT
10016
+ .sp
10017
+ .nf
10018
+ .ft C
10019
+ % groonga \-n /tmp/hoge.db quit
10020
+ %
10021
+ .ft P
10022
+ .fi
9996
10023
  .UNINDENT
9997
10024
  .UNINDENT
9998
10025
  .sp
9999
- 特殊命令はスクリプトファイルの任意の場所に書き込むことができます。同一ファイル内に複数回特殊命令を記述した場合、「最後の」特殊命令が有効となります。
10000
- .sp
10001
- 例えば、
10026
+ 作成済みのデータベースにテーブルを定義します。:
10002
10027
  .INDENT 0.0
10003
10028
  .INDENT 3.5
10004
10029
  .sp
10005
10030
  .nf
10006
10031
  .ft C
10007
- $ ./grntest \-\-port 20010 test.scr testdb
10032
+ % groonga /tmp/hoge.db table_create Table 0 ShortText
10033
+ [[0]]
10034
+ %
10008
10035
  .ft P
10009
10036
  .fi
10010
10037
  .UNINDENT
10011
10038
  .UNINDENT
10012
10039
  .sp
10013
- とコマンド上でポートを指定した場合でも、もしtest.scrの中身が
10040
+ サーバを起動します。:
10014
10041
  .INDENT 0.0
10015
10042
  .INDENT 3.5
10016
10043
  .sp
10017
10044
  .nf
10018
10045
  .ft C
10019
- #SET_PORT 10900
10020
- rep_local test.ddl
10021
- do_local test.load;
10022
- rep_gqtp test.select 10 10; rep_local test.status 10
10023
- #SET_PORT 10400
10046
+ % groonga \-d /tmp/hoge.db
10047
+ %
10024
10048
  .ft P
10025
10049
  .fi
10026
10050
  .UNINDENT
10027
10051
  .UNINDENT
10028
10052
  .sp
10029
- であれば、自動的に起動されるgroongaサーバはポート番号10400を利用します。
10030
- .SS grntest実行結果
10031
- .sp
10032
- grntestが正常に終了すると、(拡張子を除いた)スクリプト名\-ユーザ名\-実行開始時刻.logという形式のログファイルがカレントディレクトリに作られます。ログファイルは自動的にftp.groonga.org
10033
- に送信されます。ログファイルは以下のようなjson形式のテキストです。
10053
+ httpサーバとして起動します。:
10034
10054
  .INDENT 0.0
10035
10055
  .INDENT 3.5
10036
10056
  .sp
10037
10057
  .nf
10038
10058
  .ft C
10039
- [{"script": "test.scr",
10040
- "user": "homepage",
10041
- "date": "2010\-04\-14 22:47:04",
10042
- "CPU": Intel(R) Pentium(R) 4 CPU 2.80GHz",
10043
- "BIT": 32,
10044
- "CORE": 1,
10045
- "RAM": "975MBytes",
10046
- "HDD": "257662232KBytes",
10047
- "OS": "Linux 2.4.20\-24.7\-i686",
10048
- "HOST": "localhost",
10049
- "PORT": "10041",
10050
- "VERSION": "0.1.8\-100\-ga54c5f8"
10051
- },
10052
- {"jobs": "rep_local test.ddl",
10053
- "detail": [
10054
- [0, "table_create res_table \-\-key_type ShortText", 1490, 3086, [0,1271252824.25846,0.00144
10055
- 7]],
10056
- [0, "column_create res_table res_column \-\-type Text", 3137, 5956, [0,1271252824.2601,0.002
10057
- 741]],
10058
- [0, "column_create res_table user_column \-\-type Text", 6020, 8935, [0,1271252824.26298,0.0
10059
- 02841]],
10060
- [0, "column_create res_table mail_column \-\-type Text", 8990, 11925, [0,1271252824.26595,0.
10061
- 002861]],
10062
- [0, "column_create res_table time_column \-\-type Time", 12008, 13192, [0,1271252824.26897,0
10063
- \&.001147]],
10064
- [0, "status", 13214, 13277, [0,1271252824.27018,3.0e\-05]],
10065
- [0, "table_create thread_table \-\-key_type ShortText", 13289, 14541, [0,1271252824.27025,0.
10066
- 001213]],
10067
- [0, "column_create thread_table thread_title_column \-\-type ShortText", 14570, 17380, [0,12
10068
- 71252824.27153,0.002741]],
10069
- [0, "status", 17435, 17480, [0,1271252824.2744,2.7e\-05]],
10070
- [0, "table_create lexicon_table \-\-flags 129 \-\-key_type ShortText \-\-default_tokenizer Token
10071
- Bigram", 17491, 18970, [0,1271252824.27446,0.001431]],
10072
- [0, "column_create lexicon_table inv_res_column 514 res_table res_column ", 18998, 33248,
10073
- [0,1271252824.27596,0.01418]],
10074
- [0, "column_create lexicon_table inv_thread_column 514 thread_table thread_title_column ",
10075
- 33285, 48472, [0,1271252824.29025,0.015119]],
10076
- [0, "status", 48509, 48554, [0,1271252824.30547,2.7e\-05]]],
10077
- "summary" :[{"job": "rep_local test.ddl", "latency": 48607, "self": 47719, "qps": 272.4281
10078
- 73, "min": 45, "max": 15187, "queries": 13}]},
10079
- {"jobs": "do_local test.load; ",
10080
- "summary" :[{"job": "do_local test.load", "latency": 68693, "self": 19801, "qps": 1010.049
10081
- 997, "min": 202, "max": 5453, "queries": 20}]},
10082
- {"jobs": "do_gqtp test.select 10 10; do_local test.status 10",
10083
- "summary" :[{"job": " do_local test.status 10", "latency": 805990, "self": 737014, "qps":
10084
- 54.273053, "min": 24, "max": 218, "queries": 40},{"job": "do_gqtp test.select 10 10", "lat
10085
- ency": 831495, "self": 762519, "qps": 1967.164097, "min": 73, "max": 135631, "queries": 15
10086
- 00}]},
10087
- {"total": 915408, "qps": 1718.359464, "queries": 1573}]
10059
+ % groonga \-d \-p 80 \-\-protocol http \-\-document\-root /usr/share/groonga/admin_html /tmp/hoge.db
10060
+ %
10088
10061
  .ft P
10089
10062
  .fi
10090
10063
  .UNINDENT
10091
10064
  .UNINDENT
10092
- .SS 制限事項
10093
- .INDENT 0.0
10094
- .IP \(bu 2
10095
- スクリプトファイルの一行には複数のgrntest命令を記述できますが、すべてのスレッド数の合計は最大64までに制限されます。
10096
- .IP \(bu 2
10097
- コマンドファイル中のgroongaコマンドの長さは最長5000000byteです。
10098
- .UNINDENT
10099
- .SS トラブルシューティング
10100
10065
  .sp
10101
- もし、grntestが正常に動作しない場合、まず以下を確認してください。
10066
+ サーバに接続し、テーブル一覧を表示します。:
10102
10067
  .INDENT 0.0
10103
- .IP \(bu 2
10104
- インターネットに接続しているか? \fI\-\-ftp\fP オプションを指定すると、grntestは動作のたびにftp.groonga.orgと通信します。ftp.groonga.orgと通信可能でない場合、grntestは正常に動作しません。
10105
- .IP \(bu 2
10106
- groonga サーバが動作していないか? grntestは、\-i, \-\-host オプションで明示的にサーバを指定しないかぎり、自動的にlocalhostのgroongaサーバを立ち上げます。すでにgroongaサーバが動作している場合、grntestは正常に動作しない可能性があります。
10107
- .IP \(bu 2
10108
- 指定したDBが適切か? grntestは、引数で指定したDBの中身はチェックしません。もし指定されたDBが存在しなければ自動的にDBを作成しますが、もしファイルとして存在する場合は中身に関わらず動作を続けてしまい、結果が異常になる可能性があります。
10109
- .UNINDENT
10068
+ .INDENT 3.5
10110
10069
  .sp
10111
- 以上の原因でなければ、問題はgrntestかgroongaにあります。ご報告をお願いします。
10112
- .SS groongaコマンド
10070
+ .nf
10071
+ .ft C
10072
+ % groonga \-c localhost table_list
10073
+ [[0],[["id","name","path","flags","domain"],[256,"Table","/tmp/hoge.db.0000100",49152,14]]]
10074
+ %
10075
+ .ft P
10076
+ .fi
10077
+ .UNINDENT
10078
+ .UNINDENT
10079
+ .SS groonga\-benchmark
10113
10080
  .SS 名前
10114
10081
  .sp
10115
- groonga \- 列指向データベース機能を持つ全文検索エンジンソフトウェア
10082
+ groonga\-benchmark \- groongaテストプログラム
10116
10083
  .SS 書式
10117
10084
  .INDENT 0.0
10118
10085
  .INDENT 3.5
10119
10086
  .sp
10120
10087
  .nf
10121
10088
  .ft C
10122
- groonga [options] [dest] [command [args]]
10089
+ groonga\-benchmark [options...] [script] [db]
10123
10090
  .ft P
10124
10091
  .fi
10125
10092
  .UNINDENT
10126
10093
  .UNINDENT
10127
10094
  .SS 説明
10128
10095
  .sp
10129
- groongaは列指向のデータベース機能を持つ高速でスケーラブルな全文検索エンジンです。
10130
- groongaのデータベースは、groongaコマンドかCライブラリインタフェースを通して操作することができます。このマニュアルページでは、groongaコマンドの使い方について説明します。
10096
+ groonga\-benchmarkは、groonga汎用ベンチマークツールです。
10097
+ .sp
10098
+ groongaを単独のプロセスとして利用する場合はもちろん、サーバプログラムとして利用する場合の動作確認や実行速度測定が可能です。
10099
+ .sp
10100
+ groonga\-benchmark用のデータファイルは自分で作成することも既存のものを利用することもできます。既存のデータファイルは、ftp.groonga.orgから必要に応じダウンロードします。そのため、groonga及びgroonga\-benchmarkが動作し、インターネットに接続できる環境であればgroongaコマンドの知識がなくてもgroongaの動作を確認できます。
10101
+ .sp
10102
+ 現在は、Linux 及びWindows上で動作します。make installしてもインストールは行われません。
10131
10103
  .SS オプション
10132
10104
  .INDENT 0.0
10133
10105
  .TP
10134
- .B \-n
10135
- 新たなデータベースを作成します。
10106
+ .B \-i, \-\-host <ip/hostname>
10107
+ 接続するgroongaサーバを、ipアドレスまたはホスト名で指定します。指定先にgroongaサーバが立ち上がっていない場合、接続不能となることに注意してください。このオプションを指定しない場合、groonga\-benchmarkは自動的にlocalhostのgroongaサーバを起動して接続します。
10136
10108
  .UNINDENT
10137
10109
  .INDENT 0.0
10138
10110
  .TP
10139
- .B \-c
10140
- クライアントモードで実行します。
10111
+ .B \-p, \-\-port <port number>
10112
+ 自動的に起動するgroongaサーバ、または明示的に指定した接続先のgroonga サーバが利用するポート番号を指定します。接続先のgroongaサーバが利用しているポートと、このオプションで指定したポート番号が異なる場合、接続不能となることに注意してください。
10141
10113
  .UNINDENT
10142
10114
  .INDENT 0.0
10143
10115
  .TP
10144
- .B \-s
10145
- サーバモードで実行します。
10116
+ .B \-\-dir
10117
+ ftp.groonga.org に用意されているスクリプトファイルを表示します。
10146
10118
  .UNINDENT
10147
10119
  .INDENT 0.0
10148
10120
  .TP
10149
- .B \-d
10150
- デーモンモードで実行します。(forkする点がサーバモードと異なる)
10121
+ .B \-\-ftp
10122
+ ftp.groonga.orgとFTP通信を行い、scriptファイルの同期やログファイルの送信を行います。
10151
10123
  .UNINDENT
10152
10124
  .INDENT 0.0
10153
10125
  .TP
10154
- .B \-e, \-\-encoding <encoding>
10155
- データベースで使用する文字エンコーディング方式を指定します。新たなデータベースを作成する時のみ有効です。none, euc, utf8, sjis, latin, koi8rのいずれかが指定できます。
10126
+ .B \-\-log\-output\-dir
10127
+ デフォルトでは、groonga\-benchmark終了後のログファイルの出力先ははカレントディレクトリです。このオプションを利用すると、任意のディレクトリに出力先を変更することができます。
10156
10128
  .UNINDENT
10157
10129
  .INDENT 0.0
10158
10130
  .TP
10159
- .B \-l, \-\-log\-level <log level>
10160
- ログレベルを指定します。0〜8までの数値が指定可能で、数が大きいほど多くのログが出力されます。
10131
+ .B \-\-groonga <groonga_path>
10132
+ groongaコマンドのパスを指定します。デフォルトでは、PATHの中からgroongaコマンドを探します。
10161
10133
  .UNINDENT
10162
10134
  .INDENT 0.0
10163
10135
  .TP
10164
- .B \-a, \-\-address <ip/hostname>
10165
- バージョン 1.2.2 で撤廃: Use \fI\-\-bind\-address\fP instead.
10166
-
10136
+ .B \-\-protocol <gqtp|http>
10137
+ groongaコマンドが使うプロトコルとして \fIgqtp\fP または \fIhttp\fP を指定します。
10167
10138
  .UNINDENT
10139
+ .SS 引数
10168
10140
  .INDENT 0.0
10169
10141
  .TP
10170
- .B \-\-bind\-address <ip/hostname>
10171
- バージョン 1.2.2 で追加.
10172
-
10173
- .sp
10174
- サーバモードかデーモンモードで実行するとき、listenするアドレスを指定します。(デフォルトは \fIhostname\fP の返すホスト名)
10142
+ .B script
10143
+ groonga\-benchmarkの動作方法(以下、groonga\-benchmark命令と呼びます)を記述したテキストファイルです。拡張子は.scrです。
10175
10144
  .UNINDENT
10176
10145
  .INDENT 0.0
10177
10146
  .TP
10178
- .B \-p, \-\-port <port number>
10179
- クライアント、サーバ、またはデーモンモードで使用するTCPポート番号。
10180
- (デフォルトは10041番)
10147
+ .B db
10148
+ groonga\-benchmarkが利用するgroonga データベースです。指定されたデータベースが存在しない場合、groonga\-benchmarkが新規に作成します。またgroonga サーバを自動的に起動する場合もこの引数で指定したデータベースが利用されます。接続するgroonga サーバを明示的に指定した場合に利用するデータベースは、接続先サーバが使用中のデータベースになることに注意してください。
10181
10149
  .UNINDENT
10150
+ .SS 使い方
10151
+ .sp
10152
+ まず、シェル上(Windowsならコマンドプロンプト上)で:
10182
10153
  .INDENT 0.0
10183
- .TP
10184
- .B \-i, \-\-server\-id <ip/hostname>
10185
- サーバモードかデーモンモードで実行するとき、サーバのIDとなるアドレスを指定します。(デフォルトは\(gahostname\(gaの返すホスト名)
10154
+ .INDENT 3.5
10155
+ .sp
10156
+ .nf
10157
+ .ft C
10158
+ groonga\-benchmark test.scr 任意のDB名
10159
+ .ft P
10160
+ .fi
10186
10161
  .UNINDENT
10187
- .INDENT 0.0
10188
- .TP
10189
- .B \-h, \-\-help
10190
- ヘルプメッセージを出力します。
10191
10162
  .UNINDENT
10163
+ .sp
10164
+ とタイプしてください。もしgroonga\-benchmarkが正常に動作すれば、:
10192
10165
  .INDENT 0.0
10193
- .TP
10194
- .B \-\-document\-root <path>
10195
- httpサーバとしてgroongaを使用する場合に静的ページを格納するディレクトリを指定します。
10166
+ .INDENT 3.5
10196
10167
  .sp
10197
- デフォルトでは、データベースを管理するための汎用的なページに対応するファイルが/usr/share/groonga/admin_html以下にインストールされます。このディレクトリをdocument\-rootオプションの値に指定して起動した場合、ウェブブラウザでhttp://hostname:port/index.htmlにアクセスすると、ウェブベースのデータベース管理ツールを使用できます。
10168
+ .nf
10169
+ .ft C
10170
+ test\-ユーザ名\-数字.log
10171
+ .ft P
10172
+ .fi
10198
10173
  .UNINDENT
10174
+ .UNINDENT
10175
+ .sp
10176
+ というファイルが作成されるはずです。作成されない場合、このドキュメントの「トラブルシューティング」の章を参照してください。
10177
+ .SS スクリプトファイル
10178
+ .sp
10179
+ スクリプトファイルは、groonga\-benchmark命令を記述したテキストファイルです。
10180
+ ";"セミコロンを利用して、一行に複数のgroonga\-benchmark命令を記述することができます。一行に複数のgroonga\-benchmark命令がある場合、各命令は並列に実行されます。
10181
+ "#"で始まる行はコメントとして扱われます。
10182
+ .SS groonga\-benchmark命令
10183
+ .sp
10184
+ 現在サポートされているgroonga\-benchmark命令は以下の8つです。
10199
10185
  .INDENT 0.0
10200
- .TP
10201
- .B \-\-protocol <protocol>
10202
- http,gqtpのいずれかを指定します。(デフォルトはgqtp)
10186
+ .INDENT 3.5
10187
+ do_local コマンドファイル [スレッド数] [繰り返し数]
10188
+ .INDENT 0.0
10189
+ .INDENT 3.5
10190
+ コマンドファイルをgroonga\-benchmark単体で実行します。スレッド数が指定されている場合、複数のスレッドで同じコマンドファイルを同時に実行します。繰り返し数が指定されてい場合、コマンドファイルの内容を繰り返し実行します。スレッド数、繰り返し数とも省略時は1です。1スレッドで複数回動作させたい場合は、do_local コマンドファイル 1 [繰り返し数]と明示的に指定してください。
10203
10191
  .UNINDENT
10192
+ .UNINDENT
10193
+ .sp
10194
+ do_gqpt コマンドファイル [スレッド数] [繰り返し数]
10204
10195
  .INDENT 0.0
10205
- .TP
10206
- .B \-\-log\-path <path>
10207
- ログを出力するファイルのパスを指定します。(デフォルトは/var/log/groonga/groonga.logです)
10196
+ .INDENT 3.5
10197
+ コマンドファイルをgroongaサーバで実行します。スレッド数や繰り返し数の意味はdo_localの場合と同じです。
10208
10198
  .UNINDENT
10199
+ .UNINDENT
10200
+ .sp
10201
+ rep_local コマンドファイル [スレッド数] [繰り返し数]
10209
10202
  .INDENT 0.0
10210
- .TP
10211
- .B \-\-query\-log\-path <path>
10212
- クエリーログを出力するファイルのパスを指定します。(デフォルトでは出力されません)
10203
+ .INDENT 3.5
10204
+ コマンドファイルをgroonga\-benchmark単体で実行し、より詳細な報告を行います。
10205
+ .UNINDENT
10213
10206
  .UNINDENT
10207
+ .sp
10208
+ rep_gqpt コマンドファイル [スレッド数] [繰り返し数]
10214
10209
  .INDENT 0.0
10215
- .TP
10216
- .B \-t, \-\-max\-threads <max threasd>
10217
- 最大で利用するスレッド数を指定します。(デフォルトはマシンのCPUコア数と同じ数です)
10210
+ .INDENT 3.5
10211
+ コマンドファイルをgroongaサーバで実行し、より詳細な報告を行います。 スレッド数や繰り返し数の意味はdo_localと 同じです。
10212
+ .UNINDENT
10218
10213
  .UNINDENT
10214
+ .sp
10215
+ out_local コマンドファイル 入力ファイル名
10219
10216
  .INDENT 0.0
10220
- .TP
10221
- .B \-\-pid\-path <path>
10222
- PIDを保存するパスを指定します。(デフォルトでは保存しません)
10223
- .UNINDENT
10217
+ .INDENT 3.5
10218
+ コマンドファイルをgroonga\-benchmark単体で実行し、各コマンドの実行結果をすべて”出力ファイル"に書きだします。この結果は、test_local, test_gqtp命令で利用します。なおこの命令の「出力ファイル」とは、groonga\-benchmark実行時に自動的に作成されるログとは別のものです。groonga\-benchmarkではコメントが利用できる以外、:
10224
10219
  .INDENT 0.0
10225
- .TP
10226
- .B \-\-config\-path <path>
10227
- 設定ファイルのパスを指定します。設定ファイルは以下のようなフォーマットになります。:
10228
- .INDENT 7.0
10229
10220
  .INDENT 3.5
10230
10221
  .sp
10231
10222
  .nf
10232
10223
  .ft C
10233
- # \(aq#\(aq以降はコメント。
10234
- ; \(aq;\(aq以降もコメント。
10235
-
10236
- # \(aqキー = 値\(aqでオプションを指定。
10237
- pid\-file = /var/run/groonga.pid
10238
-
10239
- # \(aq=\(aqの前後の空白はは無視される。↓は↑と同じ意味。
10240
- pid\-file=/var/run/groonga.pid
10241
-
10242
- # \(aqキー\(aqは\(aq\-\-XXX\(aqスタイルのオプション名と同じものが使える。
10243
- # 例えば、\(aq\-\-pid\-path\(aqに対応するキーは\(aqpid\-path\(aq。
10244
- # ただし、キーが\(aqconfig\-path\(aqのオプションは無視される。
10224
+ groonga < コマンドファイル > 出力ファイル
10245
10225
  .ft P
10246
10226
  .fi
10247
10227
  .UNINDENT
10248
10228
  .UNINDENT
10229
+ .sp
10230
+ とした場合と同じです。
10249
10231
  .UNINDENT
10250
- .INDENT 0.0
10251
- .TP
10252
- .B \-\-cache\-limit <limit>
10253
- キャッシュ数の最大値を指定します。(デフォルトは100です)
10254
10232
  .UNINDENT
10233
+ .sp
10234
+ out_gqtp コマンドファイル 出力ファイル名
10255
10235
  .INDENT 0.0
10256
- .TP
10257
- .B \-\-default\-match\-escalation\-threshold <threshold>
10258
- 検索の挙動をエスカレーションする閾値を指定します。(デフォルトは0です)
10236
+ .INDENT 3.5
10237
+ コマンドファイルをgroongaサーバで実行します。その他はout_local命令と同等です。
10259
10238
  .UNINDENT
10260
- .SS 引数
10261
- .INDENT 0.0
10262
- .TP
10263
- .B dest
10264
- 使用するデータベースのパス名を指定します。
10265
- .sp
10266
- クライアントモードの場合は接続先のホスト名とポート番号を指定します(デフォルト値は\(aqlocalhost:10041\(aq)。ポート番号を指定しない場合には、10041が指定されたものとします。
10267
10239
  .UNINDENT
10268
10240
  .INDENT 0.0
10269
10241
  .TP
10270
- .B command [args]
10271
- スタンドアロンおよびクライアントモードの場合は、実行するコマンドとその引数をコマンドライン引数に指定できます。コマンドライン引数にcommandを与えなかった場合は、標準入力から一行ずつEOFに達するまでコマンド文字列を読み取り、順次実行します。
10242
+ .B test_local コマンドファイル 入力ファイル名
10243
+ コマンドファイルをgroonga\-benchmark単体で実行し、各コマンドの実行結果を入力ファイルと比較します。処理時間など本質的要素以外に差分があった場合、差分を、入力ファイル.diffというファイルに書きだします。
10272
10244
  .UNINDENT
10273
- .SS コマンド
10274
- .sp
10275
- groongaコマンドを通してデータベースを操作する命令をコマンドと呼びます。コマンドは主にC言語で記述され、groongaプロセスにロードすることによって使用できるようになります。
10276
- それぞれのコマンドは一意な名前と、0個以上の引数を持ちます。
10277
- .sp
10278
- 引数は以下の2種類の方法のいずれかで指定することができます。:
10279
- .INDENT 0.0
10280
- .INDENT 3.5
10281
- .sp
10282
- .nf
10283
- .ft C
10284
- 形式1: コマンド名 値1 値2,..
10285
-
10286
- 形式2: コマンド名 \-\-引数名1 値1 \-\-引数名2 値2,..
10287
- .ft P
10288
- .fi
10289
10245
  .UNINDENT
10290
10246
  .UNINDENT
10247
+ .SS コマンドファイル
10291
10248
  .sp
10292
- 形式1でコマンドを実行する場合は、定義された順番で値を指定しなければならず、途中の引数の値を省略することはできません。形式2でコマンドを実行する場合は、「\-\-引数名」のように引数の名前を明示しなければならない代わりに、任意の順番で引数を指定することが可能で、途中の引数の指定を省略することもできます。
10293
- .sp
10294
- 標準入力からコマンド文字列を与える場合は、コマンド名と引数名と値は、空白( )で区切ります。空白や、記号「"\(aq()」のうちいずれかを含む値を指定したい場合は、シングルクォート(\(aq)かダブルクォート(")で値を囲みます。値として指定する文字列の中では、改行文字は\(aqn\(aqに置き換えて指定します。また、引用符に使用した文字を値の中で指定する場合には、その文字の前にバックスラッシュ(\(aq\(aq) を指定します。バックスラッシュ文字自身を値として指定する場合には、その前にバックスラッシュを指定します。
10249
+ コマンドファイルは、groonga組み込みコマンドを1行に1つずつ記述したテキストファイルです。拡張子に制限はありません。groonga組み込みコマンドに関しては \fB/reference/command\fP を参照してください。
10250
+ .SS サンプル
10295
10251
  .sp
10296
- \(aq\e\(aq文字で継続行であることを明示してコマンドリストを記述することができます。
10252
+ スクリプトファイルのサンプルです。:
10297
10253
  .INDENT 0.0
10298
10254
  .INDENT 3.5
10299
10255
  .sp
10300
10256
  .nf
10301
10257
  .ft C
10302
- table_create \-\-name Terms \e
10303
- \-\-flags TABLE_PAT_KEY \e
10304
- \-\-key_type ShortText \e
10305
- \-\-default_tokenizer TokenBigram
10258
+ # sample script
10259
+ rep_local test.ddl
10260
+ do_local test.load;
10261
+ do_gqtp test.select 10 10; do_local test.status 10
10306
10262
  .ft P
10307
10263
  .fi
10308
10264
  .UNINDENT
10309
10265
  .UNINDENT
10310
- .SS 組み込みコマンド
10311
10266
  .sp
10312
- 以下のコマンドは組み込みコマンドとして予め定義されています。
10267
+ 上記の意味は以下のとおりです。
10313
10268
  .INDENT 0.0
10314
10269
  .INDENT 3.5
10315
10270
  .INDENT 0.0
10316
10271
  .TP
10317
- .B \fBstatus\fP
10318
- groongaプロセスの状態を表示します。
10319
- .TP
10320
- .B \fBtable_list\fP
10321
- DBに定義されているテーブルのリストを表示します。
10322
- .TP
10323
- .B \fBcolumn_list\fP
10324
- テーブルに定義されているカラムのリストを表示します。
10325
- .TP
10326
- .B \fBtable_create\fP
10327
- DBにテーブルを追加します。
10328
- .TP
10329
- .B \fBcolumn_create\fP
10330
- テーブルにカラムを追加します。
10331
- .TP
10332
- .B \fBtable_remove\fP
10333
- DBに定義されているテーブルを削除します。
10334
- .TP
10335
- .B \fBcolumn_remove\fP
10336
- テーブルに定義されているカラムを削除します。
10337
- .TP
10338
- .B \fBload\fP
10339
- テーブルにレコードを挿入します。
10340
- .TP
10341
- .B \fBselect\fP
10342
- テーブルに含まれるレコードを検索して表示します。
10343
- .TP
10344
- .B \fBdefine_selector\fP
10345
- 検索条件をカスタマイズした新たな検索コマンドを定義します。
10346
- .TP
10347
- .B \fBquit\fP
10348
- データベースとのセッションを終了します。
10349
- .TP
10350
- .B \fBshutdown\fP
10351
- サーバ(デーモン)プロセスを停止します。
10272
+ .B 1行目
10273
+ コメント行。
10352
10274
  .TP
10353
- .B \fBlog_level\fP
10354
- ログ出力レベルを設定します。
10275
+ .B 2行目
10276
+ test.dll というコマンドファイルをgroonga単体で実行し、詳細に報告する。
10355
10277
  .TP
10356
- .B \fBlog_put\fP
10357
- ログ出力を行います。
10278
+ .B 3行目
10279
+ test.load というコマンドファイルをgroonga単体で実行する。(最後の";"セミコロンは複数のgroonga\-benchmark命令を記述する場合に必要ですが、この例のように1つのgroonga\-benchmark命令を実行する場合に付与しても問題ありません。)
10358
10280
  .TP
10359
- .B \fBclearlock\fP
10360
- ロックを解除します。
10281
+ .B 4行目
10282
+ test.select というコマンドファイルをgroongaサーバで10個のスレッドで同時に実行する。各スレッドはtest.selectの中身を10回繰り返す。また同時に、groonga単体でtest.statusというコマンドファイルを10個のスレッドで実行する。
10361
10283
  .UNINDENT
10362
10284
  .UNINDENT
10363
10285
  .UNINDENT
10364
- .SS
10286
+ .SS 特殊命令
10365
10287
  .sp
10366
- 新しいデータベースを作成します。:
10288
+ スクリプトファイルのコメント行には特殊コマンドを埋め込むことが可能です。現在サポートされている特殊命令は以下の二つです。
10367
10289
  .INDENT 0.0
10368
10290
  .INDENT 3.5
10369
- .sp
10370
- .nf
10371
- .ft C
10372
- % groonga \-n /tmp/hoge.db quit
10373
- %
10374
- .ft P
10375
- .fi
10291
+ .INDENT 0.0
10292
+ .TP
10293
+ .B #SET_HOST <ip/hostname>
10294
+ \-i, \-\-hostオプションと同等の機能です。コマンドラインオプションに指定したIPアドレス/ホスト名と、SET_HOSTで指定したIPアドレス/ホスト名が異なる場合、またコマンドラインオプションを指定しなかった場合にもSET_HOSTが優先されます。SET_HOSTを利用した場合、サーバが自動的には起動されないのもコマンドラインオプションで指定した場合と同様です。
10295
+ .TP
10296
+ .B #SET_PORT <port number>
10297
+ \-p, \-\-port オプションと同等の機能です。コマンドラインオプションに指定したポート番号とSET_PORTで指定したポート番号が異なる場合、またコマンドラインオプションを指定しなかった場合にもSET_PORTが優先されます。
10298
+ .UNINDENT
10376
10299
  .UNINDENT
10377
10300
  .UNINDENT
10378
10301
  .sp
10379
- 作成済みのデータベースにテーブルを定義します。:
10302
+ 特殊命令はスクリプトファイルの任意の場所に書き込むことができます。同一ファイル内に複数回特殊命令を記述した場合、「最後の」特殊命令が有効となります。
10303
+ .sp
10304
+ 例えば、
10380
10305
  .INDENT 0.0
10381
10306
  .INDENT 3.5
10382
10307
  .sp
10383
10308
  .nf
10384
10309
  .ft C
10385
- % groonga /tmp/hoge.db table_create Table 0 ShortText
10386
- [[0]]
10387
- %
10310
+ $ ./groonga\-benchmark \-\-port 20010 test.scr testdb
10388
10311
  .ft P
10389
10312
  .fi
10390
10313
  .UNINDENT
10391
10314
  .UNINDENT
10392
10315
  .sp
10393
- サーバを起動します。:
10316
+ とコマンド上でポートを指定した場合でも、もしtest.scrの中身が
10394
10317
  .INDENT 0.0
10395
10318
  .INDENT 3.5
10396
10319
  .sp
10397
10320
  .nf
10398
10321
  .ft C
10399
- % groonga \-d /tmp/hoge.db
10400
- %
10322
+ #SET_PORT 10900
10323
+ rep_local test.ddl
10324
+ do_local test.load;
10325
+ rep_gqtp test.select 10 10; rep_local test.status 10
10326
+ #SET_PORT 10400
10401
10327
  .ft P
10402
10328
  .fi
10403
10329
  .UNINDENT
10404
10330
  .UNINDENT
10405
10331
  .sp
10406
- httpサーバとして起動します。:
10332
+ であれば、自動的に起動されるgroongaサーバはポート番号10400を利用します。
10333
+ .SS groonga\-benchmark実行結果
10334
+ .sp
10335
+ groonga\-benchmarkが正常に終了すると、(拡張子を除いた)スクリプト名\-ユーザ名\-実行開始時刻.logという形式のログファイルがカレントディレクトリに作られます。ログファイルは自動的にftp.groonga.org
10336
+ に送信されます。ログファイルは以下のようなjson形式のテキストです。
10407
10337
  .INDENT 0.0
10408
10338
  .INDENT 3.5
10409
10339
  .sp
10410
10340
  .nf
10411
10341
  .ft C
10412
- % groonga \-d \-p 80 \-\-protocol http \-\-document\-root /usr/share/groonga/admin_html /tmp/hoge.db
10413
- %
10342
+ [{"script": "test.scr",
10343
+ "user": "homepage",
10344
+ "date": "2010\-04\-14 22:47:04",
10345
+ "CPU": Intel(R) Pentium(R) 4 CPU 2.80GHz",
10346
+ "BIT": 32,
10347
+ "CORE": 1,
10348
+ "RAM": "975MBytes",
10349
+ "HDD": "257662232KBytes",
10350
+ "OS": "Linux 2.4.20\-24.7\-i686",
10351
+ "HOST": "localhost",
10352
+ "PORT": "10041",
10353
+ "VERSION": "0.1.8\-100\-ga54c5f8"
10354
+ },
10355
+ {"jobs": "rep_local test.ddl",
10356
+ "detail": [
10357
+ [0, "table_create res_table \-\-key_type ShortText", 1490, 3086, [0,1271252824.25846,0.00144
10358
+ 7]],
10359
+ [0, "column_create res_table res_column \-\-type Text", 3137, 5956, [0,1271252824.2601,0.002
10360
+ 741]],
10361
+ [0, "column_create res_table user_column \-\-type Text", 6020, 8935, [0,1271252824.26298,0.0
10362
+ 02841]],
10363
+ [0, "column_create res_table mail_column \-\-type Text", 8990, 11925, [0,1271252824.26595,0.
10364
+ 002861]],
10365
+ [0, "column_create res_table time_column \-\-type Time", 12008, 13192, [0,1271252824.26897,0
10366
+ \&.001147]],
10367
+ [0, "status", 13214, 13277, [0,1271252824.27018,3.0e\-05]],
10368
+ [0, "table_create thread_table \-\-key_type ShortText", 13289, 14541, [0,1271252824.27025,0.
10369
+ 001213]],
10370
+ [0, "column_create thread_table thread_title_column \-\-type ShortText", 14570, 17380, [0,12
10371
+ 71252824.27153,0.002741]],
10372
+ [0, "status", 17435, 17480, [0,1271252824.2744,2.7e\-05]],
10373
+ [0, "table_create lexicon_table \-\-flags 129 \-\-key_type ShortText \-\-default_tokenizer Token
10374
+ Bigram", 17491, 18970, [0,1271252824.27446,0.001431]],
10375
+ [0, "column_create lexicon_table inv_res_column 514 res_table res_column ", 18998, 33248,
10376
+ [0,1271252824.27596,0.01418]],
10377
+ [0, "column_create lexicon_table inv_thread_column 514 thread_table thread_title_column ",
10378
+ 33285, 48472, [0,1271252824.29025,0.015119]],
10379
+ [0, "status", 48509, 48554, [0,1271252824.30547,2.7e\-05]]],
10380
+ "summary" :[{"job": "rep_local test.ddl", "latency": 48607, "self": 47719, "qps": 272.4281
10381
+ 73, "min": 45, "max": 15187, "queries": 13}]},
10382
+ {"jobs": "do_local test.load; ",
10383
+ "summary" :[{"job": "do_local test.load", "latency": 68693, "self": 19801, "qps": 1010.049
10384
+ 997, "min": 202, "max": 5453, "queries": 20}]},
10385
+ {"jobs": "do_gqtp test.select 10 10; do_local test.status 10",
10386
+ "summary" :[{"job": " do_local test.status 10", "latency": 805990, "self": 737014, "qps":
10387
+ 54.273053, "min": 24, "max": 218, "queries": 40},{"job": "do_gqtp test.select 10 10", "lat
10388
+ ency": 831495, "self": 762519, "qps": 1967.164097, "min": 73, "max": 135631, "queries": 15
10389
+ 00}]},
10390
+ {"total": 915408, "qps": 1718.359464, "queries": 1573}]
10414
10391
  .ft P
10415
10392
  .fi
10416
10393
  .UNINDENT
10417
10394
  .UNINDENT
10418
- .sp
10419
- サーバに接続し、テーブル一覧を表示します。:
10395
+ .SS 制限事項
10420
10396
  .INDENT 0.0
10421
- .INDENT 3.5
10422
- .sp
10423
- .nf
10424
- .ft C
10425
- % groonga \-c localhost table_list
10426
- [[0],[["id","name","path","flags","domain"],[256,"Table","/tmp/hoge.db.0000100",49152,14]]]
10427
- %
10428
- .ft P
10429
- .fi
10397
+ .IP \(bu 2
10398
+ スクリプトファイルの一行には複数のgroonga\-benchmark命令を記述できますが、すべてのスレッド数の合計は最大64までに制限されます。
10399
+ .IP \(bu 2
10400
+ コマンドファイル中のgroongaコマンドの長さは最長5000000byteです。
10430
10401
  .UNINDENT
10402
+ .SS トラブルシューティング
10403
+ .sp
10404
+ もし、groonga\-benchmarkが正常に動作しない場合、まず以下を確認してください。
10405
+ .INDENT 0.0
10406
+ .IP \(bu 2
10407
+ インターネットに接続しているか? \fI\-\-ftp\fP オプションを指定すると、groonga\-benchmarkは動作のたびにftp.groonga.orgと通信します。ftp.groonga.orgと通信可能でない場合、groonga\-benchmarkは正常に動作しません。
10408
+ .IP \(bu 2
10409
+ groonga サーバが動作していないか? groonga\-benchmarkは、\-i, \-\-host オプションで明示的にサーバを指定しないかぎり、自動的にlocalhostのgroongaサーバを立ち上げます。すでにgroongaサーバが動作している場合、groonga\-benchmarkは正常に動作しない可能性があります。
10410
+ .IP \(bu 2
10411
+ 指定したDBが適切か? groonga\-benchmarkは、引数で指定したDBの中身はチェックしません。もし指定されたDBが存在しなければ自動的にDBを作成しますが、もしファイルとして存在する場合は中身に関わらず動作を続けてしまい、結果が異常になる可能性があります。
10431
10412
  .UNINDENT
10413
+ .sp
10414
+ 以上の原因でなければ、問題はgroonga\-benchmarkかgroongaにあります。ご報告をお願いします。
10432
10415
  .SS groonga\-httpd
10433
10416
  .SS 概要
10434
10417
  .sp
@@ -10504,14 +10487,14 @@ http {
10504
10487
  0.000355720520019531
10505
10488
  ],
10506
10489
  {
10507
- "uptime": 0,
10490
+ "uptime": 1,
10508
10491
  "max_command_version": 2,
10509
10492
  "n_queries": 0,
10510
10493
  "cache_hit_rate": 0.0,
10511
- "version": "3.0.7",
10512
- "alloc_count": 154,
10494
+ "version": "3.1.0",
10495
+ "alloc_count": 159,
10513
10496
  "command_version": 1,
10514
- "starttime": 1377493431,
10497
+ "starttime": 1385359876,
10515
10498
  "default_command_version": 1
10516
10499
  }
10517
10500
  ]
@@ -14277,6 +14260,21 @@ ruby_load path
14277
14260
  .sp
14278
14261
  Rubyスクリプトとして \fBexpression.rb\fP を単に読むこむ例です。
14279
14262
  .sp
14263
+ 実行例:
14264
+ .INDENT 0.0
14265
+ .INDENT 3.5
14266
+ .sp
14267
+ .nf
14268
+ .ft C
14269
+ register ruby/load
14270
+ # [[0, 1337566253.89858, 0.000355720520019531], true]
14271
+ ruby_load "expression.rb"
14272
+ # [[0, 1337566253.89858, 0.000355720520019531], {"value": null}]
14273
+ .ft P
14274
+ .fi
14275
+ .UNINDENT
14276
+ .UNINDENT
14277
+ .sp
14280
14278
  \fBruby_load\fP コマンドを使うには事前に \fBruby/load\fP プラグインを登録します。
14281
14279
  .sp
14282
14280
  \fBruby_load\fP コマンドは実験的なプラグインです。このコマンドは将来的に変更されるかも知れません。
@@ -16802,14 +16800,14 @@ status
16802
16800
  # 0.000355720520019531
16803
16801
  # ],
16804
16802
  # {
16805
- # "uptime": 50,
16803
+ # "uptime": 0,
16806
16804
  # "max_command_version": 2,
16807
- # "n_queries": 39,
16805
+ # "n_queries": 0,
16808
16806
  # "cache_hit_rate": 0.0,
16809
- # "version": "3.0.7",
16810
- # "alloc_count": 300,
16807
+ # "version": "3.1.0",
16808
+ # "alloc_count": 290,
16811
16809
  # "command_version": 1,
16812
- # "starttime": 1377493297,
16810
+ # "starttime": 1385359891,
16813
16811
  # "default_command_version": 1
16814
16812
  # }
16815
16813
  # ]
@@ -31268,7 +31266,7 @@ doc/locale/${LANGUAGE}/LC_MESSAGES/以下を.tar.gzや.zipなどでアーカイ
31268
31266
  \fIsearch\fP
31269
31267
  .UNINDENT
31270
31268
  .SH AUTHOR
31271
- groonga project
31269
+ Groonga Project
31272
31270
  .SH COPYRIGHT
31273
31271
  2009-2013, Brazil, Inc
31274
31272
  .\" Generated by docutils manpage writer.