rroonga 4.0.0-x86-mingw32 → 4.0.1-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (449) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +6 -0
  3. data/doc/text/news.textile +26 -0
  4. data/ext/groonga/rb-grn-column.c +42 -2
  5. data/ext/groonga/rb-grn-index-column.c +57 -159
  6. data/ext/groonga/rb-grn-object.c +7 -0
  7. data/ext/groonga/rb-grn-table.c +19 -3
  8. data/ext/groonga/rb-grn-utils.c +4 -1
  9. data/ext/groonga/rb-grn-variable-size-column.c +405 -5
  10. data/ext/groonga/rb-grn.h +18 -1
  11. data/lib/1.9/groonga.so +0 -0
  12. data/lib/2.0/groonga.so +0 -0
  13. data/lib/2.1/groonga.so +0 -0
  14. data/lib/groonga/dumper.rb +46 -22
  15. data/lib/groonga/expression-builder.rb +2 -4
  16. data/lib/groonga/schema.rb +16 -234
  17. data/rroonga-build.rb +3 -3
  18. data/rroonga.gemspec +1 -1
  19. data/test/test-array.rb +6 -5
  20. data/test/test-column.rb +0 -14
  21. data/test/test-database.rb +6 -5
  22. data/test/test-double-array-trie.rb +6 -5
  23. data/test/test-expression.rb +2 -2
  24. data/test/test-hash.rb +6 -5
  25. data/test/test-index-column.rb +163 -33
  26. data/test/test-patricia-trie.rb +6 -5
  27. data/test/test-schema-dumper.rb +39 -7
  28. data/test/test-table-dumper.rb +46 -1
  29. data/test/test-table-select-weight.rb +12 -0
  30. data/test/test-variable-size-column.rb +87 -3
  31. data/vendor/local/bin/groonga-benchmark.exe +0 -0
  32. data/vendor/local/bin/groonga.exe +0 -0
  33. data/vendor/local/bin/libgroonga-0.dll +0 -0
  34. data/vendor/local/bin/libmecab-1.dll +0 -0
  35. data/vendor/local/bin/libmsgpack-3.dll +0 -0
  36. data/vendor/local/bin/libmsgpackc-2.dll +0 -0
  37. data/vendor/local/bin/mecab.exe +0 -0
  38. data/vendor/local/include/groonga/groonga.h +6 -1
  39. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.a +0 -0
  40. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll +0 -0
  41. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll.a +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/table/table.a +0 -0
  46. data/vendor/local/lib/groonga/plugins/table/table.dll +0 -0
  47. data/vendor/local/lib/groonga/plugins/table/table.dll.a +0 -0
  48. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.a +0 -0
  49. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll +0 -0
  50. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll.a +0 -0
  51. data/vendor/local/lib/libgroonga.a +0 -0
  52. data/vendor/local/lib/libgroonga.dll.a +0 -0
  53. data/vendor/local/lib/libmecab.a +0 -0
  54. data/vendor/local/lib/libmecab.dll.a +0 -0
  55. data/vendor/local/lib/libmsgpack.a +0 -0
  56. data/vendor/local/lib/libmsgpack.dll.a +0 -0
  57. data/vendor/local/lib/libmsgpackc.a +0 -0
  58. data/vendor/local/lib/libmsgpackc.dll.a +0 -0
  59. data/vendor/local/lib/pkgconfig/groonga.pc +2 -2
  60. data/vendor/local/libexec/mecab/mecab-cost-train.exe +0 -0
  61. data/vendor/local/libexec/mecab/mecab-dict-gen.exe +0 -0
  62. data/vendor/local/libexec/mecab/mecab-dict-index.exe +0 -0
  63. data/vendor/local/libexec/mecab/mecab-system-eval.exe +0 -0
  64. data/vendor/local/libexec/mecab/mecab-test-gen.exe +0 -0
  65. data/vendor/local/share/doc/groonga/en/html/.buildinfo +1 -1
  66. data/vendor/local/share/doc/groonga/en/html/_sources/install/centos.txt +3 -3
  67. data/vendor/local/share/doc/groonga/en/html/_sources/install/debian.txt +3 -3
  68. data/vendor/local/share/doc/groonga/en/html/_sources/install/fedora.txt +3 -3
  69. data/vendor/local/share/doc/groonga/en/html/_sources/install/mac_os_x.txt +3 -3
  70. data/vendor/local/share/doc/groonga/en/html/_sources/install/others.txt +3 -3
  71. data/vendor/local/share/doc/groonga/en/html/_sources/install/solaris.txt +3 -3
  72. data/vendor/local/share/doc/groonga/en/html/_sources/install/ubuntu.txt +3 -3
  73. data/vendor/local/share/doc/groonga/en/html/_sources/install/windows.txt +9 -9
  74. data/vendor/local/share/doc/groonga/en/html/_sources/news.txt +41 -0
  75. data/vendor/local/share/doc/groonga/en/html/_sources/reference/column.txt +25 -0
  76. data/vendor/local/share/doc/groonga/en/html/_sources/reference/columns/vector.txt +333 -0
  77. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/cache_limit.txt +1 -1
  78. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/column_create.txt +1 -2
  79. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/column_rename.txt +37 -17
  80. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/delete.txt +4 -5
  81. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/normalize.txt +1 -2
  82. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/select.txt +99 -0
  83. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_create.txt +1 -1
  84. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/truncate.txt +1 -2
  85. data/vendor/local/share/doc/groonga/en/html/_sources/reference/executables/groonga-suggest-httpd.txt +128 -4
  86. data/vendor/local/share/doc/groonga/en/html/_sources/reference/executables/groonga-suggest-learner.txt +11 -1
  87. data/vendor/local/share/doc/groonga/en/html/_sources/reference.txt +3 -2
  88. data/vendor/local/share/doc/groonga/en/html/_static/basic.css +1 -1
  89. data/vendor/local/share/doc/groonga/en/html/_static/doctools.js +1 -1
  90. data/vendor/local/share/doc/groonga/en/html/_static/searchtools.js +1 -1
  91. data/vendor/local/share/doc/groonga/en/html/_static/websupport.js +1 -1
  92. data/vendor/local/share/doc/groonga/en/html/characteristic.html +5 -5
  93. data/vendor/local/share/doc/groonga/en/html/community.html +5 -5
  94. data/vendor/local/share/doc/groonga/en/html/contribution/development/com.html +5 -5
  95. data/vendor/local/share/doc/groonga/en/html/contribution/development/cooperation.html +5 -5
  96. data/vendor/local/share/doc/groonga/en/html/contribution/development/document.html +5 -5
  97. data/vendor/local/share/doc/groonga/en/html/contribution/development/query.html +5 -5
  98. data/vendor/local/share/doc/groonga/en/html/contribution/development/release.html +5 -5
  99. data/vendor/local/share/doc/groonga/en/html/contribution/development/repository.html +5 -5
  100. data/vendor/local/share/doc/groonga/en/html/contribution/development/test.html +5 -5
  101. data/vendor/local/share/doc/groonga/en/html/contribution/development.html +5 -5
  102. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/c-api.html +5 -5
  103. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/i18n.html +5 -5
  104. data/vendor/local/share/doc/groonga/en/html/contribution/documentation.html +5 -5
  105. data/vendor/local/share/doc/groonga/en/html/contribution/report.html +5 -5
  106. data/vendor/local/share/doc/groonga/en/html/contribution.html +5 -5
  107. data/vendor/local/share/doc/groonga/en/html/development/travis-ci.html +5 -5
  108. data/vendor/local/share/doc/groonga/en/html/development.html +5 -5
  109. data/vendor/local/share/doc/groonga/en/html/genindex.html +11 -11
  110. data/vendor/local/share/doc/groonga/en/html/geolocation_search.html +5 -5
  111. data/vendor/local/share/doc/groonga/en/html/index.html +68 -67
  112. data/vendor/local/share/doc/groonga/en/html/install/centos.html +8 -8
  113. data/vendor/local/share/doc/groonga/en/html/install/debian.html +8 -8
  114. data/vendor/local/share/doc/groonga/en/html/install/fedora.html +8 -8
  115. data/vendor/local/share/doc/groonga/en/html/install/mac_os_x.html +8 -8
  116. data/vendor/local/share/doc/groonga/en/html/install/others.html +8 -8
  117. data/vendor/local/share/doc/groonga/en/html/install/solaris.html +8 -8
  118. data/vendor/local/share/doc/groonga/en/html/install/ubuntu.html +8 -8
  119. data/vendor/local/share/doc/groonga/en/html/install/windows.html +14 -14
  120. data/vendor/local/share/doc/groonga/en/html/install.html +5 -5
  121. data/vendor/local/share/doc/groonga/en/html/limitations.html +5 -5
  122. data/vendor/local/share/doc/groonga/en/html/news/0.x.html +5 -5
  123. data/vendor/local/share/doc/groonga/en/html/news/1.0.x.html +5 -5
  124. data/vendor/local/share/doc/groonga/en/html/news/1.1.x.html +5 -5
  125. data/vendor/local/share/doc/groonga/en/html/news/1.2.x.html +5 -5
  126. data/vendor/local/share/doc/groonga/en/html/news/senna.html +5 -5
  127. data/vendor/local/share/doc/groonga/en/html/news.html +247 -200
  128. data/vendor/local/share/doc/groonga/en/html/objects.inv +0 -0
  129. data/vendor/local/share/doc/groonga/en/html/reference/api/global_configurations.html +24 -24
  130. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_cache.html +26 -26
  131. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_column.html +26 -26
  132. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_command_version.html +26 -26
  133. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ctx.html +26 -26
  134. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_db.html +26 -26
  135. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_encoding.html +26 -26
  136. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_expr.html +24 -24
  137. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_geo.html +26 -26
  138. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_hook.html +26 -26
  139. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ii.html +26 -26
  140. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_index_cursor.html +26 -26
  141. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_info.html +26 -26
  142. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_match_escalation.html +26 -26
  143. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_obj.html +26 -26
  144. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_proc.html +26 -26
  145. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_search.html +26 -26
  146. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table.html +26 -26
  147. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table_cursor.html +26 -26
  148. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_type.html +26 -26
  149. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_user_data.html +22 -22
  150. data/vendor/local/share/doc/groonga/en/html/reference/api.html +38 -38
  151. data/vendor/local/share/doc/groonga/en/html/reference/cast.html +5 -5
  152. data/vendor/local/share/doc/groonga/en/html/reference/column.html +153 -0
  153. data/vendor/local/share/doc/groonga/en/html/reference/columns/vector.html +857 -0
  154. data/vendor/local/share/doc/groonga/en/html/reference/command/command_version.html +7 -7
  155. data/vendor/local/share/doc/groonga/en/html/reference/command/output_format.html +7 -7
  156. data/vendor/local/share/doc/groonga/en/html/reference/command/return_code.html +7 -7
  157. data/vendor/local/share/doc/groonga/en/html/reference/command.html +8 -8
  158. data/vendor/local/share/doc/groonga/en/html/reference/commands/cache_limit.html +8 -8
  159. data/vendor/local/share/doc/groonga/en/html/reference/commands/check.html +7 -7
  160. data/vendor/local/share/doc/groonga/en/html/reference/commands/clearlock.html +7 -7
  161. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_create.html +8 -9
  162. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_list.html +7 -7
  163. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_remove.html +7 -7
  164. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_rename.html +47 -26
  165. data/vendor/local/share/doc/groonga/en/html/reference/commands/define_selector.html +7 -7
  166. data/vendor/local/share/doc/groonga/en/html/reference/commands/defrag.html +7 -7
  167. data/vendor/local/share/doc/groonga/en/html/reference/commands/delete.html +8 -9
  168. data/vendor/local/share/doc/groonga/en/html/reference/commands/dump.html +7 -7
  169. data/vendor/local/share/doc/groonga/en/html/reference/commands/load.html +7 -7
  170. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_level.html +7 -7
  171. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_put.html +7 -7
  172. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_reopen.html +7 -7
  173. data/vendor/local/share/doc/groonga/en/html/reference/commands/normalize.html +10 -10
  174. data/vendor/local/share/doc/groonga/en/html/reference/commands/quit.html +7 -7
  175. data/vendor/local/share/doc/groonga/en/html/reference/commands/register.html +7 -7
  176. data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_eval.html +7 -7
  177. data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_load.html +7 -7
  178. data/vendor/local/share/doc/groonga/en/html/reference/commands/select.html +193 -7
  179. data/vendor/local/share/doc/groonga/en/html/reference/commands/shutdown.html +7 -7
  180. data/vendor/local/share/doc/groonga/en/html/reference/commands/status.html +12 -12
  181. data/vendor/local/share/doc/groonga/en/html/reference/commands/suggest.html +7 -7
  182. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_create.html +8 -8
  183. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_list.html +7 -7
  184. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_remove.html +7 -7
  185. data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenize.html +7 -7
  186. data/vendor/local/share/doc/groonga/en/html/reference/commands/truncate.html +8 -9
  187. data/vendor/local/share/doc/groonga/en/html/reference/executables/grnslap.html +7 -7
  188. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-benchmark.html +7 -7
  189. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-httpd.html +10 -10
  190. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-server-http.html +7 -7
  191. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-create-dataset.html +7 -7
  192. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-httpd.html +165 -13
  193. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-learner.html +25 -8
  194. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga.html +7 -7
  195. data/vendor/local/share/doc/groonga/en/html/reference/executables.html +12 -12
  196. data/vendor/local/share/doc/groonga/en/html/reference/function.html +28 -28
  197. data/vendor/local/share/doc/groonga/en/html/reference/functions/between.html +40 -40
  198. data/vendor/local/share/doc/groonga/en/html/reference/functions/edit_distance.html +32 -32
  199. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_distance.html +50 -50
  200. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_circle.html +32 -32
  201. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_rectangle.html +32 -32
  202. data/vendor/local/share/doc/groonga/en/html/reference/functions/html_untag.html +34 -34
  203. data/vendor/local/share/doc/groonga/en/html/reference/functions/now.html +30 -30
  204. data/vendor/local/share/doc/groonga/en/html/reference/functions/query.html +46 -46
  205. data/vendor/local/share/doc/groonga/en/html/reference/functions/rand.html +32 -32
  206. data/vendor/local/share/doc/groonga/en/html/reference/functions/snippet_html.html +32 -32
  207. data/vendor/local/share/doc/groonga/en/html/reference/functions/sub_filter.html +36 -36
  208. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/query_syntax.html +62 -62
  209. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/script_syntax.html +140 -140
  210. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr.html +22 -22
  211. data/vendor/local/share/doc/groonga/en/html/reference/indexing.html +24 -24
  212. data/vendor/local/share/doc/groonga/en/html/reference/log.html +26 -26
  213. data/vendor/local/share/doc/groonga/en/html/reference/normalizers.html +31 -31
  214. data/vendor/local/share/doc/groonga/en/html/reference/output.html +8 -8
  215. data/vendor/local/share/doc/groonga/en/html/reference/pseudo_column.html +22 -22
  216. data/vendor/local/share/doc/groonga/en/html/reference/query_expanders/tsv.html +36 -36
  217. data/vendor/local/share/doc/groonga/en/html/reference/query_expanders.html +18 -18
  218. data/vendor/local/share/doc/groonga/en/html/reference/tables.html +13 -13
  219. data/vendor/local/share/doc/groonga/en/html/reference/tokenizers.html +17 -17
  220. data/vendor/local/share/doc/groonga/en/html/reference/tuning.html +38 -38
  221. data/vendor/local/share/doc/groonga/en/html/reference/types.html +8 -8
  222. data/vendor/local/share/doc/groonga/en/html/reference.html +69 -68
  223. data/vendor/local/share/doc/groonga/en/html/search.html +5 -5
  224. data/vendor/local/share/doc/groonga/en/html/searchindex.js +1 -1
  225. data/vendor/local/share/doc/groonga/en/html/server/gqtp.html +5 -5
  226. data/vendor/local/share/doc/groonga/en/html/server/http/comparison.html +5 -5
  227. data/vendor/local/share/doc/groonga/en/html/server/http/groonga-httpd.html +9 -9
  228. data/vendor/local/share/doc/groonga/en/html/server/http/groonga.html +5 -5
  229. data/vendor/local/share/doc/groonga/en/html/server/http.html +5 -5
  230. data/vendor/local/share/doc/groonga/en/html/server/package.html +5 -5
  231. data/vendor/local/share/doc/groonga/en/html/server.html +5 -5
  232. data/vendor/local/share/doc/groonga/en/html/spec/gqtp.html +5 -5
  233. data/vendor/local/share/doc/groonga/en/html/spec/search.html +5 -5
  234. data/vendor/local/share/doc/groonga/en/html/spec.html +9 -9
  235. data/vendor/local/share/doc/groonga/en/html/suggest/completion.html +5 -5
  236. data/vendor/local/share/doc/groonga/en/html/suggest/correction.html +5 -5
  237. data/vendor/local/share/doc/groonga/en/html/suggest/introduction.html +5 -5
  238. data/vendor/local/share/doc/groonga/en/html/suggest/suggestion.html +5 -5
  239. data/vendor/local/share/doc/groonga/en/html/suggest/tutorial.html +5 -5
  240. data/vendor/local/share/doc/groonga/en/html/suggest.html +5 -5
  241. data/vendor/local/share/doc/groonga/en/html/troubleshooting/different_results_with_the_same_keyword.html +5 -5
  242. data/vendor/local/share/doc/groonga/en/html/troubleshooting/mmap_cannot_allocate_memory.html +5 -5
  243. data/vendor/local/share/doc/groonga/en/html/troubleshooting.html +5 -5
  244. data/vendor/local/share/doc/groonga/en/html/tutorial/data.html +5 -5
  245. data/vendor/local/share/doc/groonga/en/html/tutorial/drilldown.html +5 -5
  246. data/vendor/local/share/doc/groonga/en/html/tutorial/index.html +5 -5
  247. data/vendor/local/share/doc/groonga/en/html/tutorial/introduction.html +8 -8
  248. data/vendor/local/share/doc/groonga/en/html/tutorial/lexicon.html +5 -5
  249. data/vendor/local/share/doc/groonga/en/html/tutorial/match_columns.html +5 -5
  250. data/vendor/local/share/doc/groonga/en/html/tutorial/micro_blog.html +5 -5
  251. data/vendor/local/share/doc/groonga/en/html/tutorial/network.html +12 -12
  252. data/vendor/local/share/doc/groonga/en/html/tutorial/patricia_trie.html +5 -5
  253. data/vendor/local/share/doc/groonga/en/html/tutorial/query_expansion.html +5 -5
  254. data/vendor/local/share/doc/groonga/en/html/tutorial/search.html +5 -5
  255. data/vendor/local/share/doc/groonga/en/html/tutorial.html +5 -5
  256. data/vendor/local/share/doc/groonga/ja/html/.buildinfo +1 -1
  257. data/vendor/local/share/doc/groonga/ja/html/_sources/install/centos.txt +3 -3
  258. data/vendor/local/share/doc/groonga/ja/html/_sources/install/debian.txt +3 -3
  259. data/vendor/local/share/doc/groonga/ja/html/_sources/install/fedora.txt +3 -3
  260. data/vendor/local/share/doc/groonga/ja/html/_sources/install/mac_os_x.txt +3 -3
  261. data/vendor/local/share/doc/groonga/ja/html/_sources/install/others.txt +3 -3
  262. data/vendor/local/share/doc/groonga/ja/html/_sources/install/solaris.txt +3 -3
  263. data/vendor/local/share/doc/groonga/ja/html/_sources/install/ubuntu.txt +3 -3
  264. data/vendor/local/share/doc/groonga/ja/html/_sources/install/windows.txt +9 -9
  265. data/vendor/local/share/doc/groonga/ja/html/_sources/news.txt +41 -0
  266. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/column.txt +25 -0
  267. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/columns/vector.txt +333 -0
  268. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/cache_limit.txt +1 -1
  269. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/column_create.txt +1 -2
  270. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/column_rename.txt +37 -17
  271. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/delete.txt +4 -5
  272. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/normalize.txt +1 -2
  273. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/select.txt +99 -0
  274. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_create.txt +1 -1
  275. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/truncate.txt +1 -2
  276. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/groonga-suggest-httpd.txt +128 -4
  277. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/groonga-suggest-learner.txt +11 -1
  278. data/vendor/local/share/doc/groonga/ja/html/_sources/reference.txt +3 -2
  279. data/vendor/local/share/doc/groonga/ja/html/_static/basic.css +1 -1
  280. data/vendor/local/share/doc/groonga/ja/html/_static/doctools.js +1 -1
  281. data/vendor/local/share/doc/groonga/ja/html/_static/searchtools.js +1 -1
  282. data/vendor/local/share/doc/groonga/ja/html/_static/websupport.js +1 -1
  283. data/vendor/local/share/doc/groonga/ja/html/characteristic.html +5 -5
  284. data/vendor/local/share/doc/groonga/ja/html/community.html +5 -5
  285. data/vendor/local/share/doc/groonga/ja/html/contribution/development/com.html +5 -5
  286. data/vendor/local/share/doc/groonga/ja/html/contribution/development/cooperation.html +5 -5
  287. data/vendor/local/share/doc/groonga/ja/html/contribution/development/document.html +5 -5
  288. data/vendor/local/share/doc/groonga/ja/html/contribution/development/query.html +5 -5
  289. data/vendor/local/share/doc/groonga/ja/html/contribution/development/release.html +5 -5
  290. data/vendor/local/share/doc/groonga/ja/html/contribution/development/repository.html +5 -5
  291. data/vendor/local/share/doc/groonga/ja/html/contribution/development/test.html +5 -5
  292. data/vendor/local/share/doc/groonga/ja/html/contribution/development.html +5 -5
  293. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/c-api.html +5 -5
  294. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/i18n.html +5 -5
  295. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation.html +5 -5
  296. data/vendor/local/share/doc/groonga/ja/html/contribution/report.html +5 -5
  297. data/vendor/local/share/doc/groonga/ja/html/contribution.html +5 -5
  298. data/vendor/local/share/doc/groonga/ja/html/development/travis-ci.html +5 -5
  299. data/vendor/local/share/doc/groonga/ja/html/development.html +5 -5
  300. data/vendor/local/share/doc/groonga/ja/html/genindex.html +11 -11
  301. data/vendor/local/share/doc/groonga/ja/html/geolocation_search.html +5 -5
  302. data/vendor/local/share/doc/groonga/ja/html/index.html +67 -66
  303. data/vendor/local/share/doc/groonga/ja/html/install/centos.html +8 -8
  304. data/vendor/local/share/doc/groonga/ja/html/install/debian.html +8 -8
  305. data/vendor/local/share/doc/groonga/ja/html/install/fedora.html +8 -8
  306. data/vendor/local/share/doc/groonga/ja/html/install/mac_os_x.html +8 -8
  307. data/vendor/local/share/doc/groonga/ja/html/install/others.html +8 -8
  308. data/vendor/local/share/doc/groonga/ja/html/install/solaris.html +8 -8
  309. data/vendor/local/share/doc/groonga/ja/html/install/ubuntu.html +8 -8
  310. data/vendor/local/share/doc/groonga/ja/html/install/windows.html +14 -14
  311. data/vendor/local/share/doc/groonga/ja/html/install.html +5 -5
  312. data/vendor/local/share/doc/groonga/ja/html/limitations.html +5 -5
  313. data/vendor/local/share/doc/groonga/ja/html/news/0.x.html +5 -5
  314. data/vendor/local/share/doc/groonga/ja/html/news/1.0.x.html +5 -5
  315. data/vendor/local/share/doc/groonga/ja/html/news/1.1.x.html +5 -5
  316. data/vendor/local/share/doc/groonga/ja/html/news/1.2.x.html +5 -5
  317. data/vendor/local/share/doc/groonga/ja/html/news/senna.html +5 -5
  318. data/vendor/local/share/doc/groonga/ja/html/news.html +262 -200
  319. data/vendor/local/share/doc/groonga/ja/html/objects.inv +0 -0
  320. data/vendor/local/share/doc/groonga/ja/html/reference/api/global_configurations.html +22 -22
  321. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_cache.html +24 -24
  322. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_column.html +24 -24
  323. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_command_version.html +24 -24
  324. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ctx.html +24 -24
  325. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_db.html +24 -24
  326. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_encoding.html +24 -24
  327. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_expr.html +22 -22
  328. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_geo.html +24 -24
  329. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_hook.html +24 -24
  330. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ii.html +24 -24
  331. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_index_cursor.html +24 -24
  332. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_info.html +24 -24
  333. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_match_escalation.html +24 -24
  334. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_obj.html +24 -24
  335. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_proc.html +24 -24
  336. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_search.html +24 -24
  337. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table.html +24 -24
  338. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table_cursor.html +24 -24
  339. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_type.html +24 -24
  340. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_user_data.html +20 -20
  341. data/vendor/local/share/doc/groonga/ja/html/reference/api.html +35 -35
  342. data/vendor/local/share/doc/groonga/ja/html/reference/cast.html +5 -5
  343. data/vendor/local/share/doc/groonga/ja/html/reference/column.html +150 -0
  344. data/vendor/local/share/doc/groonga/ja/html/reference/columns/vector.html +824 -0
  345. data/vendor/local/share/doc/groonga/ja/html/reference/command/command_version.html +5 -5
  346. data/vendor/local/share/doc/groonga/ja/html/reference/command/output_format.html +5 -5
  347. data/vendor/local/share/doc/groonga/ja/html/reference/command/return_code.html +5 -5
  348. data/vendor/local/share/doc/groonga/ja/html/reference/command.html +5 -5
  349. data/vendor/local/share/doc/groonga/ja/html/reference/commands/cache_limit.html +6 -6
  350. data/vendor/local/share/doc/groonga/ja/html/reference/commands/check.html +5 -5
  351. data/vendor/local/share/doc/groonga/ja/html/reference/commands/clearlock.html +5 -5
  352. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_create.html +6 -6
  353. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_list.html +5 -5
  354. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_remove.html +5 -5
  355. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_rename.html +45 -24
  356. data/vendor/local/share/doc/groonga/ja/html/reference/commands/define_selector.html +5 -5
  357. data/vendor/local/share/doc/groonga/ja/html/reference/commands/defrag.html +5 -5
  358. data/vendor/local/share/doc/groonga/ja/html/reference/commands/delete.html +6 -6
  359. data/vendor/local/share/doc/groonga/ja/html/reference/commands/dump.html +5 -5
  360. data/vendor/local/share/doc/groonga/ja/html/reference/commands/load.html +5 -5
  361. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_level.html +5 -5
  362. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_put.html +5 -5
  363. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_reopen.html +5 -5
  364. data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalize.html +8 -7
  365. data/vendor/local/share/doc/groonga/ja/html/reference/commands/quit.html +5 -5
  366. data/vendor/local/share/doc/groonga/ja/html/reference/commands/register.html +5 -5
  367. data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_eval.html +5 -5
  368. data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_load.html +5 -5
  369. data/vendor/local/share/doc/groonga/ja/html/reference/commands/select.html +174 -5
  370. data/vendor/local/share/doc/groonga/ja/html/reference/commands/shutdown.html +5 -5
  371. data/vendor/local/share/doc/groonga/ja/html/reference/commands/status.html +10 -10
  372. data/vendor/local/share/doc/groonga/ja/html/reference/commands/suggest.html +5 -5
  373. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_create.html +6 -6
  374. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_list.html +5 -5
  375. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_remove.html +5 -5
  376. data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenize.html +5 -5
  377. data/vendor/local/share/doc/groonga/ja/html/reference/commands/truncate.html +6 -6
  378. data/vendor/local/share/doc/groonga/ja/html/reference/executables/grnslap.html +5 -5
  379. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-benchmark.html +5 -5
  380. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-httpd.html +8 -8
  381. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-server-http.html +5 -5
  382. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-create-dataset.html +5 -5
  383. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-httpd.html +167 -11
  384. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-learner.html +23 -6
  385. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga.html +5 -5
  386. data/vendor/local/share/doc/groonga/ja/html/reference/executables.html +5 -5
  387. data/vendor/local/share/doc/groonga/ja/html/reference/function.html +25 -25
  388. data/vendor/local/share/doc/groonga/ja/html/reference/functions/between.html +38 -38
  389. data/vendor/local/share/doc/groonga/ja/html/reference/functions/edit_distance.html +30 -30
  390. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_distance.html +48 -48
  391. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_circle.html +30 -30
  392. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_rectangle.html +30 -30
  393. data/vendor/local/share/doc/groonga/ja/html/reference/functions/html_untag.html +32 -32
  394. data/vendor/local/share/doc/groonga/ja/html/reference/functions/now.html +28 -28
  395. data/vendor/local/share/doc/groonga/ja/html/reference/functions/query.html +44 -44
  396. data/vendor/local/share/doc/groonga/ja/html/reference/functions/rand.html +30 -30
  397. data/vendor/local/share/doc/groonga/ja/html/reference/functions/snippet_html.html +30 -30
  398. data/vendor/local/share/doc/groonga/ja/html/reference/functions/sub_filter.html +34 -34
  399. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/query_syntax.html +60 -60
  400. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/script_syntax.html +138 -138
  401. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr.html +19 -19
  402. data/vendor/local/share/doc/groonga/ja/html/reference/indexing.html +21 -21
  403. data/vendor/local/share/doc/groonga/ja/html/reference/log.html +23 -23
  404. data/vendor/local/share/doc/groonga/ja/html/reference/normalizers.html +28 -28
  405. data/vendor/local/share/doc/groonga/ja/html/reference/output.html +5 -5
  406. data/vendor/local/share/doc/groonga/ja/html/reference/pseudo_column.html +19 -19
  407. data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders/tsv.html +34 -34
  408. data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders.html +15 -15
  409. data/vendor/local/share/doc/groonga/ja/html/reference/tables.html +10 -10
  410. data/vendor/local/share/doc/groonga/ja/html/reference/tokenizers.html +14 -14
  411. data/vendor/local/share/doc/groonga/ja/html/reference/tuning.html +35 -35
  412. data/vendor/local/share/doc/groonga/ja/html/reference/types.html +5 -5
  413. data/vendor/local/share/doc/groonga/ja/html/reference.html +69 -68
  414. data/vendor/local/share/doc/groonga/ja/html/search.html +5 -5
  415. data/vendor/local/share/doc/groonga/ja/html/searchindex.js +1 -1
  416. data/vendor/local/share/doc/groonga/ja/html/server/gqtp.html +5 -5
  417. data/vendor/local/share/doc/groonga/ja/html/server/http/comparison.html +5 -5
  418. data/vendor/local/share/doc/groonga/ja/html/server/http/groonga-httpd.html +5 -5
  419. data/vendor/local/share/doc/groonga/ja/html/server/http/groonga.html +5 -5
  420. data/vendor/local/share/doc/groonga/ja/html/server/http.html +5 -5
  421. data/vendor/local/share/doc/groonga/ja/html/server/package.html +5 -5
  422. data/vendor/local/share/doc/groonga/ja/html/server.html +5 -5
  423. data/vendor/local/share/doc/groonga/ja/html/spec/gqtp.html +5 -5
  424. data/vendor/local/share/doc/groonga/ja/html/spec/search.html +5 -5
  425. data/vendor/local/share/doc/groonga/ja/html/spec.html +9 -9
  426. data/vendor/local/share/doc/groonga/ja/html/suggest/completion.html +5 -5
  427. data/vendor/local/share/doc/groonga/ja/html/suggest/correction.html +5 -5
  428. data/vendor/local/share/doc/groonga/ja/html/suggest/introduction.html +5 -5
  429. data/vendor/local/share/doc/groonga/ja/html/suggest/suggestion.html +5 -5
  430. data/vendor/local/share/doc/groonga/ja/html/suggest/tutorial.html +5 -5
  431. data/vendor/local/share/doc/groonga/ja/html/suggest.html +5 -5
  432. data/vendor/local/share/doc/groonga/ja/html/troubleshooting/different_results_with_the_same_keyword.html +5 -5
  433. data/vendor/local/share/doc/groonga/ja/html/troubleshooting/mmap_cannot_allocate_memory.html +5 -5
  434. data/vendor/local/share/doc/groonga/ja/html/troubleshooting.html +5 -5
  435. data/vendor/local/share/doc/groonga/ja/html/tutorial/data.html +5 -5
  436. data/vendor/local/share/doc/groonga/ja/html/tutorial/drilldown.html +5 -5
  437. data/vendor/local/share/doc/groonga/ja/html/tutorial/index.html +5 -5
  438. data/vendor/local/share/doc/groonga/ja/html/tutorial/introduction.html +8 -8
  439. data/vendor/local/share/doc/groonga/ja/html/tutorial/lexicon.html +5 -5
  440. data/vendor/local/share/doc/groonga/ja/html/tutorial/match_columns.html +5 -5
  441. data/vendor/local/share/doc/groonga/ja/html/tutorial/micro_blog.html +5 -5
  442. data/vendor/local/share/doc/groonga/ja/html/tutorial/network.html +12 -12
  443. data/vendor/local/share/doc/groonga/ja/html/tutorial/patricia_trie.html +5 -5
  444. data/vendor/local/share/doc/groonga/ja/html/tutorial/query_expansion.html +5 -5
  445. data/vendor/local/share/doc/groonga/ja/html/tutorial/search.html +5 -5
  446. data/vendor/local/share/doc/groonga/ja/html/tutorial.html +5 -5
  447. data/vendor/local/share/man/ja/man1/groonga.1 +526 -73
  448. data/vendor/local/share/man/man1/groonga.1 +552 -80
  449. metadata +148 -139
@@ -0,0 +1,333 @@
1
+ .. -*- rst -*-
2
+
3
+ .. highlightlang:: none
4
+
5
+ .. groonga-command
6
+ .. database: columns_vector
7
+
8
+ Vector column
9
+ =============
10
+
11
+ Summary
12
+ -------
13
+
14
+ Vector column is a data store object. It can stores zero or more
15
+ scalar values. In short, scalar value is a single value such as number
16
+ and string. See :doc:`scalar` about scalar value details.
17
+
18
+ One of vector column use cases is tags store. You can use a vector
19
+ column to store tag values.
20
+
21
+ You can use vector column as index search target in the same way as
22
+ scalar column. You can set weight for each element. The element that
23
+ has one or more weight is matched, the record has more score rather
24
+ than no weight case. It is a vector column specific feature. Vector
25
+ column that can store weight is called weight vector column.
26
+
27
+ You can also do full text search against each text element. But search
28
+ score is too high when weight is used. You should use full text search
29
+ with weight carefully.
30
+
31
+ Usage
32
+ -----
33
+
34
+ There are three vector column types:
35
+
36
+ * Normal vector column
37
+ * Reference vector column
38
+ * Weight vector column
39
+
40
+ This section describes how to use these types.
41
+
42
+ .. _normal-vector-column:
43
+
44
+ Normal vector column
45
+ ^^^^^^^^^^^^^^^^^^^^
46
+
47
+ Normal vector column stores zero or more scalar data. For example,
48
+ scalar data are number, string and so on.
49
+
50
+ A normal vector column can store the same type elements. You can't mix
51
+ types. For example, you can't store a number and a string in the same
52
+ normal vector column.
53
+
54
+ Normal vector column is useful when a record has multiple values with
55
+ a key. Tags are the most popular use case.
56
+
57
+ How to create
58
+ """""""""""""
59
+
60
+ Use :doc:`/reference/commands/column_create` command to create a
61
+ normal vector column. The point is ``COLUMN_VECTOR`` flag:
62
+
63
+ .. groonga-command
64
+ .. include:: ../../example/reference/columns/vector/usage_create_normal.log
65
+ .. table_create Bookmarks TABLE_HASH_KEY ShortText
66
+ .. column_create Bookmarks tags COLUMN_VECTOR ShortText
67
+
68
+ You can set zero or more tags to a bookmark.
69
+
70
+ How to load
71
+ """""""""""
72
+
73
+ You can load vector data by JSON array syntax::
74
+
75
+ [ELEMENT1, ELEMENT2, ELEMENT3, ...]
76
+
77
+ Let's load the following data:
78
+
79
+ .. list-table::
80
+ :header-rows: 1
81
+
82
+ * - ``_key``
83
+ - ``tags``
84
+ * - ``http://groonga.org/``
85
+ - ``["groonga"]``
86
+ * - ``http://mroonga.org/``
87
+ - ``["mroonga", "mysql", "groonga"]``
88
+ * - ``http://ranguba.org/``
89
+ - ``["ruby", "groonga"]``
90
+
91
+ Here is a command that loads the data:
92
+
93
+ .. groonga-command
94
+ .. include:: ../../example/reference/columns/vector/usage_load_normal.log
95
+ .. load --table Bookmarks
96
+ .. [
97
+ .. {"_key": "http://groonga.org/", "tags": ["groonga"]},
98
+ .. {"_key": "http://mroonga.org/", "tags": ["mroonga", "mysql", "groonga"]},
99
+ .. {"_key": "http://ranguba.org/", "tags": ["ruby", "groonga"]}
100
+ .. ]
101
+
102
+ The loaded data can be outputted as JSON array syntax:
103
+
104
+ .. groonga-command
105
+ .. include:: ../../example/reference/columns/vector/usage_output_normal.log
106
+ .. select Bookmarks
107
+
108
+ How to search
109
+ """""""""""""
110
+
111
+ You need to create an index to search normal vector column:
112
+
113
+ .. groonga-command
114
+ .. include:: ../../example/reference/columns/vector/usage_index_normal.log
115
+ .. table_create Tags TABLE_PAT_KEY ShortText
116
+ .. column_create Tags bookmark_index COLUMN_INDEX Bookmarks tags
117
+
118
+ There are no vector column specific way. You can create an index like
119
+ a scalar column.
120
+
121
+ You can search an element in ``tags`` like full text search syntax.
122
+
123
+ With :ref:`select-match-columns` and :ref:`select-query`:
124
+
125
+ .. groonga-command
126
+ .. include:: ../../example/reference/columns/vector/usage_query_normal.log
127
+ .. select Bookmarks --match_columns tags --query mysql --output_columns _key,tags,_score
128
+
129
+ You can also use weight in :ref:`select-match-columns`:
130
+
131
+ .. groonga-command
132
+ .. include:: ../../example/reference/columns/vector/usage_query_weight_normal.log
133
+ .. select Bookmarks --match_columns 'tags * 3' --query mysql --output_columns _key,tags,_score
134
+
135
+ With :ref:`select-filter`:
136
+
137
+ .. groonga-command
138
+ .. include:: ../../example/reference/columns/vector/usage_filter_normal.log
139
+ .. select Bookmarks --filter 'tags @ "msyql"' --output_columns _key,tags,_score
140
+
141
+ .. groonga-command
142
+ .. table_remove Tags
143
+ .. table_remove Bookmarks
144
+
145
+ .. _reference-vector-column:
146
+
147
+ Reference vector column
148
+ ^^^^^^^^^^^^^^^^^^^^^^^
149
+
150
+ TODO
151
+
152
+ Reference vector column is space-efficient if there are many same
153
+ value elements. Reference vector column keeps reference record IDs not
154
+ value itself. Record ID is smaller than value itself.
155
+
156
+ How to create
157
+ """""""""""""
158
+
159
+ TODO
160
+
161
+ How to load
162
+ """""""""""
163
+
164
+ TODO
165
+
166
+ How to search
167
+ """""""""""""
168
+
169
+ TODO
170
+
171
+ .. _weight-vector-column:
172
+
173
+ Weight vector column
174
+ ^^^^^^^^^^^^^^^^^^^^
175
+
176
+ Weight vector column is similar to normal vector column. It can store
177
+ elements. It can also stores weights for them. Weight is degree of
178
+ importance of the element.
179
+
180
+ Weight is positive integer. ``0`` is the default weight. It means that
181
+ no weight.
182
+
183
+ If weight is one or larger, search score is increased by the
184
+ weight. If the weight is ``0``, score is ``1``. If the weight is
185
+ ``10``, score is ``11`` (``= 1 + 10``).
186
+
187
+ Weight vector column is useful for tuning search score. See also
188
+ :ref:`select-adjuster`. You can increase search score of specific
189
+ records.
190
+
191
+ Limitations
192
+ """""""""""
193
+
194
+ There are some limitations for now. They will be resolved in the
195
+ future.
196
+
197
+ Here are limitations:
198
+
199
+ * You need to use string representation for element value on load.
200
+ For example, you can't use ``29`` for number 29. You need to use
201
+ ``"29"`` for number 29.
202
+ * You can't use reference type.
203
+
204
+ How to create
205
+ """""""""""""
206
+
207
+ Use :doc:`/reference/commands/column_create` command to create a
208
+ weight vector column. The point is ``COLUMN_VECTOR|WITH_WEIGHT``
209
+ flags:
210
+
211
+ .. groonga-command
212
+ .. include:: ../../example/reference/columns/vector/usage_create_weight.log
213
+ .. table_create Bookmarks TABLE_HASH_KEY ShortText
214
+ .. column_create Bookmarks tags COLUMN_VECTOR|WITH_WEIGHT ShortText
215
+
216
+ If you don't specify ``WITH_WEIGHT`` flag, it is just a normal vector
217
+ column.
218
+
219
+ You can set zero or more tags with weight to a bookmark.
220
+
221
+ How to load
222
+ """""""""""
223
+
224
+ You can load vector data by JSON object syntax::
225
+
226
+ {"ELEMENT1": WEIGHT1, "ELEMENT2": WEIGHT2, "ELEMENT3": WEIGHT3, ...}
227
+
228
+ Let's load the following data:
229
+
230
+ .. list-table::
231
+ :header-rows: 1
232
+
233
+ * - ``_key``
234
+ - ``tags``
235
+ * - ``http://groonga.org/``
236
+ - ``{"groonga": 100}``
237
+ * - ``http://mroonga.org/``
238
+ - ``{"mroonga": 100, "mysql": 50, "groonga": 10}``
239
+ * - ``http://ranguba.org/``
240
+ - ``{"ruby": 100, "groonga": 50}``
241
+
242
+ Here is a command that loads the data:
243
+
244
+ .. groonga-command
245
+ .. include:: ../../example/reference/columns/vector/usage_load_weight.log
246
+ .. load --table Bookmarks
247
+ .. [
248
+ .. {"_key": "http://groonga.org/",
249
+ .. "tags": {"groonga": 100}},
250
+ .. {"_key": "http://mroonga.org/",
251
+ .. "tags": {"mroonga": 100,
252
+ .. "mysql": 50,
253
+ .. "groonga": 10}},
254
+ .. {"_key": "http://ranguba.org/",
255
+ .. "tags": {"ruby": 100,
256
+ .. "groonga": 50}}
257
+ .. ]
258
+
259
+ The loaded data can be outputted as JSON object syntax:
260
+
261
+ .. groonga-command
262
+ .. include:: ../../example/reference/columns/vector/usage_output_weight.log
263
+ .. select Bookmarks
264
+
265
+ How to search
266
+ """""""""""""
267
+
268
+ You need to create an index to search weight vector column. You don't
269
+ forget to specify ``WITH_WEIGHT`` flag to ``column_create``:
270
+
271
+ .. groonga-command
272
+ .. include:: ../../example/reference/columns/vector/usage_index_weight.log
273
+ .. table_create Tags TABLE_PAT_KEY ShortText
274
+ .. column_create Tags bookmark_index COLUMN_INDEX|WITH_WEIGHT Bookmarks tags
275
+
276
+ There are no weight vector column specific way except ``WITH_WEIGHT``
277
+ flag. You can create an index like a scalar column.
278
+
279
+ You can search an element in ``tags`` like full text search syntax.
280
+
281
+ With :ref:`select-match-columns` and :ref:`select-query`:
282
+
283
+ .. groonga-command
284
+ .. include:: ../../example/reference/columns/vector/usage_query_weight.log
285
+ .. select Bookmarks --match_columns tags --query groonga --output_columns _key,tags,_score
286
+
287
+ You can also use weight in :ref:`select-match-columns`. The score is
288
+ ``(1 + weight_in_weight_vector) * weight_in_match_columns``:
289
+
290
+ .. groonga-command
291
+ .. include:: ../../example/reference/columns/vector/usage_query_weight_weight.log
292
+ .. select Bookmarks --match_columns 'tags * 3' --query groonga --output_columns _key,tags,_score
293
+
294
+ With :ref:`select-filter`:
295
+
296
+ .. groonga-command
297
+ .. include:: ../../example/reference/columns/vector/usage_filter_weight.log
298
+ .. select Bookmarks --filter 'tags @ "groonga"' --output_columns _key,tags,_score
299
+
300
+ How to apply just weight
301
+ """"""""""""""""""""""""
302
+
303
+ You can use weight in weight vector column to just increase search
304
+ score without changing a set of matched records.
305
+
306
+ Use :ref:`select-adjuster` for the purpose:
307
+
308
+ .. groonga-command
309
+ .. include:: ../../example/reference/columns/vector/usage_adjuster_weight.log
310
+ .. select Bookmarks \
311
+ .. --filter true \
312
+ .. --adjuster 'tags @ "mysql" * 10 + tags @ "groonga" * 5' \
313
+ .. --output_columns _key,tags,_score
314
+
315
+ The ``select`` command uses ``--filter true``. So all records are
316
+ matched with score 1. Then it applies ``--adjuster``. The adjuster
317
+ does the following:
318
+
319
+ * ``tags @ "mysql" * 10`` increases score by ``(1 + weight) * 10``
320
+ of records that has ``"mysql"`` tag.
321
+ * ``tags @ "groonga" * 5`` increases score by ``(1 + weight) * 5``
322
+ of records that has ``"groonga"`` tag.
323
+
324
+ For example, record ``"http://mroonga.org/"`` has both ``"mysql"`` tag
325
+ and ``"groonga"`` tag. So its score is increased by ``565`` (``=
326
+ ((1 + 50) * 10) + ((1 + 10) * 5) = (51 * 10) + (11 * 5) = 510 + 55``).
327
+ The search score is 1 by ``--filter true`` before applying
328
+ ``--adjuster``. So the final search score is ``566`` (``= 1 + 565``)
329
+ of record ``"http://mroonga.org/"``.
330
+
331
+ .. groonga-command
332
+ .. table_remove Tags
333
+ .. table_remove Bookmarks
@@ -70,7 +70,7 @@ Return value
70
70
 
71
71
  ``cache_limit`` returns the current max number of query cache entries::
72
72
 
73
- [[HEADER, N_ENTRIES]]
73
+ [HEADER, N_ENTRIES]
74
74
 
75
75
  ``HEADER``
76
76
 
@@ -94,8 +94,7 @@ Return value
94
94
 
95
95
  ``HEADER``
96
96
 
97
- The format of HEADER is [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_TIME].
98
- See :doc:`/reference/command/output_format` about HEADER.
97
+ See :doc:`/reference/command/output_format` about ``HEADER``.
99
98
 
100
99
  ``SUCCEEDED``
101
100
 
@@ -11,16 +11,31 @@
11
11
  Summary
12
12
  -------
13
13
 
14
- ``column_rename`` command renames specified column name of table.
14
+ ``column_rename`` command renames a column.
15
+
16
+ It is a light operation. It just changes a relationship between name
17
+ and the column object. It doesn't copy column values.
18
+
19
+ It is a dangerous operation. You must stop all operations including
20
+ read operations while you run ``column_rename``. If the following case
21
+ is occurred, Groonga process may be crashed:
22
+
23
+ * Starts an operation (like ``select``) that accesses the column to
24
+ be renamed by the current column name. The current column name is
25
+ called as ``the old column name`` in the below because the column
26
+ name is renamed.
27
+ * Runs ``column_rename``. The ``select`` is still running.
28
+ * The ``select`` accesses the column to be renamed by the old column
29
+ name. But the ``select`` can't find the column by the old name
30
+ because the column has been renamed to the new column name. It may
31
+ crash the Groonga process.
15
32
 
16
33
  Syntax
17
34
  ------
18
35
 
19
- ``column_rename`` command takes two parameters.
20
-
21
- The required parameter is ``table`` and ``column_name``::
36
+ ``column_rename`` command takes three parameters. All parameters are required::
22
37
 
23
- column_rename table column
38
+ column_rename table name new_name
24
39
 
25
40
  Usage
26
41
  -----
@@ -46,20 +61,26 @@ Parameters
46
61
 
47
62
  This section describes parameters of ``column_rename``.
48
63
 
49
- Required parameter
50
- ^^^^^^^^^^^^^^^^^^
64
+ Required parameters
65
+ ^^^^^^^^^^^^^^^^^^^
66
+
67
+ All parameters are required.
68
+
69
+ ``table``
70
+ """""""""
71
+
72
+ It specifies the name of table that has the column to be renamed.
51
73
 
52
- There are required parameters, ``table_name`` and ``column_name``.
74
+ ``name``
75
+ """"""""
53
76
 
54
- ``table_name``
55
- """"""""""""""
77
+ It specifies the column name to be renamed.
56
78
 
57
- It specifies the name of table.
79
+ ``new_name``
80
+ """"""""""""
58
81
 
59
- ``column_name``
60
- """""""""""""""
82
+ It specifies the new column name.
61
83
 
62
- It specifies the name of column.
63
84
 
64
85
  Return value
65
86
  ------------
@@ -70,10 +91,9 @@ Return value
70
91
 
71
92
  ``HEADER``
72
93
 
73
- The format of HEADER is [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_TIME].
74
- See :doc:`/reference/command/output_format` about HEADER.
94
+ See :doc:`/reference/command/output_format` about ``HEADER``.
75
95
 
76
96
  ``SUCCEEDED_OR_NOT``
77
97
 
78
- If command succeeded, it returns true, otherwise it returns false on error.
98
+ It is ``true`` on success, ``false`` otherwise.
79
99
 
@@ -40,7 +40,7 @@ Here are a schema definition and sample data to show usage.
40
40
  .. [
41
41
  .. {"_key": 1, "status": "OK"}
42
42
  .. {"_key": 2, "status": "NG"}
43
- .. ]
43
+ .. ]
44
44
 
45
45
  Delete the record from Entry table which has "2" as the key.
46
46
 
@@ -67,12 +67,12 @@ The country column of Users table associates with Country table.
67
67
  .. {"_key": 2, "name": "Mike", country: "United States"}
68
68
  .. {"_key": 3, "name": "Takashi", country: "Japan"}
69
69
  .. {"_key": 4, "name": "Hanako", country: "Japan"}
70
- .. ]
70
+ .. ]
71
71
  .. load --table Country
72
72
  .. [
73
73
  .. {"_key": "United States"}
74
74
  .. {"_key": "Japan"}
75
- .. ]
75
+ .. ]
76
76
  .. delete Country "United States"
77
77
  .. select Country
78
78
  .. select Users
@@ -108,8 +108,7 @@ Return value
108
108
 
109
109
  ``HEADER``
110
110
 
111
- The format of HEADER is [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_TIME].
112
- See :doc:`/reference/command/output_format` about HEADER.
111
+ See :doc:`/reference/command/output_format` about ``HEADER``.
113
112
 
114
113
  ``SUCCEEDED_OR_NOT``
115
114
 
@@ -132,8 +132,7 @@ Return value
132
132
 
133
133
  ``HEADER``
134
134
 
135
- The format of HEADER is [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_TIME].
136
- See :doc:`/reference/command/output_format` about HEADER.
135
+ See :doc:`/reference/command/output_format` about ``HEADER``.
137
136
 
138
137
  ``normalized_text``
139
138
 
@@ -42,6 +42,7 @@ Syntax
42
42
  [query_expansion=null]
43
43
  [query_flags=ALLOW_PRAGMA|ALLOW_COLUMN|ALLOW_UPDATE|ALLOW_LEADING_NOT|NONE]
44
44
  [query_expander=null]
45
+ [adjuster=null]
45
46
 
46
47
  Usage
47
48
  -----
@@ -838,6 +839,104 @@ TODO: write in English and add example.
838
839
 
839
840
  検索結果をクエリキャッシュに残しません。キャッシュして再利用される可能性が低いクエリに対して用います。キャッシュ容量は有限です。有効なキャッシュが多くヒットするために、このパラメータは有効です。
840
841
 
842
+ Score related parameters
843
+ ^^^^^^^^^^^^^^^^^^^^^^^^
844
+
845
+ There is a score related parameter, ``adjuster``.
846
+
847
+ .. _select-adjuster:
848
+
849
+
850
+ ``adjuster``
851
+ """"""""""""
852
+
853
+ It specifies one or more score adjust expressions. You need to use
854
+ ``adjuster`` with ``query`` or ``filter``. ``adjuster`` doesn't work
855
+ with not searched request.
856
+
857
+ You can increase score of specific records by ``adjuster``. You can
858
+ use ``adjuster`` to set high score for important records.
859
+
860
+ For example, you can use ``adjuster`` to increase score of records
861
+ that have ``groonga`` tag.
862
+
863
+ Here is the syntax::
864
+
865
+ --adjuster "SCORE_ADJUST_EXPRESSION1 + SCORE_ADJUST_EXPRESSION2 + ..."
866
+
867
+ Here is the ``SCORE_ADJUST_EXPRESSION`` syntax::
868
+
869
+ COLUMN @ "KEYWORD" * FACTOR
870
+
871
+ Note the following:
872
+
873
+ * ``COLUMN`` must be indexed.
874
+ * ``"KEYWORD"`` must be a string.
875
+ * ``FACTOR`` must be a positive integer.
876
+
877
+ Here is a sample ``adjuster`` usage example that uses just one
878
+ ``SCORE_ADJUST_EXPRESSION``:
879
+
880
+ .. groonga-command
881
+ .. include:: ../../example/reference/commands/select/adjuster_one.log
882
+ .. select Entries \
883
+ .. --filter true \
884
+ .. --adjuster 'content @ "groonga" * 5' \
885
+ .. --output_columns _key,content,_score
886
+
887
+ The ``select`` command matches all records. Then it applies
888
+ ``adjuster``. The adjuster increases score of records that have
889
+ ``"groonga"`` in ``Entries.content`` column by 5. There is only one
890
+ record that has ``"groonga"`` in ``Entries.content`` column. So the
891
+ record that its key is ``"Groonga"`` has score 6 (``= 1 + 5``).
892
+
893
+ You can omit ``FACTOR``. If you omit ``FACTOR``, it is treated as 1.
894
+
895
+ Here is a sample ``adjuster`` usage example that omits ``FACTOR``:
896
+
897
+ .. groonga-command
898
+ .. include:: ../../example/reference/commands/select/adjuster_no_factor.log
899
+ .. select Entries \
900
+ .. --filter true \
901
+ .. --adjuster 'content @ "groonga"' \
902
+ .. --output_columns _key,content,_score
903
+
904
+ The ``adjuster`` in the ``select`` command doesn't have ``FACTOR``. So
905
+ the factor is treated as 1. There is only one record that has
906
+ ``"groonga"`` in ``Entries.content`` column. So the record that its
907
+ key is ``"Groonga"`` has score 2 (``= 1 + 1``).
908
+
909
+ Here is a sample ``adjuster`` usage example that uses multiple
910
+ ``SCORE_ADJUST_EXPRESSION``:
911
+
912
+ .. groonga-command
913
+ .. include:: ../../example/reference/commands/select/adjuster_multiple.log
914
+ .. select Entries \
915
+ .. --filter true \
916
+ .. --adjuster 'content @ "groonga" * 5 + content @ "started" * 3' \
917
+ .. --output_columns _key,content,_score
918
+
919
+ The ``adjuster`` in the ``select`` command has two
920
+ ``SCORE_ADJUST_EXPRESSION`` s. The final increased score is sum of
921
+ scores of these ``SCORE_ADJUST_EXPRESSION`` s. All
922
+ ``SCORE_ADJUST_EXPRESSION`` s in the ``select`` command are applied to
923
+ a record that its key is ``"Groonga"``. So the final increased score
924
+ of the record is sum of scores of all ``SCORE_ADJUST_EXPRESSION`` s.
925
+
926
+ The first ``SCORE_ADJUST_EXPRESSION`` is ``content @ "groonga" * 5``.
927
+ It increases score by 5.
928
+
929
+ The second ``SCORE_ADJUST_EXPRESSION`` is ``content @ "started" * 3``.
930
+ It increases score by 3.
931
+
932
+ The final increased score is 9 (``= 1 + 5 + 3``).
933
+
934
+ A ``SCORE_ADJUST_EXPRESSION`` has a factor for ``"KEYWORD"``. This
935
+ means that increased scores of all records that has ``"KEYWORD"`` are
936
+ the same value. You can change increase score for each record that has
937
+ the same ``"KEYWORD"``. It is useful to tune search score. See
938
+ :ref:`weight-vector-column` for details.
939
+
841
940
  返値
842
941
  ----
843
942
 
@@ -187,7 +187,7 @@ Here are available flags:
187
187
  +--------------------+------------------------------+
188
188
  | ``TABLE_NO_KEY`` | Array table. |
189
189
  +--------------------+------------------------------+
190
- | ``TABLE_HASH_HEY`` | Hash table. |
190
+ | ``TABLE_HASH_KEY`` | Hash table. |
191
191
  +--------------------+------------------------------+
192
192
  | ``TABLE_PAT_KEY`` | Patricia trie. |
193
193
  +--------------------+------------------------------+
@@ -64,8 +64,7 @@ Return value
64
64
 
65
65
  ``HEADER``
66
66
 
67
- The format of HEADER is [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_TIME].
68
- See :doc:`/reference/command/output_format` about HEADER.
67
+ See :doc:`/reference/command/output_format` about ``HEADER``.
69
68
 
70
69
  ``SUCCEEDED_OR_NOT``
71
70