rroonga 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (398) hide show
  1. data/AUTHORS +5 -0
  2. data/Gemfile +1 -12
  3. data/README.textile +73 -0
  4. data/Rakefile +4 -57
  5. data/bin/grndump +11 -1
  6. data/ext/groonga/extconf.rb +125 -54
  7. data/ext/groonga/rb-grn-context.c +25 -7
  8. data/ext/groonga/rb-grn-database.c +25 -0
  9. data/ext/groonga/rb-grn-object.c +19 -7
  10. data/ext/groonga/rb-grn-table.c +8 -10
  11. data/ext/groonga/rb-grn.h +9 -2
  12. data/lib/1.8/groonga.so +0 -0
  13. data/lib/1.9/groonga.so +0 -0
  14. data/lib/groonga/dumper.rb +2 -2
  15. data/lib/groonga/expression-builder.rb +33 -18
  16. data/rroonga-build.rb +1 -1
  17. data/vendor/local/bin/groonga-benchmark.exe +0 -0
  18. data/vendor/local/bin/groonga.exe +0 -0
  19. data/vendor/local/bin/libgcc_s_sjlj-1.dll +0 -0
  20. data/vendor/local/bin/libgroonga-0.dll +0 -0
  21. data/vendor/local/bin/libmecab-1.dll +0 -0
  22. data/vendor/local/bin/libmsgpack-3.dll +0 -0
  23. data/vendor/local/bin/libmsgpackc-2.dll +0 -0
  24. data/vendor/local/bin/libstdc++-6.dll +0 -0
  25. data/vendor/local/bin/mecab-config +0 -0
  26. data/vendor/local/bin/mecab.exe +0 -0
  27. data/vendor/local/include/groonga/groonga.h +5 -5
  28. data/vendor/local/lib/groonga/plugins/suggest/suggest.a +0 -0
  29. data/vendor/local/lib/groonga/plugins/suggest/suggest.dll +0 -0
  30. data/vendor/local/lib/groonga/plugins/suggest/suggest.dll.a +0 -0
  31. data/vendor/local/lib/groonga/plugins/suggest/suggest.la +0 -0
  32. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.a +0 -0
  33. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll +0 -0
  34. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll.a +0 -0
  35. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.la +0 -0
  36. data/vendor/local/lib/libgroonga.a +0 -0
  37. data/vendor/local/lib/libgroonga.dll.a +0 -0
  38. data/vendor/local/lib/libgroonga.la +0 -0
  39. data/vendor/local/lib/libmecab.a +0 -0
  40. data/vendor/local/lib/libmecab.dll.a +0 -0
  41. data/vendor/local/lib/libmecab.la +0 -0
  42. data/vendor/local/lib/libmsgpack.a +0 -0
  43. data/vendor/local/lib/libmsgpack.dll.a +0 -0
  44. data/vendor/local/lib/libmsgpack.la +0 -0
  45. data/vendor/local/lib/libmsgpackc.a +0 -0
  46. data/vendor/local/lib/libmsgpackc.dll.a +0 -0
  47. data/vendor/local/lib/libmsgpackc.la +0 -0
  48. data/vendor/local/lib/pkgconfig/groonga.pc +4 -4
  49. data/vendor/local/libexec/mecab/mecab-cost-train.exe +0 -0
  50. data/vendor/local/libexec/mecab/mecab-dict-gen.exe +0 -0
  51. data/vendor/local/libexec/mecab/mecab-dict-index.exe +0 -0
  52. data/vendor/local/libexec/mecab/mecab-system-eval.exe +0 -0
  53. data/vendor/local/libexec/mecab/mecab-test-gen.exe +0 -0
  54. data/vendor/local/share/doc/groonga/en/html/.buildinfo +1 -1
  55. data/vendor/local/share/doc/groonga/en/html/_sources/commands/select.txt +349 -109
  56. data/vendor/local/share/doc/groonga/en/html/_sources/install.txt +41 -10
  57. data/vendor/local/share/doc/groonga/en/html/_sources/news.txt +71 -0
  58. data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/data.txt +1 -1
  59. data/vendor/local/share/doc/groonga/en/html/_static/jquery.js +154 -4
  60. data/vendor/local/share/doc/groonga/en/html/_static/underscore.js +21 -29
  61. data/vendor/local/share/doc/groonga/en/html/characteristic.html +5 -5
  62. data/vendor/local/share/doc/groonga/en/html/command_version.html +5 -5
  63. data/vendor/local/share/doc/groonga/en/html/commands/cache_limit.html +5 -5
  64. data/vendor/local/share/doc/groonga/en/html/commands/check.html +5 -5
  65. data/vendor/local/share/doc/groonga/en/html/commands/clearlock.html +5 -5
  66. data/vendor/local/share/doc/groonga/en/html/commands/column_create.html +5 -5
  67. data/vendor/local/share/doc/groonga/en/html/commands/column_list.html +5 -5
  68. data/vendor/local/share/doc/groonga/en/html/commands/column_remove.html +5 -5
  69. data/vendor/local/share/doc/groonga/en/html/commands/define_selector.html +5 -5
  70. data/vendor/local/share/doc/groonga/en/html/commands/defrag.html +5 -5
  71. data/vendor/local/share/doc/groonga/en/html/commands/delete.html +5 -5
  72. data/vendor/local/share/doc/groonga/en/html/commands/dump.html +5 -5
  73. data/vendor/local/share/doc/groonga/en/html/commands/load.html +5 -5
  74. data/vendor/local/share/doc/groonga/en/html/commands/log_level.html +5 -5
  75. data/vendor/local/share/doc/groonga/en/html/commands/log_put.html +5 -5
  76. data/vendor/local/share/doc/groonga/en/html/commands/log_reopen.html +5 -5
  77. data/vendor/local/share/doc/groonga/en/html/commands/quit.html +5 -5
  78. data/vendor/local/share/doc/groonga/en/html/commands/select.html +683 -162
  79. data/vendor/local/share/doc/groonga/en/html/commands/shutdown.html +5 -5
  80. data/vendor/local/share/doc/groonga/en/html/commands/status.html +5 -5
  81. data/vendor/local/share/doc/groonga/en/html/commands/suggest.html +170 -12
  82. data/vendor/local/share/doc/groonga/en/html/commands/table_create.html +5 -5
  83. data/vendor/local/share/doc/groonga/en/html/commands/table_list.html +5 -5
  84. data/vendor/local/share/doc/groonga/en/html/commands/table_remove.html +5 -5
  85. data/vendor/local/share/doc/groonga/en/html/commands/view_add.html +5 -5
  86. data/vendor/local/share/doc/groonga/en/html/commands.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/development/com.html +5 -5
  89. data/vendor/local/share/doc/groonga/en/html/contribution/development/document.html +5 -5
  90. data/vendor/local/share/doc/groonga/en/html/contribution/development/query.html +5 -5
  91. data/vendor/local/share/doc/groonga/en/html/contribution/development/test.html +5 -5
  92. data/vendor/local/share/doc/groonga/en/html/contribution/development.html +5 -5
  93. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/c-api.html +5 -5
  94. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/i18n.html +5 -5
  95. data/vendor/local/share/doc/groonga/en/html/contribution/documentation.html +5 -5
  96. data/vendor/local/share/doc/groonga/en/html/contribution/report.html +5 -5
  97. data/vendor/local/share/doc/groonga/en/html/contribution.html +5 -5
  98. data/vendor/local/share/doc/groonga/en/html/executables/grnslap.html +5 -5
  99. data/vendor/local/share/doc/groonga/en/html/executables/grntest.html +5 -5
  100. data/vendor/local/share/doc/groonga/en/html/executables/groonga-http.html +5 -5
  101. data/vendor/local/share/doc/groonga/en/html/executables/groonga-suggest-create-dataset.html +5 -5
  102. data/vendor/local/share/doc/groonga/en/html/executables/groonga.html +5 -5
  103. data/vendor/local/share/doc/groonga/en/html/executables.html +5 -5
  104. data/vendor/local/share/doc/groonga/en/html/expr.html +5 -5
  105. data/vendor/local/share/doc/groonga/en/html/functions/edit_distance.html +5 -5
  106. data/vendor/local/share/doc/groonga/en/html/functions/geo_distance.html +5 -5
  107. data/vendor/local/share/doc/groonga/en/html/functions/geo_in_circle.html +5 -5
  108. data/vendor/local/share/doc/groonga/en/html/functions/geo_in_rectangle.html +5 -5
  109. data/vendor/local/share/doc/groonga/en/html/functions/now.html +5 -5
  110. data/vendor/local/share/doc/groonga/en/html/functions/rand.html +5 -5
  111. data/vendor/local/share/doc/groonga/en/html/functions.html +5 -5
  112. data/vendor/local/share/doc/groonga/en/html/genindex.html +5 -5
  113. data/vendor/local/share/doc/groonga/en/html/geolocation_search.html +5 -5
  114. data/vendor/local/share/doc/groonga/en/html/index.html +23 -16
  115. data/vendor/local/share/doc/groonga/en/html/indexing.html +95 -14
  116. data/vendor/local/share/doc/groonga/en/html/install.html +67 -37
  117. data/vendor/local/share/doc/groonga/en/html/limitations.html +9 -9
  118. data/vendor/local/share/doc/groonga/en/html/log.html +5 -5
  119. data/vendor/local/share/doc/groonga/en/html/news/0.x.html +5 -5
  120. data/vendor/local/share/doc/groonga/en/html/news/1.0.x.html +5 -5
  121. data/vendor/local/share/doc/groonga/en/html/news/1.1.x.html +5 -5
  122. data/vendor/local/share/doc/groonga/en/html/news/1.2.x.html +5 -5
  123. data/vendor/local/share/doc/groonga/en/html/news/senna.html +5 -5
  124. data/vendor/local/share/doc/groonga/en/html/news.html +161 -25
  125. data/vendor/local/share/doc/groonga/en/html/objects.inv +0 -0
  126. data/vendor/local/share/doc/groonga/en/html/output.html +5 -5
  127. data/vendor/local/share/doc/groonga/en/html/pseudo_column.html +5 -5
  128. data/vendor/local/share/doc/groonga/en/html/reference.html +5 -5
  129. data/vendor/local/share/doc/groonga/en/html/search.html +5 -5
  130. data/vendor/local/share/doc/groonga/en/html/searchindex.js +1 -1
  131. data/vendor/local/share/doc/groonga/en/html/spec/search.html +22 -22
  132. data/vendor/local/share/doc/groonga/en/html/spec.html +13 -11
  133. data/vendor/local/share/doc/groonga/en/html/suggest/completion.html +33 -6
  134. data/vendor/local/share/doc/groonga/en/html/suggest/correction.html +33 -6
  135. data/vendor/local/share/doc/groonga/en/html/suggest/introduction.html +5 -5
  136. data/vendor/local/share/doc/groonga/en/html/suggest/suggestion.html +37 -6
  137. data/vendor/local/share/doc/groonga/en/html/suggest/tutorial.html +5 -5
  138. data/vendor/local/share/doc/groonga/en/html/suggest.html +5 -5
  139. data/vendor/local/share/doc/groonga/en/html/troubleshooting/different_results_with_the_same_keyword.html +5 -5
  140. data/vendor/local/share/doc/groonga/en/html/troubleshooting.html +5 -5
  141. data/vendor/local/share/doc/groonga/en/html/tutorial/data.html +293 -29
  142. data/vendor/local/share/doc/groonga/en/html/tutorial/drilldown.html +5 -5
  143. data/vendor/local/share/doc/groonga/en/html/tutorial/index.html +340 -27
  144. data/vendor/local/share/doc/groonga/en/html/tutorial/introduction.html +5 -5
  145. data/vendor/local/share/doc/groonga/en/html/tutorial/lexicon.html +5 -5
  146. data/vendor/local/share/doc/groonga/en/html/tutorial/match_columns.html +282 -24
  147. data/vendor/local/share/doc/groonga/en/html/tutorial/micro_blog.html +524 -15
  148. data/vendor/local/share/doc/groonga/en/html/tutorial/network.html +103 -8
  149. data/vendor/local/share/doc/groonga/en/html/tutorial/patricia_trie.html +128 -13
  150. data/vendor/local/share/doc/groonga/en/html/tutorial/query_expansion.html +155 -17
  151. data/vendor/local/share/doc/groonga/en/html/tutorial/search.html +5 -5
  152. data/vendor/local/share/doc/groonga/en/html/tutorial.html +5 -5
  153. data/vendor/local/share/doc/groonga/en/html/type.html +5 -5
  154. data/vendor/local/share/doc/groonga/ja/html/.buildinfo +1 -1
  155. data/vendor/local/share/doc/groonga/ja/html/_sources/commands/select.txt +349 -109
  156. data/vendor/local/share/doc/groonga/ja/html/_sources/install.txt +41 -10
  157. data/vendor/local/share/doc/groonga/ja/html/_sources/news.txt +71 -0
  158. data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/data.txt +1 -1
  159. data/vendor/local/share/doc/groonga/ja/html/_static/jquery.js +154 -4
  160. data/vendor/local/share/doc/groonga/ja/html/_static/underscore.js +21 -29
  161. data/vendor/local/share/doc/groonga/ja/html/characteristic.html +5 -5
  162. data/vendor/local/share/doc/groonga/ja/html/command_version.html +5 -5
  163. data/vendor/local/share/doc/groonga/ja/html/commands/cache_limit.html +5 -5
  164. data/vendor/local/share/doc/groonga/ja/html/commands/check.html +5 -5
  165. data/vendor/local/share/doc/groonga/ja/html/commands/clearlock.html +5 -5
  166. data/vendor/local/share/doc/groonga/ja/html/commands/column_create.html +5 -5
  167. data/vendor/local/share/doc/groonga/ja/html/commands/column_list.html +5 -5
  168. data/vendor/local/share/doc/groonga/ja/html/commands/column_remove.html +5 -5
  169. data/vendor/local/share/doc/groonga/ja/html/commands/define_selector.html +5 -5
  170. data/vendor/local/share/doc/groonga/ja/html/commands/defrag.html +5 -5
  171. data/vendor/local/share/doc/groonga/ja/html/commands/delete.html +5 -5
  172. data/vendor/local/share/doc/groonga/ja/html/commands/dump.html +5 -5
  173. data/vendor/local/share/doc/groonga/ja/html/commands/load.html +5 -5
  174. data/vendor/local/share/doc/groonga/ja/html/commands/log_level.html +5 -5
  175. data/vendor/local/share/doc/groonga/ja/html/commands/log_put.html +5 -5
  176. data/vendor/local/share/doc/groonga/ja/html/commands/log_reopen.html +5 -5
  177. data/vendor/local/share/doc/groonga/ja/html/commands/quit.html +5 -5
  178. data/vendor/local/share/doc/groonga/ja/html/commands/select.html +601 -162
  179. data/vendor/local/share/doc/groonga/ja/html/commands/shutdown.html +5 -5
  180. data/vendor/local/share/doc/groonga/ja/html/commands/status.html +5 -5
  181. data/vendor/local/share/doc/groonga/ja/html/commands/suggest.html +170 -12
  182. data/vendor/local/share/doc/groonga/ja/html/commands/table_create.html +5 -5
  183. data/vendor/local/share/doc/groonga/ja/html/commands/table_list.html +5 -5
  184. data/vendor/local/share/doc/groonga/ja/html/commands/table_remove.html +5 -5
  185. data/vendor/local/share/doc/groonga/ja/html/commands/view_add.html +5 -5
  186. data/vendor/local/share/doc/groonga/ja/html/commands.html +5 -5
  187. data/vendor/local/share/doc/groonga/ja/html/community.html +5 -5
  188. data/vendor/local/share/doc/groonga/ja/html/contribution/development/com.html +5 -5
  189. data/vendor/local/share/doc/groonga/ja/html/contribution/development/document.html +5 -5
  190. data/vendor/local/share/doc/groonga/ja/html/contribution/development/query.html +5 -5
  191. data/vendor/local/share/doc/groonga/ja/html/contribution/development/test.html +5 -5
  192. data/vendor/local/share/doc/groonga/ja/html/contribution/development.html +5 -5
  193. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/c-api.html +5 -5
  194. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/i18n.html +5 -5
  195. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation.html +5 -5
  196. data/vendor/local/share/doc/groonga/ja/html/contribution/report.html +5 -5
  197. data/vendor/local/share/doc/groonga/ja/html/contribution.html +5 -5
  198. data/vendor/local/share/doc/groonga/ja/html/executables/grnslap.html +5 -5
  199. data/vendor/local/share/doc/groonga/ja/html/executables/grntest.html +5 -5
  200. data/vendor/local/share/doc/groonga/ja/html/executables/groonga-http.html +5 -5
  201. data/vendor/local/share/doc/groonga/ja/html/executables/groonga-suggest-create-dataset.html +5 -5
  202. data/vendor/local/share/doc/groonga/ja/html/executables/groonga.html +5 -5
  203. data/vendor/local/share/doc/groonga/ja/html/executables.html +5 -5
  204. data/vendor/local/share/doc/groonga/ja/html/expr.html +5 -5
  205. data/vendor/local/share/doc/groonga/ja/html/functions/edit_distance.html +5 -5
  206. data/vendor/local/share/doc/groonga/ja/html/functions/geo_distance.html +5 -5
  207. data/vendor/local/share/doc/groonga/ja/html/functions/geo_in_circle.html +5 -5
  208. data/vendor/local/share/doc/groonga/ja/html/functions/geo_in_rectangle.html +5 -5
  209. data/vendor/local/share/doc/groonga/ja/html/functions/now.html +5 -5
  210. data/vendor/local/share/doc/groonga/ja/html/functions/rand.html +5 -5
  211. data/vendor/local/share/doc/groonga/ja/html/functions.html +5 -5
  212. data/vendor/local/share/doc/groonga/ja/html/genindex.html +5 -5
  213. data/vendor/local/share/doc/groonga/ja/html/geolocation_search.html +5 -5
  214. data/vendor/local/share/doc/groonga/ja/html/index.html +23 -16
  215. data/vendor/local/share/doc/groonga/ja/html/indexing.html +95 -14
  216. data/vendor/local/share/doc/groonga/ja/html/install.html +66 -37
  217. data/vendor/local/share/doc/groonga/ja/html/limitations.html +9 -9
  218. data/vendor/local/share/doc/groonga/ja/html/log.html +5 -5
  219. data/vendor/local/share/doc/groonga/ja/html/news/0.x.html +5 -5
  220. data/vendor/local/share/doc/groonga/ja/html/news/1.0.x.html +5 -5
  221. data/vendor/local/share/doc/groonga/ja/html/news/1.1.x.html +5 -5
  222. data/vendor/local/share/doc/groonga/ja/html/news/1.2.x.html +5 -5
  223. data/vendor/local/share/doc/groonga/ja/html/news/senna.html +5 -5
  224. data/vendor/local/share/doc/groonga/ja/html/news.html +147 -25
  225. data/vendor/local/share/doc/groonga/ja/html/objects.inv +0 -0
  226. data/vendor/local/share/doc/groonga/ja/html/output.html +5 -5
  227. data/vendor/local/share/doc/groonga/ja/html/pseudo_column.html +5 -5
  228. data/vendor/local/share/doc/groonga/ja/html/reference.html +5 -5
  229. data/vendor/local/share/doc/groonga/ja/html/search.html +5 -5
  230. data/vendor/local/share/doc/groonga/ja/html/searchindex.js +1 -1
  231. data/vendor/local/share/doc/groonga/ja/html/spec/search.html +22 -22
  232. data/vendor/local/share/doc/groonga/ja/html/spec.html +13 -11
  233. data/vendor/local/share/doc/groonga/ja/html/suggest/completion.html +33 -6
  234. data/vendor/local/share/doc/groonga/ja/html/suggest/correction.html +33 -6
  235. data/vendor/local/share/doc/groonga/ja/html/suggest/introduction.html +5 -5
  236. data/vendor/local/share/doc/groonga/ja/html/suggest/suggestion.html +37 -6
  237. data/vendor/local/share/doc/groonga/ja/html/suggest/tutorial.html +5 -5
  238. data/vendor/local/share/doc/groonga/ja/html/suggest.html +5 -5
  239. data/vendor/local/share/doc/groonga/ja/html/troubleshooting/different_results_with_the_same_keyword.html +5 -5
  240. data/vendor/local/share/doc/groonga/ja/html/troubleshooting.html +5 -5
  241. data/vendor/local/share/doc/groonga/ja/html/tutorial/data.html +292 -28
  242. data/vendor/local/share/doc/groonga/ja/html/tutorial/drilldown.html +5 -5
  243. data/vendor/local/share/doc/groonga/ja/html/tutorial/index.html +340 -27
  244. data/vendor/local/share/doc/groonga/ja/html/tutorial/introduction.html +5 -5
  245. data/vendor/local/share/doc/groonga/ja/html/tutorial/lexicon.html +5 -5
  246. data/vendor/local/share/doc/groonga/ja/html/tutorial/match_columns.html +282 -24
  247. data/vendor/local/share/doc/groonga/ja/html/tutorial/micro_blog.html +524 -15
  248. data/vendor/local/share/doc/groonga/ja/html/tutorial/network.html +103 -8
  249. data/vendor/local/share/doc/groonga/ja/html/tutorial/patricia_trie.html +128 -13
  250. data/vendor/local/share/doc/groonga/ja/html/tutorial/query_expansion.html +155 -17
  251. data/vendor/local/share/doc/groonga/ja/html/tutorial/search.html +5 -5
  252. data/vendor/local/share/doc/groonga/ja/html/tutorial.html +5 -5
  253. data/vendor/local/share/doc/groonga/ja/html/type.html +5 -5
  254. data/vendor/local/share/doc/groonga/source/commands/select.txt +349 -109
  255. data/vendor/local/share/doc/groonga/source/commands/suggest-completion.log +28 -1
  256. data/vendor/local/share/doc/groonga/source/commands/suggest-correction.log +28 -1
  257. data/vendor/local/share/doc/groonga/source/commands/suggest-learn-completion.log +1 -1
  258. data/vendor/local/share/doc/groonga/source/commands/suggest-learn-correction.log +1 -1
  259. data/vendor/local/share/doc/groonga/source/commands/suggest-learn-suggestion.log +1 -1
  260. data/vendor/local/share/doc/groonga/source/commands/suggest-mixed.log +74 -1
  261. data/vendor/local/share/doc/groonga/source/commands/suggest-suggestion.log +32 -1
  262. data/vendor/local/share/doc/groonga/source/conf.py +3 -3
  263. data/vendor/local/share/doc/groonga/source/example/completion-1.log +28 -1
  264. data/vendor/local/share/doc/groonga/source/example/correction-1.log +28 -1
  265. data/vendor/local/share/doc/groonga/source/example/suggestion-1.log +32 -1
  266. data/vendor/local/share/doc/groonga/source/example/tutorial/data-1.log +1 -1
  267. data/vendor/local/share/doc/groonga/source/example/tutorial/data-2.log +38 -3
  268. data/vendor/local/share/doc/groonga/source/example/tutorial/data-3.log +46 -4
  269. data/vendor/local/share/doc/groonga/source/example/tutorial/data-4.log +38 -3
  270. data/vendor/local/share/doc/groonga/source/example/tutorial/data-5.log +38 -3
  271. data/vendor/local/share/doc/groonga/source/example/tutorial/data-6.log +38 -3
  272. data/vendor/local/share/doc/groonga/source/example/tutorial/data-7.log +40 -3
  273. data/vendor/local/share/doc/groonga/source/example/tutorial/data-8.log +48 -3
  274. data/vendor/local/share/doc/groonga/source/example/tutorial/index-1.log +6 -6
  275. data/vendor/local/share/doc/groonga/source/example/tutorial/index-2.log +100 -3
  276. data/vendor/local/share/doc/groonga/source/example/tutorial/index-3.log +5 -5
  277. data/vendor/local/share/doc/groonga/source/example/tutorial/index-4.log +80 -2
  278. data/vendor/local/share/doc/groonga/source/example/tutorial/index-5.log +75 -1
  279. data/vendor/local/share/doc/groonga/source/example/tutorial/index-6.log +31 -4
  280. data/vendor/local/share/doc/groonga/source/example/tutorial/index-7.log +38 -1
  281. data/vendor/local/share/doc/groonga/source/example/tutorial/match_columns-1.log +7 -7
  282. data/vendor/local/share/doc/groonga/source/example/tutorial/match_columns-2.log +132 -3
  283. data/vendor/local/share/doc/groonga/source/example/tutorial/match_columns-3.log +6 -6
  284. data/vendor/local/share/doc/groonga/source/example/tutorial/match_columns-4.log +132 -3
  285. data/vendor/local/share/doc/groonga/source/example/tutorial/micro_blog-1.log +32 -1
  286. data/vendor/local/share/doc/groonga/source/example/tutorial/micro_blog-10.log +95 -1
  287. data/vendor/local/share/doc/groonga/source/example/tutorial/micro_blog-2.log +32 -1
  288. data/vendor/local/share/doc/groonga/source/example/tutorial/micro_blog-3.log +32 -1
  289. data/vendor/local/share/doc/groonga/source/example/tutorial/micro_blog-4.log +86 -1
  290. data/vendor/local/share/doc/groonga/source/example/tutorial/micro_blog-5.log +32 -1
  291. data/vendor/local/share/doc/groonga/source/example/tutorial/micro_blog-6.log +70 -1
  292. data/vendor/local/share/doc/groonga/source/example/tutorial/micro_blog-7.log +51 -1
  293. data/vendor/local/share/doc/groonga/source/example/tutorial/micro_blog-8.log +55 -1
  294. data/vendor/local/share/doc/groonga/source/example/tutorial/micro_blog-9.log +34 -1
  295. data/vendor/local/share/doc/groonga/source/example/tutorial/network-1.log +18 -1
  296. data/vendor/local/share/doc/groonga/source/example/tutorial/network-3.log +80 -2
  297. data/vendor/local/share/doc/groonga/source/example/tutorial/patricia_trie-1.log +34 -3
  298. data/vendor/local/share/doc/groonga/source/example/tutorial/patricia_trie-2.log +89 -5
  299. data/vendor/local/share/doc/groonga/source/example/tutorial/query_expansion-1.log +8 -8
  300. data/vendor/local/share/doc/groonga/source/example/tutorial/query_expansion-2.log +66 -2
  301. data/vendor/local/share/doc/groonga/source/example/tutorial/query_expansion-3.log +76 -2
  302. data/vendor/local/share/doc/groonga/source/install.txt +41 -10
  303. data/vendor/local/share/doc/groonga/source/news.txt +71 -0
  304. data/vendor/local/share/doc/groonga/source/tutorial/data.txt +1 -1
  305. data/vendor/local/share/groonga/examples/dictionary/edict/edict-import.sh +0 -0
  306. data/vendor/local/share/groonga/examples/dictionary/edict/edict2grn.rb +1 -1
  307. data/vendor/local/share/groonga/examples/dictionary/eijiro/eijiro-import.sh +0 -0
  308. data/vendor/local/share/groonga/examples/dictionary/eijiro/eijiro2grn.rb +1 -1
  309. data/vendor/local/share/groonga/examples/dictionary/gene95/gene-import.sh +0 -0
  310. data/vendor/local/share/groonga/examples/dictionary/gene95/gene2grn.rb +1 -1
  311. data/vendor/local/share/groonga/examples/dictionary/init-db.sh +0 -0
  312. data/vendor/local/share/groonga/examples/dictionary/jmdict/jmdict.rb +1 -1
  313. data/vendor/local/share/groonga/html/admin/css/{admin.css → groonga-admin.css} +5 -4
  314. data/vendor/local/share/groonga/html/admin/css/redmond/images/ui-bg_flat_0_aaaaaa_40x100.png +0 -0
  315. data/vendor/local/share/groonga/html/admin/css/redmond/images/ui-bg_flat_55_fbec88_40x100.png +0 -0
  316. data/vendor/local/share/groonga/html/admin/css/redmond/images/ui-bg_glass_75_d0e5f5_1x400.png +0 -0
  317. data/vendor/local/share/groonga/html/admin/css/redmond/images/ui-bg_glass_85_dfeffc_1x400.png +0 -0
  318. data/vendor/local/share/groonga/html/admin/css/redmond/images/ui-bg_glass_95_fef1ec_1x400.png +0 -0
  319. data/vendor/local/share/groonga/html/admin/css/redmond/images/ui-bg_gloss-wave_55_5c9ccc_500x100.png +0 -0
  320. data/vendor/local/share/groonga/html/admin/css/redmond/images/ui-bg_inset-hard_100_f5f8f9_1x100.png +0 -0
  321. data/vendor/local/share/groonga/html/admin/css/redmond/images/ui-bg_inset-hard_100_fcfdfd_1x100.png +0 -0
  322. data/vendor/local/share/groonga/html/admin/css/{ui-lightness/images/ui-icons_ffd27a_256x240.png → redmond/images/ui-icons_217bc0_256x240.png} +0 -0
  323. data/vendor/local/share/groonga/html/admin/css/{ui-lightness/images/ui-icons_222222_256x240.png → redmond/images/ui-icons_2e83ff_256x240.png} +0 -0
  324. data/vendor/local/share/groonga/html/admin/css/{ui-lightness/images/ui-icons_228ef1_256x240.png → redmond/images/ui-icons_469bdd_256x240.png} +0 -0
  325. data/vendor/local/share/groonga/html/admin/css/redmond/images/ui-icons_6da8d5_256x240.png +0 -0
  326. data/vendor/local/share/groonga/html/admin/css/redmond/images/ui-icons_cd0a0a_256x240.png +0 -0
  327. data/vendor/local/share/groonga/html/admin/css/{ui-lightness/images/ui-icons_ef8c08_256x240.png → redmond/images/ui-icons_d8e7f3_256x240.png} +0 -0
  328. data/vendor/local/share/groonga/html/admin/css/redmond/images/ui-icons_f9bd01_256x240.png +0 -0
  329. data/vendor/local/share/groonga/html/admin/css/{ui-lightness/jquery-ui-1.8.1.custom.css → redmond/jquery-ui-1.8.18.custom.css} +169 -90
  330. data/vendor/local/share/groonga/html/admin/images/groonga.svg +121 -0
  331. data/vendor/local/share/groonga/html/admin/index.html +44 -1145
  332. data/vendor/local/share/groonga/html/admin/js/groonga-admin.js +1354 -0
  333. data/vendor/local/share/groonga/html/admin/js/jquery-1.7.2.min.js +4 -0
  334. data/vendor/local/share/groonga/html/admin/js/jquery-ui-1.8.18.custom.min.js +356 -0
  335. data/vendor/local/share/man/ja/man1/groonga.1 +2813 -331
  336. data/vendor/local/share/man/man1/groonga.1 +2898 -337
  337. data/vendor/local/share/mecab/dic/naist-jdic/sys.dic +0 -0
  338. data/vendor/local/share/mecab/dic/naist-jdic/unk.dic +0 -0
  339. metadata +988 -921
  340. data/test/groonga-test-utils.rb +0 -139
  341. data/test/run-test.rb +0 -60
  342. data/test/test-accessor.rb +0 -36
  343. data/test/test-array.rb +0 -123
  344. data/test/test-column.rb +0 -350
  345. data/test/test-command-select.rb +0 -147
  346. data/test/test-context.rb +0 -130
  347. data/test/test-database-dumper.rb +0 -259
  348. data/test/test-database.rb +0 -148
  349. data/test/test-double-array-trie.rb +0 -164
  350. data/test/test-encoding.rb +0 -33
  351. data/test/test-exception.rb +0 -96
  352. data/test/test-expression-builder.rb +0 -269
  353. data/test/test-expression.rb +0 -134
  354. data/test/test-fix-size-column.rb +0 -77
  355. data/test/test-gqtp.rb +0 -70
  356. data/test/test-hash.rb +0 -344
  357. data/test/test-index-column.rb +0 -180
  358. data/test/test-index-cursor.rb +0 -93
  359. data/test/test-logger.rb +0 -37
  360. data/test/test-pagination.rb +0 -249
  361. data/test/test-patricia-trie.rb +0 -415
  362. data/test/test-plugin.rb +0 -35
  363. data/test/test-procedure.rb +0 -37
  364. data/test/test-query-log.rb +0 -258
  365. data/test/test-record.rb +0 -569
  366. data/test/test-remote.rb +0 -63
  367. data/test/test-schema-create-table.rb +0 -267
  368. data/test/test-schema-dumper.rb +0 -235
  369. data/test/test-schema-type.rb +0 -208
  370. data/test/test-schema-view.rb +0 -90
  371. data/test/test-schema.rb +0 -886
  372. data/test/test-snippet.rb +0 -130
  373. data/test/test-table-cursor.rb +0 -187
  374. data/test/test-table-dumper.rb +0 -83
  375. data/test/test-table-offset-and-limit.rb +0 -100
  376. data/test/test-table-select-mecab.rb +0 -80
  377. data/test/test-table-select-normalize.rb +0 -57
  378. data/test/test-table-select-weight.rb +0 -123
  379. data/test/test-table-select.rb +0 -191
  380. data/test/test-table.rb +0 -675
  381. data/test/test-type.rb +0 -79
  382. data/test/test-variable-size-column.rb +0 -147
  383. data/test/test-variable.rb +0 -28
  384. data/test/test-vector-column.rb +0 -76
  385. data/test/test-version.rb +0 -61
  386. data/test/test-view.rb +0 -72
  387. data/vendor/local/share/groonga/html/admin/css/ui-lightness/images/ui-bg_diagonals-thick_18_b81900_40x40.png +0 -0
  388. data/vendor/local/share/groonga/html/admin/css/ui-lightness/images/ui-bg_diagonals-thick_20_666666_40x40.png +0 -0
  389. data/vendor/local/share/groonga/html/admin/css/ui-lightness/images/ui-bg_flat_10_000000_40x100.png +0 -0
  390. data/vendor/local/share/groonga/html/admin/css/ui-lightness/images/ui-bg_glass_100_f6f6f6_1x400.png +0 -0
  391. data/vendor/local/share/groonga/html/admin/css/ui-lightness/images/ui-bg_glass_100_fdf5ce_1x400.png +0 -0
  392. data/vendor/local/share/groonga/html/admin/css/ui-lightness/images/ui-bg_glass_65_ffffff_1x400.png +0 -0
  393. data/vendor/local/share/groonga/html/admin/css/ui-lightness/images/ui-bg_gloss-wave_35_f6a828_500x100.png +0 -0
  394. data/vendor/local/share/groonga/html/admin/css/ui-lightness/images/ui-bg_highlight-soft_100_eeeeee_1x100.png +0 -0
  395. data/vendor/local/share/groonga/html/admin/css/ui-lightness/images/ui-bg_highlight-soft_75_ffe45c_1x100.png +0 -0
  396. data/vendor/local/share/groonga/html/admin/css/ui-lightness/images/ui-icons_ffffff_256x240.png +0 -0
  397. data/vendor/local/share/groonga/html/admin/js/jquery-1.4.2.min.js +0 -154
  398. data/vendor/local/share/groonga/html/admin/js/jquery-ui-1.8.1.custom.min.js +0 -756
@@ -2,190 +2,438 @@
2
2
 
3
3
  .. highlightlang:: none
4
4
 
5
+ .. groonga-command
6
+ .. database: commands_select
7
+
5
8
  select
6
9
  ======
7
10
 
8
- 名前
9
- ----
11
+ Summary
12
+ -------
13
+
14
+ ``select`` searches records that are matched to specified conditions
15
+ from a table and then outputs them.
16
+
17
+ ``select`` is the most important command in groonga. You need to
18
+ understand ``select`` to use the full power of groonga.
19
+
20
+ Syntax
21
+ ------
22
+
23
+ ``select`` has many parameters. The required parameter is only
24
+ ``table`` and others are optional::
25
+
26
+ select table
27
+ [match_columns=null]
28
+ [query=null]
29
+ [filter=null]
30
+ [scorer=null]
31
+ [sortby=null]
32
+ [output_columns="_id, _key, *"]
33
+ [offset=0]
34
+ [limit=10]
35
+ [drilldown=null]
36
+ [drilldown_sortby=null]
37
+ [drilldown_output_columns=null]
38
+ [drilldown_offset=0]
39
+ [drilldown_limit=10]
40
+ [cache=yes]
41
+ [match_escalation_threshold=0]
42
+ [query_expansion=null]
43
+
44
+ Usage
45
+ -----
46
+
47
+ Let's learn about ``select`` usage with examples. This section shows
48
+ many popular usages.
49
+
50
+ Here are a schema definition and sample data to show usage.
51
+
52
+ .. groonga-command
53
+ .. include:: ../example/commands/select/usage_setup.log
54
+ .. table_create Entries TABLE_HASH_KEY ShortText
55
+ .. column_create Entries content COLUMN_SCALAR Text
56
+ .. table_create Terms TABLE_PAT_KEY|KEY_NORMALIZE ShortText --default_tokenizer TokenBigram
57
+ .. column_create Terms entries_key_index COLUMN_INDEX|WITH_POSITION Entries _key
58
+ .. column_create Terms entries_content_index COLUMN_INDEX|WITH_POSITION Entries content
59
+ .. load --table Entries
60
+ .. [
61
+ .. {"_key": "The first post!", "content": "Welcome! This is my first post!"},
62
+ .. {"_key": "Groonga", "content": "I started to use groonga. It's very fast!"}
63
+ .. {"_key": "Mroonga", "content": "I also started to use mroonga. It's also very fast! Really fast!"}
64
+ .. ]
65
+
66
+ There is a table, ``Entries``, for blog entries. An entry has title
67
+ and content. Title is key of ``Entries``. Content is value of
68
+ ``Entries.content`` column.
69
+
70
+ ``Entries._key`` column and ``Entries.content`` column are indexed
71
+ using ``TokenBigram`` tokenizer. So both ``Entries._key`` and
72
+ ``Entries.content`` are fulltext search ready.
73
+
74
+ OK. The schema and data for examples are ready.
75
+
76
+ Simple usage
77
+ ^^^^^^^^^^^^
78
+
79
+ Here is the most simple usage with the above shema and data. It outputs
80
+ all records in ``Entries`` table.
81
+
82
+ .. groonga-command
83
+ .. include:: ../example/commands/select/simple_usage.log
84
+ .. select Entries
85
+
86
+ Why does the command output all records? There are two reasons. The
87
+ first reason is that the command doesn't specify any search
88
+ conditions. No search condition means all records are matched. The
89
+ second reason is that the number of all records is 3. ``select``
90
+ command outputs 10 records at a maximum by default. There are only 3
91
+ records. It is less than 10. So the command outputs all records.
92
+
93
+ Search conditions
94
+ ^^^^^^^^^^^^^^^^^
95
+
96
+ Search conditions are specified by ``query`` or ``filter``. You can
97
+ also specify both ``query`` and ``filter``. It means that selected
98
+ records must be matched against both ``query`` and ``filter``.
99
+
100
+ Search condition: ``query``
101
+ """""""""""""""""""""""""""
102
+
103
+ ``query`` is designed for search box in Web page. Imagine a search box
104
+ in google.com. You specify search conditions for ``query`` as space
105
+ separated keywords. For example, ``search engine`` means a matched
106
+ record should contain two words, ``search`` and ``engine``.
107
+
108
+ Normally, ``query`` parameter is used for specifying fulltext search
109
+ conditions. It can be used for non fulltext search conditions but
110
+ ``filter`` is used for the propose.
111
+
112
+ ``query`` parameter is used with ``match_columns`` parameter when
113
+ ``query`` parameter is used for specifying fulltext search
114
+ conditions. ``match_columns`` specifies which columnes and indexes are
115
+ matched against ``query``.
116
+
117
+ Here is a simple ``query`` usage example.
118
+
119
+ .. groonga-command
120
+ .. include:: ../example/commands/select/simple_query.log
121
+ .. select Entries --match_columns content --query fast
122
+
123
+ The ``select`` command searches records that contain a word ``fast``
124
+ in ``content`` column value from ``Entries`` table.
125
+
126
+ ``query`` has query syntax but its deatils aren't described here. See
127
+ :doc:`/spec/query_syntax` for datails.
128
+
129
+ Search condition: ``filter``
130
+ """"""""""""""""""""""""""""
131
+
132
+ ``filter`` is designed for complex search conditions. You specify
133
+ search conditions for ``filter`` as ECMAScript like syntax.
134
+
135
+ Here is a simple ``filter`` usage example.
136
+
137
+ .. groonga-command
138
+ .. include:: ../example/commands/select/simple_filter.log
139
+ .. select Entries --filter 'content @ "fast" && _key == "Groonga"'
10
140
 
11
- select - テーブルの中から条件にマッチするレコードを検索して出力する
141
+ The ``select`` command searches records that contain a word ``fast``
142
+ in ``content`` column value and has ``Groonga`` as ``_key`` from
143
+ ``Entries`` table. There are three operators in the command, ``@``,
144
+ ``&&`` and ``==``. ``@`` is fulltext search operator. ``&&`` and
145
+ ``==`` are the same as ECMAScript. ``&&`` is logical AND operator and
146
+ ``==`` is equality operator.
12
147
 
13
- 書式
14
- ----
15
- ::
148
+ ``filter`` has more operators and syntax like grouping by ``(...)``
149
+ its deatils aren't described here. See :doc:`/spec/script_syntax` for
150
+ datails.
16
151
 
17
- select table [match_columns [query [filter [scorer [sortby [output_columns
18
- [offset [limit [drilldown [drilldown_sortby [drilldown_output_columns
19
- [drilldown_offset [drilldown_limit [cache
20
- [match_escalation_threshold [query_expansion]]]]]]]]]]]]]]]]
152
+ Paging
153
+ ^^^^^^
21
154
 
22
- 説明
23
- ----
155
+ You can specify range of outputted records by ``offset`` and ``limit``.
156
+ Here is an example to output only the 2nd record.
24
157
 
25
- groonga組込コマンドの一つであるselectについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
158
+ .. groonga-command
159
+ .. include:: ../example/commands/select/paging.log
160
+ .. select Entries --offset 1 --limit 1
26
161
 
27
- selectは、使用しているデータベースのテーブルの中から条件にマッチするレコードを検索して出力します。
162
+ ``offset`` is zero-origin. ``--offset 1`` means output range is
163
+ started from the 2nd record.
28
164
 
29
- 引数
30
- ----
165
+ ``limit`` specifies the max number of output records. ``--limit 1``
166
+ means the number of output records is 1 at a maximium. If no records
167
+ are matched, ``select`` command outputs no records.
31
168
 
32
- ``table``
169
+ The total number of records
170
+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^
33
171
 
34
- 検索対象のテーブルを指定します。存在しないテーブルを指定した場合はエラーになります。
172
+ You can use ``--limit 0`` to retrieve the total number of recrods
173
+ without any contents of records.
35
174
 
36
- ``match_columns``
175
+ .. groonga-command
176
+ .. include:: ../example/commands/select/no_limit.log
177
+ .. select Entries --limit 0
37
178
 
38
- query引数に指定する検索条件文字列でデフォルトの検索対象となるカラムを指定します。
179
+ ``--limit 0`` is also useful for retrieving only the number of matched
180
+ records.
39
181
 
40
- カラム名
182
+ Parameters
183
+ ----------
41
184
 
42
- カラム名の後ろに'* 数値'を指定することによって、そのカラムにヒットした際のスコアに積算される重みを指定することができます。
185
+ This section describes all parameters. Parameters are categorized.
43
186
 
44
- カラム名 * 重み
187
+ Required parameter
188
+ ^^^^^^^^^^^^^^^^^^
45
189
 
46
- 複数のカラムを'||'で結合して指定することもできます。
190
+ There is a required parameter, ``table``.
47
191
 
48
- カラム名1 * 重み1 || カラム名2 * 重み2
192
+ ``table``
193
+ """""""""
49
194
 
50
- また、カラム名ではなく、検索に使用するインデックス名を指定することもできます。
195
+ It specifies a table to be searched. ``table`` must be specified.
51
196
 
52
- ``query``
197
+ If nonexistent table is specified, an error is returned.
53
198
 
54
- 以下の形式の文字列によって検索条件を指定します。
199
+ .. groonga-command
200
+ .. include:: ../example/commands/select/table_nonexistent.log
201
+ .. select Nonexistent
55
202
 
56
- 条件式
57
- ^^^^^^
203
+ Search related parameters
204
+ ^^^^^^^^^^^^^^^^^^^^^^^^^
58
205
 
59
- 以下の条件式が使用できます。
206
+ There are search related parameters. Typically, ``match_columns`` and
207
+ ``query`` parameters are used for implementing a search
208
+ box. ``filter`` parameters is used for implementing complex search
209
+ feature.
60
210
 
61
- 文字列
62
- 全文検索条件(デフォルト検索対象カラムの値が指定された文字列を含んでいる)
211
+ If both ``query`` and ``filter`` are specified, selected records must
212
+ be matched against both ``query`` and ``filter``. If both ``query``
213
+ and ``filter`` aren't specified, all records are selected.
63
214
 
64
- \"文字列\"
65
- フレーズ検索条件(デフォルト検索対象カラムの値が指定されたフレーズを含んでいる)
215
+ ``match_columns``
216
+ """""""""""""""""
217
+
218
+ It specifies the default target column for fulltext search by
219
+ ``query`` parameter value. A target column for fulltext search can be
220
+ specified in ``query`` parameter. The difference between
221
+ ``match_columns`` and ``query`` is whether weight is supported or
222
+ not. ``match_columns`` supports weight but ``query`` doesn't.
223
+
224
+ Weight is relative importance of target column. A higher weight target
225
+ column gets more hit score rather than a lower weight target column
226
+ when a record is matched by fulltext search. The default weight is 1.
227
+
228
+ Here is a simple ``match_columns`` usage example.
229
+
230
+ .. groonga-command
231
+ .. include:: ../example/commands/select/match_columns_simple.log
232
+ .. select Entries --match_columns content --query fast --output_columns '_key, _score'
233
+
234
+ ``--match_columns content`` means the default target column for
235
+ fulltext search is ``content`` column and its weight
236
+ is 1. ``--output_columns '_key, _score'`` means that the ``select``
237
+ command outputs ``_key`` value and ``_score`` value for matched
238
+ records.
239
+
240
+ Pay attention to ``_score`` value. ``_score`` value is the number of
241
+ matched counts against ``query`` parameter value. In the example,
242
+ ``query`` parameter value is ``fast``. The fact that ``_score`` value
243
+ is 1 means that ``fast`` appers in ``content`` column only once. The
244
+ fact that ``_score`` value is 2 means that ``fast`` appears in
245
+ ``content`` column twice.
246
+
247
+ To specify weight, ``column * weight`` syntax is used. Here is a
248
+ weight usage example.
249
+
250
+ .. groonga-command
251
+ .. include:: ../example/commands/select/match_columns_weight.log
252
+ .. select Entries --match_columns 'content * 2' --query fast --output_columns '_key, _score'
253
+
254
+ ``--match_columns 'content * 2'`` means the default target column for
255
+ fulltext search is ``content`` column and its weight is 2.
256
+
257
+ Pay attention to ``_score`` value. ``_score`` value is doubled because
258
+ weight is 2.
259
+
260
+ You can specify one or more columns as the default target columns for
261
+ fulltext search. If one or more columns are specified, fulltext search
262
+ is done for all columns and scores are accumulated. If one of the
263
+ columns is matched against ``query`` parameter value, the record is
264
+ treated as matched.
265
+
266
+ To specify one or more columns, ``column1 * weight1 || column2 *
267
+ weight2 || ...`` syntax is used. ``* weight`` can be omitted. If it is
268
+ omitted, 1 is used for weight. Here is a one or more columns usage
269
+ example.
270
+
271
+ .. groonga-command
272
+ .. include:: ../example/commands/select/match_columns_some_columns.log
273
+ .. select Entries --match_columns '_key * 10 || content' --query groonga --output_columns '_key, _score'
274
+
275
+ ``--match_columns '_key * 10 || content'`` means the default target
276
+ columns for fulltext search are ``_key`` and ``content`` columns and
277
+ ``_key`` column's weight is 10 and ``content`` column's weight
278
+ is 1. This weight allocation means ``_key`` column value is more
279
+ important rather than ``content`` column value. In this example, title
280
+ of blog entry is more important rather thatn content of blog entry.
66
281
 
67
- カラム名:値
68
- 一致条件(カラム値 == 値)
282
+ ``query``
283
+ """""""""
69
284
 
70
- カラム名:!値
71
- 不一致条件(カラム値 != 値)
285
+ TODO: write short description and add example.
72
286
 
73
- カラム名:<値
74
- 比較条件(カラム値 < 値)
287
+ See :doc:`/spec/query_syntax`.
75
288
 
76
- カラム名:>値
77
- 比較条件(カラム値 > 値)
289
+ ``filter``
290
+ """"""""""
78
291
 
79
- カラム名:<=値
80
- 比較条件(カラム値 <= 値)
292
+ TODO: write short description and add example.
81
293
 
82
- カラム名:>=値
83
- 比較条件(カラム値 >= 値)
294
+ See :doc:`/spec/script_syntax`.
84
295
 
85
- カラム名:@文字列
86
- 全文検索条件(カラム値が指定された文字列を含んでいる)
296
+ Advanced search parameters
297
+ ^^^^^^^^^^^^^^^^^^^^^^^^^^
87
298
 
88
- 結合演算子
89
- ^^^^^^^^^^
299
+ ``match_escalation_threshold``
300
+ """"""""""""""""""""""""""""""
90
301
 
91
- 複数の条件式を結合するために以下の演算子が使用できます。
302
+ TODO: add example.
92
303
 
93
- a OR b
94
- 論理和(aとbといずれかの条件がマッチする)
304
+ It specifies threshold to determine whether search storategy
305
+ escalation is used or not. The threshold is compared against the
306
+ number of matched records. If the number of matched records is equal
307
+ to or less than the threshold, search storategy escalation is
308
+ used. See :doc:`/spec/search` about search storategy escalation.
95
309
 
96
- a + b
97
- 論理積(aとbの両方がマッチする)
310
+ The default threshold is 0. It means that search storategy escalation
311
+ is used only when no records are matched.
98
312
 
99
- a - b
100
- aにマッチし、bにはマッチしない
313
+ The default threshold can be customized by one of the followings.
101
314
 
102
- ( )
103
- 複数の条件をまとめる
315
+ * ``--with-match-escalation-threshold`` option of configure
316
+ * ``--match-escalation-threshold`` option of groogna command
317
+ * ``match-escalation-threshold`` configuration item in configuration
318
+ file
104
319
 
320
+ ``query_expansion``
321
+ """""""""""""""""""
105
322
 
106
- ``filter``
323
+ TODO: write in English and add example.
107
324
 
108
- 絞り込み条件をscript形式のgrn_expr文字列によって指定します。
325
+ It specifies a column that is used to expand (substitute) ``query``
326
+ parameter value.
109
327
 
110
- query引数とfilter引数をどちらも指定した場合は、両方の条件を満足するレコードのみがヒットします。どちらも指定しない場合は全件がヒットします。
328
+ query_expansionパラメータには、queryパラメータに指定された文字列を置換(拡張)する条件となるテーブル・カラムを指定します。フォーマットは「${テーブル名}.${カラム名}」となります。指定するテーブルは文字列を主キーとするハッシュ型あるいはパトリシア木型のテーブルで、一つ以上の文字列型のカラムが定義されている必要があります。(ここでは置換テーブルと呼びます。)
111
329
 
112
- ``scorer``
330
+ queryパラメータに指定された文字列が、指定されたテーブルの主キーと完全一致する場合、その文字列を指定されたカラム値の文字列に置換します。queryパラメータが、空白、括弧、演算子などを含む場合は、その演算子によって区切られた文字列の単位で置換が実行されます。ダブルクォート("")で括られた範囲は、その内部に空白を含んでいても一つの置換される単位と見なされます。検索文字列と置換テーブルの主キー値との比較に際して大文字小文字等を区別したくない場合には、置換テーブルを定義する際にKEY_NORMALIZEを指定します。置換後の文字列となるカラムの値には、括弧や*, ORなど、queryパラメータで利用可能な全ての演算子を指定することができます。
113
331
 
114
- 検索条件にマッチする全てのレコードに対して適用するgrn_exprをscript形式で指定します。
332
+ Output related parameters
333
+ ^^^^^^^^^^^^^^^^^^^^^^^^^
115
334
 
116
- scorerは、検索処理が完了し、ソート処理が実行される前に呼び出されます。従って、各レコードのスコアを操作する式を指定しておけば、検索結果のソート順序をカスタマイズできるようになります。
335
+ ``output_columns``
336
+ """"""""""""""""""
117
337
 
118
- ``sortby``
338
+ TODO: write in English and add example.
339
+
340
+ 出力するカラム名のリストをカンマ(',')区切りで指定します。
119
341
 
120
- ソートキーとなるカラム名のリストをカンマ(',')区切りで指定します。::
342
+ アスタリスク('*')を指定すると、全てのカラムが指定されたものとみなされます。または、script形式のgrn_expr文字列を指定します。 (デフォルトは、'_id, _key, \*')
121
343
 
122
- [-]カラム名1, [-]カラム名2, [-]カラム名3, ...
344
+ ``sortby``
345
+ """"""""""
123
346
 
124
- カラム名1の値でソートし、値が同一である場合はカラム名2でソート、と順次比較を行いソートします。カラム名の前に - を付加した場合は降順にソートします。付加しない場合には昇順にソートします。
347
+ TODO: write in English and add example.
125
348
 
126
- query引数またはfilter引数を指定した場合はカラム名に'_score'を使えます。'_score'を指定することでスコアでソートすることができます。query引数もfilter引数も指定していない状態で'_score'を指定するとエラーになります。
349
+ ソートキーとなるカラム名のリストをカンマ(',')区切りで指定します。::
127
350
 
128
- ``output_columns``
351
+ [-]カラム名1, [-]カラム名2, [-]カラム名3, ...
129
352
 
130
- 出力するカラム名のリストをカンマ(',')区切りで指定します。
353
+ カラム名1の値でソートし、値が同一である場合はカラム名2でソート、と順次比較を行いソートします。カラム名の前に - を付加した場合は降順にソートします。付加しない場合には昇順にソートします。
131
354
 
132
- アスタリスク('*')を指定すると、全てのカラムが指定されたものとみなされます。または、script形式のgrn_expr文字列を指定します。 (デフォルトは、'_id, _key, \*')
355
+ query引数またはfilter引数を指定した場合はカラム名に'_score'を使えます。'_score'を指定することでスコアでソートすることができます。query引数もfilter引数も指定していない状態で'_score'を指定するとエラーになります。
133
356
 
134
357
  ``offset``
358
+ """"""""""
359
+
360
+ TODO: write in English and add example.
135
361
 
136
- 検索条件にマッチしたレコードのうち、出力対象となる最初のレコードの番号を0ベースで指定します。デフォルト値は0です。offsetに負の値を指定した場合は、ヒットした件数 + offset によって算出される値が指定されたものとみなされます。
362
+ 検索条件にマッチしたレコードのうち、出力対象となる最初のレコードの番号を0ベースで指定します。デフォルト値は0です。offsetに負の値を指定した場合は、ヒットした件数 + offset によって算出される値が指定されたものとみなされます。
137
363
 
138
364
  ``limit``
365
+ """""""""
139
366
 
140
- 検索条件にマッチしたレコードのうち、出力を行うレコードの件数を指定します。デフォルト値は10です。実際には、offset + limit がヒットした件数を超えない範囲でレコードが出力されます。limitに負の値を指定した場合は、ヒットした件数 + limit + 1 によって算出される値が指定されたものとみなされます。
367
+ TODO: write in English and add example.
368
+
369
+ 検索条件にマッチしたレコードのうち、出力を行うレコードの件数を指定します。デフォルト値は10です。実際には、offset + limit がヒットした件数を超えない範囲でレコードが出力されます。limitに負の値を指定した場合は、ヒットした件数 + limit + 1 によって算出される値が指定されたものとみなされます。
370
+
371
+ ``scorer``
372
+ """"""""""
373
+
374
+ TODO: write in English and add example.
375
+
376
+ 検索条件にマッチする全てのレコードに対して適用するgrn_exprをscript形式で指定します。
377
+
378
+ scorerは、検索処理が完了し、ソート処理が実行される前に呼び出されます。従って、各レコードのスコアを操作する式を指定しておけば、検索結果のソート順序をカスタマイズできるようになります。
379
+
380
+ Facet related parameters
381
+ ^^^^^^^^^^^^^^^^^^^^^^^^
141
382
 
142
383
  ``drilldown``
384
+ """""""""""""
143
385
 
144
- グループ化のキーとなるカラム名のリストをカンマ(',')区切りで指定します。検索条件にマッチした各レコードを出力したのちに、drilldownに指定されたカラムの値が同一であるレコードをとりまとめて、それぞれについて結果レコードを出力します。
386
+ TODO: write in English and add example.
145
387
 
146
- ``drilldown_sortby``
388
+ グループ化のキーとなるカラム名のリストをカンマ(',')区切りで指定します。検索条件にマッチした各レコードを出力したのちに、drilldownに指定されたカラムの値が同一であるレコードをとりまとめて、それぞれについて結果レコードを出力します。
147
389
 
148
- drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、ソートキーとなるカラム名のリストをカンマ(',')区切りで指定します。sortbyパラメータと同様に昇降順を指定できます。
390
+ ``drilldown_sortby``
391
+ """"""""""""""""""""
149
392
 
150
- ``drilldown_output_columns``
393
+ TODO: write in English and add example.
151
394
 
152
- drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力するカラム名のリストをカンマ(',')区切りで指定します。
395
+ drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、ソートキーとなるカラム名のリストをカンマ(',')区切りで指定します。sortbyパラメータと同様に昇降順を指定できます。
153
396
 
154
- ``drilldown_offset``
397
+ ``drilldown_output_columns``
398
+ """"""""""""""""""""""""""""
155
399
 
156
- drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力対象となる最初のレコードの番号を0ベースで指定します。デフォルト値は0です。drilldown_offsetに負の値を指定した場合は、ヒットした件数 + drilldown_offsetによって算出される値が指定されたものとみなされます。
400
+ TODO: write in English and add example.
157
401
 
158
- ``drilldown_limit``
402
+ drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力するカラム名のリストをカンマ(',')区切りで指定します。
159
403
 
160
- drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力を行うレコードの件数を指定します。デフォルト値は10です。実際には、drilldown_offset + drilldown_limit がヒットした件数を超えない範囲でレコードが出力されます。drilldown_limitに負の値を指定した場合は、ヒットした件数 + drilldown_limit + 1 によって算出される値が指定されたものとみなされます。
404
+ ``drilldown_offset``
405
+ """"""""""""""""""""
161
406
 
162
- ``cache``
407
+ TODO: write in English and add example.
163
408
 
164
- クエリキャッシュに関する動作を設定します。
409
+ drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力対象となる最初のレコードの番号を0ベースで指定します。デフォルト値は0です。drilldown_offsetに負の値を指定した場合は、ヒットした件数 + drilldown_offsetによって算出される値が指定されたものとみなされます。
165
410
 
166
- ``no``
411
+ ``drilldown_limit``
412
+ """""""""""""""""""
167
413
 
168
- 検索結果をクエリキャッシュに残しません。キャッシュして再利用される可能性が低いクエリに対して用います。キャッシュ容量は有限です。有効なキャッシュが多くヒットするために、このパラメータは有効です。
414
+ TODO: write in English and add example.
169
415
 
170
- ``match_escalation_threshold``
416
+ drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力を行うレコードの件数を指定します。デフォルト値は10です。実際には、drilldown_offset + drilldown_limit がヒットした件数を超えない範囲でレコードが出力されます。drilldown_limitに負の値を指定した場合は、ヒットした件数 + drilldown_limit + 1 によって算出される値が指定されたものとみなされます。
171
417
 
172
- 検索の挙動をエスカレーションするかどうかの閾値を設定します。デフォルト値は0です。デフォルト値は以下のいずれかの方法で設定できます。
418
+ Cache related parameter
419
+ ^^^^^^^^^^^^^^^^^^^^^^^
173
420
 
174
- * configureの--with-match-escalation-thresholdオプション
175
- * groongaコマンド起動時の--match-escalation-thresholdオプション
176
- * 設定ファイル中のmatch-escalation-threshold設定項目
421
+ ``cache``
422
+ """""""""
177
423
 
178
- クエリのヒット件数が閾値を越えない場合は :doc:`/spec/search` で説明している方法で検索方法をエスカレーションしてきます。
424
+ TODO: write in English and add example.
179
425
 
180
- ``query_expansion``
426
+ クエリキャッシュに関する動作を設定します。
181
427
 
182
- query_expansionパラメータには、queryパラメータに指定された文字列を置換(拡張)する条件となるテーブル・カラムを指定します。フォーマットは「${テーブル名}.${カラム名}」となります。指定するテーブルは文字列を主キーとするハッシュ型あるいはパトリシア木型のテーブルで、一つ以上の文字列型のカラムが定義されている必要があります。(ここでは置換テーブルと呼びます。)
428
+ ``no``
183
429
 
184
- queryパラメータに指定された文字列が、指定されたテーブルの主キーと完全一致する場合、その文字列を指定されたカラム値の文字列に置換します。queryパラメータが、空白、括弧、演算子などを含む場合は、その演算子によって区切られた文字列の単位で置換が実行されます。ダブルクォート("")で括られた範囲は、その内部に空白を含んでいても一つの置換される単位と見なされます。検索文字列と置換テーブルの主キー値との比較に際して大文字小文字等を区別したくない場合には、置換テーブルを定義する際にKEY_NORMALIZEを指定します。置換後の文字列となるカラムの値には、括弧や*, ORなど、queryパラメータで利用可能な全ての演算子を指定することができます。
430
+ 検索結果をクエリキャッシュに残しません。キャッシュして再利用される可能性が低いクエリに対して用います。キャッシュ容量は有限です。有効なキャッシュが多くヒットするために、このパラメータは有効です。
185
431
 
186
432
  返値
187
433
  ----
188
434
 
435
+ TODO: write in English and add example.
436
+
189
437
  以下のようなjson形式で値が返却されます。
190
438
 
191
439
  ::
@@ -249,16 +497,8 @@ a - b
249
497
 
250
498
  drilldown_output_columns, drilldown_offset, drilldown_limitによって指定された条件に従って各レコードの値が出力されます。
251
499
 
252
-
253
- --
254
-
255
- テーブルEntryの全レコード・全カラムの値を出力します。::
256
-
257
- select Entry
258
-
259
- [[[2],[["_id", "UInt32"],["_key","ShortText"],["body","ShortText"]],[1,"abandon","放棄する"],[2,"abbreviate","短縮する"]]]
260
-
261
- 関連項目
500
+ See also
262
501
  --------
263
502
 
264
- :doc:`../expr`
503
+ * :doc:`/spec/query_syntax`
504
+ * :doc:`/spec/script_syntax`