rroonga 5.0.4-x86-mingw32 → 5.0.5-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (751) hide show
  1. checksums.yaml +8 -8
  2. data/README.md +2 -2
  3. data/example/measure-data-column-disk-usage.rb +124 -0
  4. data/example/measure-index-column-disk-usage.rb +81 -0
  5. data/example/measure-table-disk-usage.rb +100 -0
  6. data/ext/groonga/rb-grn-database.c +31 -0
  7. data/ext/groonga/rb-grn-double-array-trie.c +1 -8
  8. data/ext/groonga/rb-grn-logger.c +45 -0
  9. data/ext/groonga/rb-grn-object.c +29 -1
  10. data/ext/groonga/rb-grn-patricia-trie.c +1 -8
  11. data/ext/groonga/rb-grn-table-cursor.c +8 -3
  12. data/ext/groonga/rb-grn-table.c +10 -5
  13. data/ext/groonga/rb-grn-thread.c +160 -0
  14. data/ext/groonga/rb-grn-windows-event-logger.c +79 -0
  15. data/ext/groonga/rb-grn.h +3 -1
  16. data/ext/groonga/rb-groonga.c +3 -1
  17. data/lib/1.9/groonga.so +0 -0
  18. data/lib/2.0/groonga.so +0 -0
  19. data/lib/2.1/groonga.so +0 -0
  20. data/lib/2.2/groonga.so +0 -0
  21. data/lib/groonga/dumper.rb +6 -1
  22. data/rroonga-build.rb +4 -4
  23. data/test/groonga-test-utils.rb +5 -1
  24. data/test/test-database.rb +11 -0
  25. data/test/test-logger.rb +6 -0
  26. data/test/test-operator.rb +6 -6
  27. data/test/test-procedure.rb +15 -0
  28. data/test/test-table-dumper.rb +170 -1
  29. data/test/test-thread.rb +42 -0
  30. data/test/test-windows-event-logger.rb +28 -0
  31. data/vendor/local/bin/grndb.exe +0 -0
  32. data/vendor/local/bin/groonga-benchmark.exe +0 -0
  33. data/vendor/local/bin/groonga.exe +0 -0
  34. data/vendor/local/bin/libgcc_s_sjlj-1.dll +0 -0
  35. data/vendor/local/bin/libgroonga-0.dll +0 -0
  36. data/vendor/local/bin/libmecab-1.dll +0 -0
  37. data/vendor/local/bin/libmsgpack-4.dll +0 -0
  38. data/vendor/local/bin/libmsgpackc-2.dll +0 -0
  39. data/vendor/local/bin/libonig-5.dll +0 -0
  40. data/vendor/local/bin/libstdc++-6.dll +0 -0
  41. data/vendor/local/bin/libwinpthread-1.dll +0 -0
  42. data/vendor/local/bin/lz4.exe +0 -0
  43. data/vendor/local/bin/lz4c.exe +0 -0
  44. data/vendor/local/bin/lz4cat +0 -0
  45. data/vendor/local/bin/mecab-config +2 -2
  46. data/vendor/local/bin/mecab.exe +0 -0
  47. data/vendor/local/bin/onig-config +1 -1
  48. data/vendor/local/bin/zlib1.dll +0 -0
  49. data/vendor/local/etc/groonga/httpd/groonga-httpd.conf +2 -2
  50. data/vendor/local/etc/groonga/windows_event_log/provider.man +38 -0
  51. data/vendor/local/include/groonga/groonga.h +2 -0
  52. data/vendor/local/include/groonga/groonga/command.h +2 -0
  53. data/vendor/local/include/groonga/groonga/groonga.h +5 -0
  54. data/vendor/local/include/groonga/groonga/obj.h +1 -0
  55. data/vendor/local/include/groonga/groonga/portability.h +16 -0
  56. data/vendor/local/include/groonga/groonga/thread.h +42 -0
  57. data/vendor/local/include/groonga/groonga/windows_event_logger.h +33 -0
  58. data/vendor/local/lib/groonga/plugins/functions/vector.a +0 -0
  59. data/vendor/local/lib/groonga/plugins/functions/vector.dll +0 -0
  60. data/vendor/local/lib/groonga/plugins/functions/vector.dll.a +0 -0
  61. data/vendor/local/lib/groonga/plugins/functions/vector.la +2 -2
  62. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.a +0 -0
  63. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll +0 -0
  64. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll.a +0 -0
  65. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.la +2 -2
  66. data/vendor/local/lib/groonga/plugins/ruby/eval.a +0 -0
  67. data/vendor/local/lib/groonga/plugins/ruby/eval.dll +0 -0
  68. data/vendor/local/lib/groonga/plugins/ruby/eval.dll.a +0 -0
  69. data/vendor/local/lib/groonga/plugins/ruby/eval.la +2 -2
  70. data/vendor/local/lib/groonga/plugins/ruby/load.a +0 -0
  71. data/vendor/local/lib/groonga/plugins/ruby/load.dll +0 -0
  72. data/vendor/local/lib/groonga/plugins/ruby/load.dll.a +0 -0
  73. data/vendor/local/lib/groonga/plugins/ruby/load.la +2 -2
  74. data/vendor/local/lib/groonga/plugins/sharding.rb +5 -0
  75. data/vendor/local/lib/groonga/plugins/sharding/logical_count.rb +43 -6
  76. data/vendor/local/lib/groonga/plugins/sharding/logical_enumerator.rb +32 -25
  77. data/vendor/local/lib/groonga/plugins/sharding/logical_parameters.rb +44 -0
  78. data/vendor/local/lib/groonga/plugins/sharding/logical_range_filter.rb +217 -49
  79. data/vendor/local/lib/groonga/plugins/sharding/logical_select.rb +507 -45
  80. data/vendor/local/lib/groonga/plugins/sharding/logical_shard_list.rb +28 -0
  81. data/vendor/local/lib/groonga/plugins/sharding/logical_table_remove.rb +11 -6
  82. data/vendor/local/lib/groonga/plugins/sharding/parameters.rb +10 -0
  83. data/vendor/local/lib/groonga/plugins/suggest/suggest.a +0 -0
  84. data/vendor/local/lib/groonga/plugins/suggest/suggest.dll +0 -0
  85. data/vendor/local/lib/groonga/plugins/suggest/suggest.dll.a +0 -0
  86. data/vendor/local/lib/groonga/plugins/suggest/suggest.la +2 -2
  87. data/vendor/local/lib/groonga/plugins/table/table.a +0 -0
  88. data/vendor/local/lib/groonga/plugins/table/table.dll +0 -0
  89. data/vendor/local/lib/groonga/plugins/table/table.dll.a +0 -0
  90. data/vendor/local/lib/groonga/plugins/table/table.la +2 -2
  91. data/vendor/local/lib/groonga/plugins/token_filters/stop_word.a +0 -0
  92. data/vendor/local/lib/groonga/plugins/token_filters/stop_word.dll +0 -0
  93. data/vendor/local/lib/groonga/plugins/token_filters/stop_word.dll.a +0 -0
  94. data/vendor/local/lib/groonga/plugins/token_filters/stop_word.la +2 -2
  95. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.a +0 -0
  96. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll +0 -0
  97. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll.a +0 -0
  98. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.la +2 -2
  99. data/vendor/local/lib/groonga/scripts/ruby/command.rb +31 -1
  100. data/vendor/local/lib/groonga/scripts/ruby/context.rb +18 -2
  101. data/vendor/local/lib/groonga/scripts/ruby/database.rb +12 -4
  102. data/vendor/local/lib/groonga/scripts/ruby/expression_size_estimator.rb +31 -28
  103. data/vendor/local/lib/groonga/scripts/ruby/initialize/post.rb +1 -0
  104. data/vendor/local/lib/groonga/scripts/ruby/logger/level.rb +4 -2
  105. data/vendor/local/lib/groonga/scripts/ruby/query_logger.rb +9 -0
  106. data/vendor/local/lib/groonga/scripts/ruby/query_logger/flag.rb +39 -0
  107. data/vendor/local/lib/groonga/scripts/ruby/record.rb +12 -0
  108. data/vendor/local/lib/groonga/scripts/ruby/table.rb +35 -1
  109. data/vendor/local/lib/libgroonga.a +0 -0
  110. data/vendor/local/lib/libgroonga.dll.a +0 -0
  111. data/vendor/local/lib/libgroonga.la +2 -2
  112. data/vendor/local/lib/liblz4.dll +0 -0
  113. data/vendor/local/lib/liblz4.dll.1 +0 -0
  114. data/vendor/local/lib/liblz4.dll.1.5.0 +0 -0
  115. data/vendor/local/lib/libmecab.a +0 -0
  116. data/vendor/local/lib/libmecab.dll.a +0 -0
  117. data/vendor/local/lib/libmecab.la +2 -2
  118. data/vendor/local/lib/libmsgpack.a +0 -0
  119. data/vendor/local/lib/libmsgpack.dll.a +0 -0
  120. data/vendor/local/lib/libmsgpack.la +2 -2
  121. data/vendor/local/lib/libmsgpackc.a +0 -0
  122. data/vendor/local/lib/libmsgpackc.dll.a +0 -0
  123. data/vendor/local/lib/libmsgpackc.la +2 -2
  124. data/vendor/local/lib/libonig.a +0 -0
  125. data/vendor/local/lib/libonig.dll.a +0 -0
  126. data/vendor/local/lib/libonig.la +2 -2
  127. data/vendor/local/lib/libz.a +0 -0
  128. data/vendor/local/lib/libz.dll.a +0 -0
  129. data/vendor/local/lib/pkgconfig/groonga.pc +3 -3
  130. data/vendor/local/lib/pkgconfig/liblz4.pc +5 -5
  131. data/vendor/local/lib/pkgconfig/msgpack.pc +1 -1
  132. data/vendor/local/lib/pkgconfig/oniguruma.pc +6 -6
  133. data/vendor/local/lib/pkgconfig/zlib.pc +3 -3
  134. data/vendor/local/libexec/mecab/mecab-cost-train.exe +0 -0
  135. data/vendor/local/libexec/mecab/mecab-dict-gen.exe +0 -0
  136. data/vendor/local/libexec/mecab/mecab-dict-index.exe +0 -0
  137. data/vendor/local/libexec/mecab/mecab-system-eval.exe +0 -0
  138. data/vendor/local/libexec/mecab/mecab-test-gen.exe +0 -0
  139. data/vendor/local/sbin/groonga-httpd-restart +1 -1
  140. data/vendor/local/sbin/groonga-httpd.exe +0 -0
  141. data/vendor/local/share/doc/groonga/en/html/.buildinfo +1 -1
  142. data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development.txt +3 -2
  143. data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/build.txt +19 -0
  144. data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/build/unix_autotools.txt +101 -0
  145. data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/build/unix_cmake.txt +94 -0
  146. data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/build/windows_cmake.txt +93 -0
  147. data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/release.txt +16 -7
  148. data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/repository.txt +7 -3
  149. data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/test.txt +4 -0
  150. data/vendor/local/share/doc/groonga/en/html/_sources/install/centos.txt +3 -3
  151. data/vendor/local/share/doc/groonga/en/html/_sources/install/debian.txt +4 -4
  152. data/vendor/local/share/doc/groonga/en/html/_sources/install/fedora.txt +3 -3
  153. data/vendor/local/share/doc/groonga/en/html/_sources/install/mac_os_x.txt +3 -3
  154. data/vendor/local/share/doc/groonga/en/html/_sources/install/others.txt +4 -4
  155. data/vendor/local/share/doc/groonga/en/html/_sources/install/solaris.txt +3 -3
  156. data/vendor/local/share/doc/groonga/en/html/_sources/install/ubuntu.txt +3 -4
  157. data/vendor/local/share/doc/groonga/en/html/_sources/install/windows.txt +9 -9
  158. data/vendor/local/share/doc/groonga/en/html/_sources/news.txt +319 -0
  159. data/vendor/local/share/doc/groonga/en/html/_sources/reference.txt +1 -0
  160. data/vendor/local/share/doc/groonga/en/html/_sources/reference/api/grn_ctx.txt +1 -1
  161. data/vendor/local/share/doc/groonga/en/html/_sources/reference/api/grn_db.txt +23 -0
  162. data/vendor/local/share/doc/groonga/en/html/_sources/reference/api/grn_thread.txt +122 -0
  163. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/cache_limit.txt +1 -1
  164. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/column_copy.txt +381 -0
  165. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/column_list.txt +1 -1
  166. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/column_rename.txt +3 -1
  167. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/database_unmap.txt +85 -0
  168. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/io_flush.txt +218 -9
  169. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/lock_clear.txt +1 -3
  170. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/log_level.txt +1 -1
  171. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_count.txt +3 -1
  172. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_parameters.txt +138 -0
  173. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_range_filter.txt +97 -10
  174. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_select.txt +745 -23
  175. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_shard_list.txt +107 -0
  176. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_table_remove.txt +3 -1
  177. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/normalize.txt +2 -3
  178. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/normalizer_list.txt +1 -2
  179. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/object_exist.txt +90 -0
  180. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/plugin_register.txt +1 -1
  181. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/plugin_unregister.txt +1 -1
  182. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/register.txt +1 -1
  183. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/request_cancel.txt +1 -3
  184. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/ruby_eval.txt +1 -1
  185. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/ruby_load.txt +1 -1
  186. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/select.txt +240 -56
  187. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_create.txt +33 -7
  188. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_rename.txt +90 -0
  189. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_tokenize.txt +2 -1
  190. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/thread_limit.txt +110 -0
  191. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/tokenize.txt +2 -1
  192. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/tokenizer_list.txt +1 -3
  193. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/truncate.txt +1 -3
  194. data/vendor/local/share/doc/groonga/en/html/_sources/reference/executables/groonga-httpd.txt +3 -4
  195. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/highlight_full.txt +0 -1
  196. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/highlight_html.txt +0 -1
  197. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/query.txt +2 -2
  198. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/snippet_html.txt +1 -1
  199. data/vendor/local/share/doc/groonga/en/html/_sources/reference/grn_expr/query_syntax.txt +1 -1
  200. data/vendor/local/share/doc/groonga/en/html/_sources/reference/grn_expr/script_syntax.txt +34 -14
  201. data/vendor/local/share/doc/groonga/en/html/_sources/reference/indexing.txt +2 -2
  202. data/vendor/local/share/doc/groonga/en/html/_sources/reference/query_expanders/tsv.txt +1 -1
  203. data/vendor/local/share/doc/groonga/en/html/_sources/reference/regular_expression.txt +3 -0
  204. data/vendor/local/share/doc/groonga/en/html/_sources/reference/scoring_note.txt +2 -0
  205. data/vendor/local/share/doc/groonga/en/html/_sources/reference/sharding.txt +108 -0
  206. data/vendor/local/share/doc/groonga/en/html/_sources/reference/tokenizers.txt +0 -21
  207. data/vendor/local/share/doc/groonga/en/html/_sources/reference/tuning.txt +1 -1
  208. data/vendor/local/share/doc/groonga/en/html/_sources/spec/search.txt +1 -1
  209. data/vendor/local/share/doc/groonga/en/html/_sources/troubleshooting/different_results_with_the_same_keyword.txt +4 -4
  210. data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/introduction.txt +24 -18
  211. data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/match_columns.txt +19 -19
  212. data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/micro_blog.txt +9 -9
  213. data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/query_expansion.txt +1 -1
  214. data/vendor/local/share/doc/groonga/en/html/_static/basic.css +68 -6
  215. data/vendor/local/share/doc/groonga/en/html/_static/doctools.js +27 -2
  216. data/vendor/local/share/doc/groonga/en/html/_static/down-pressed.png +0 -0
  217. data/vendor/local/share/doc/groonga/en/html/_static/down.png +0 -0
  218. data/vendor/local/share/doc/groonga/en/html/_static/file.png +0 -0
  219. data/vendor/local/share/doc/groonga/en/html/_static/jquery-1.11.1.js +10308 -0
  220. data/vendor/local/share/doc/groonga/en/html/_static/jquery.js +4 -9404
  221. data/vendor/local/share/doc/groonga/en/html/_static/minus.png +0 -0
  222. data/vendor/local/share/doc/groonga/en/html/_static/plus.png +0 -0
  223. data/vendor/local/share/doc/groonga/en/html/_static/searchtools.js +2 -2
  224. data/vendor/local/share/doc/groonga/en/html/_static/underscore-1.3.1.js +999 -0
  225. data/vendor/local/share/doc/groonga/en/html/_static/underscore.js +31 -1415
  226. data/vendor/local/share/doc/groonga/en/html/_static/up-pressed.png +0 -0
  227. data/vendor/local/share/doc/groonga/en/html/_static/up.png +0 -0
  228. data/vendor/local/share/doc/groonga/en/html/_static/websupport.js +15 -15
  229. data/vendor/local/share/doc/groonga/en/html/characteristic.html +19 -17
  230. data/vendor/local/share/doc/groonga/en/html/client.html +19 -17
  231. data/vendor/local/share/doc/groonga/en/html/community.html +19 -17
  232. data/vendor/local/share/doc/groonga/en/html/contribution.html +78 -70
  233. data/vendor/local/share/doc/groonga/en/html/contribution/development.html +30 -27
  234. data/vendor/local/share/doc/groonga/en/html/contribution/development/build.html +146 -0
  235. data/vendor/local/share/doc/groonga/en/html/contribution/development/build/unix_autotools.html +237 -0
  236. data/vendor/local/share/doc/groonga/en/html/contribution/development/build/unix_cmake.html +227 -0
  237. data/vendor/local/share/doc/groonga/en/html/contribution/development/build/windows_cmake.html +231 -0
  238. data/vendor/local/share/doc/groonga/en/html/contribution/development/com.html +37 -35
  239. data/vendor/local/share/doc/groonga/en/html/contribution/development/cooperation.html +54 -52
  240. data/vendor/local/share/doc/groonga/en/html/contribution/development/query.html +80 -78
  241. data/vendor/local/share/doc/groonga/en/html/contribution/development/release.html +135 -122
  242. data/vendor/local/share/doc/groonga/en/html/contribution/development/repository.html +38 -34
  243. data/vendor/local/share/doc/groonga/en/html/contribution/development/test.html +58 -54
  244. data/vendor/local/share/doc/groonga/en/html/contribution/documentation.html +21 -19
  245. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/c-api.html +27 -25
  246. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/i18n.html +23 -21
  247. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/introduction.html +30 -28
  248. data/vendor/local/share/doc/groonga/en/html/contribution/report.html +21 -19
  249. data/vendor/local/share/doc/groonga/en/html/development.html +19 -17
  250. data/vendor/local/share/doc/groonga/en/html/development/travis-ci.html +30 -28
  251. data/vendor/local/share/doc/groonga/en/html/genindex.html +48 -20
  252. data/vendor/local/share/doc/groonga/en/html/index.html +123 -105
  253. data/vendor/local/share/doc/groonga/en/html/install.html +33 -31
  254. data/vendor/local/share/doc/groonga/en/html/install/centos.html +32 -30
  255. data/vendor/local/share/doc/groonga/en/html/install/debian.html +31 -29
  256. data/vendor/local/share/doc/groonga/en/html/install/fedora.html +29 -27
  257. data/vendor/local/share/doc/groonga/en/html/install/mac_os_x.html +26 -24
  258. data/vendor/local/share/doc/groonga/en/html/install/others.html +92 -90
  259. data/vendor/local/share/doc/groonga/en/html/install/solaris.html +26 -24
  260. data/vendor/local/share/doc/groonga/en/html/install/ubuntu.html +29 -28
  261. data/vendor/local/share/doc/groonga/en/html/install/windows.html +34 -32
  262. data/vendor/local/share/doc/groonga/en/html/limitations.html +19 -17
  263. data/vendor/local/share/doc/groonga/en/html/news.html +509 -142
  264. data/vendor/local/share/doc/groonga/en/html/news/0.x.html +19 -17
  265. data/vendor/local/share/doc/groonga/en/html/news/1.0.x.html +20 -18
  266. data/vendor/local/share/doc/groonga/en/html/news/1.1.x.html +19 -17
  267. data/vendor/local/share/doc/groonga/en/html/news/1.2.x.html +34 -32
  268. data/vendor/local/share/doc/groonga/en/html/news/1.3.x.html +29 -27
  269. data/vendor/local/share/doc/groonga/en/html/news/2.x.html +110 -108
  270. data/vendor/local/share/doc/groonga/en/html/news/3.x.html +73 -71
  271. data/vendor/local/share/doc/groonga/en/html/news/4.x.html +111 -109
  272. data/vendor/local/share/doc/groonga/en/html/news/senna.html +19 -17
  273. data/vendor/local/share/doc/groonga/en/html/objects.inv +0 -0
  274. data/vendor/local/share/doc/groonga/en/html/reference.html +111 -94
  275. data/vendor/local/share/doc/groonga/en/html/reference/api.html +55 -52
  276. data/vendor/local/share/doc/groonga/en/html/reference/api/global_configurations.html +51 -49
  277. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_cache.html +63 -61
  278. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_column.html +84 -82
  279. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_command_version.html +46 -44
  280. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_content_type.html +41 -39
  281. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ctx.html +89 -87
  282. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_db.html +88 -50
  283. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_encoding.html +48 -46
  284. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_expr.html +83 -81
  285. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_geo.html +46 -44
  286. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_hook.html +48 -46
  287. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ii.html +46 -44
  288. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_index_cursor.html +45 -43
  289. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_info.html +45 -43
  290. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_match_escalation.html +44 -42
  291. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_obj.html +93 -91
  292. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_proc.html +48 -46
  293. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_search.html +43 -41
  294. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table.html +79 -77
  295. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table_cursor.html +69 -67
  296. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_thread.html +296 -0
  297. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_type.html +45 -43
  298. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_user_data.html +38 -36
  299. data/vendor/local/share/doc/groonga/en/html/reference/api/overview.html +51 -49
  300. data/vendor/local/share/doc/groonga/en/html/reference/api/plugin.html +60 -58
  301. data/vendor/local/share/doc/groonga/en/html/reference/cast.html +19 -17
  302. data/vendor/local/share/doc/groonga/en/html/reference/column.html +21 -19
  303. data/vendor/local/share/doc/groonga/en/html/reference/columns/index.html +23 -21
  304. data/vendor/local/share/doc/groonga/en/html/reference/columns/pseudo.html +28 -26
  305. data/vendor/local/share/doc/groonga/en/html/reference/columns/scalar.html +23 -21
  306. data/vendor/local/share/doc/groonga/en/html/reference/columns/vector.html +72 -70
  307. data/vendor/local/share/doc/groonga/en/html/reference/command.html +70 -61
  308. data/vendor/local/share/doc/groonga/en/html/reference/command/command_version.html +23 -21
  309. data/vendor/local/share/doc/groonga/en/html/reference/command/output_format.html +59 -57
  310. data/vendor/local/share/doc/groonga/en/html/reference/command/request_id.html +28 -26
  311. data/vendor/local/share/doc/groonga/en/html/reference/command/return_code.html +100 -98
  312. data/vendor/local/share/doc/groonga/en/html/reference/commands/cache_limit.html +44 -42
  313. data/vendor/local/share/doc/groonga/en/html/reference/commands/check.html +49 -47
  314. data/vendor/local/share/doc/groonga/en/html/reference/commands/clearlock.html +33 -31
  315. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_copy.html +796 -0
  316. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_create.html +62 -60
  317. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_list.html +96 -94
  318. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_remove.html +46 -44
  319. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_rename.html +67 -64
  320. data/vendor/local/share/doc/groonga/en/html/reference/commands/database_unmap.html +236 -0
  321. data/vendor/local/share/doc/groonga/en/html/reference/commands/define_selector.html +62 -60
  322. data/vendor/local/share/doc/groonga/en/html/reference/commands/defrag.html +46 -44
  323. data/vendor/local/share/doc/groonga/en/html/reference/commands/delete.html +59 -57
  324. data/vendor/local/share/doc/groonga/en/html/reference/commands/dump.html +63 -61
  325. data/vendor/local/share/doc/groonga/en/html/reference/commands/io_flush.html +281 -54
  326. data/vendor/local/share/doc/groonga/en/html/reference/commands/load.html +66 -64
  327. data/vendor/local/share/doc/groonga/en/html/reference/commands/lock_clear.html +53 -52
  328. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_level.html +48 -46
  329. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_put.html +48 -46
  330. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_reopen.html +48 -46
  331. data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_count.html +78 -75
  332. data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_parameters.html +283 -0
  333. data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_range_filter.html +160 -85
  334. data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_select.html +2071 -83
  335. data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_shard_list.html +287 -0
  336. data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_table_remove.html +71 -68
  337. data/vendor/local/share/doc/groonga/en/html/reference/commands/normalize.html +86 -84
  338. data/vendor/local/share/doc/groonga/en/html/reference/commands/normalizer_list.html +52 -50
  339. data/vendor/local/share/doc/groonga/en/html/reference/commands/object_exist.html +227 -0
  340. data/vendor/local/share/doc/groonga/en/html/reference/commands/plugin_register.html +57 -55
  341. data/vendor/local/share/doc/groonga/en/html/reference/commands/plugin_unregister.html +53 -51
  342. data/vendor/local/share/doc/groonga/en/html/reference/commands/quit.html +43 -41
  343. data/vendor/local/share/doc/groonga/en/html/reference/commands/range_filter.html +43 -41
  344. data/vendor/local/share/doc/groonga/en/html/reference/commands/register.html +56 -54
  345. data/vendor/local/share/doc/groonga/en/html/reference/commands/request_cancel.html +75 -74
  346. data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_eval.html +59 -57
  347. data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_load.html +59 -57
  348. data/vendor/local/share/doc/groonga/en/html/reference/commands/select.html +898 -647
  349. data/vendor/local/share/doc/groonga/en/html/reference/commands/shutdown.html +43 -41
  350. data/vendor/local/share/doc/groonga/en/html/reference/commands/status.html +50 -48
  351. data/vendor/local/share/doc/groonga/en/html/reference/commands/suggest.html +87 -85
  352. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_create.html +175 -152
  353. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_list.html +55 -53
  354. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_remove.html +46 -44
  355. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_rename.html +327 -0
  356. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_tokenize.html +77 -75
  357. data/vendor/local/share/doc/groonga/en/html/reference/commands/thread_limit.html +241 -0
  358. data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenize.html +108 -106
  359. data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenizer_list.html +56 -51
  360. data/vendor/local/share/doc/groonga/en/html/reference/commands/truncate.html +56 -55
  361. data/vendor/local/share/doc/groonga/en/html/reference/executables.html +24 -22
  362. data/vendor/local/share/doc/groonga/en/html/reference/executables/grndb.html +41 -39
  363. data/vendor/local/share/doc/groonga/en/html/reference/executables/grnslap.html +28 -26
  364. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-benchmark.html +33 -31
  365. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-httpd.html +83 -81
  366. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-server-http.html +29 -27
  367. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-create-dataset.html +23 -21
  368. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-httpd.html +48 -46
  369. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-learner.html +40 -38
  370. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga.html +84 -82
  371. data/vendor/local/share/doc/groonga/en/html/reference/function.html +22 -20
  372. data/vendor/local/share/doc/groonga/en/html/reference/functions/between.html +47 -45
  373. data/vendor/local/share/doc/groonga/en/html/reference/functions/edit_distance.html +25 -23
  374. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_distance.html +85 -83
  375. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_circle.html +36 -34
  376. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_rectangle.html +26 -24
  377. data/vendor/local/share/doc/groonga/en/html/reference/functions/highlight_full.html +66 -64
  378. data/vendor/local/share/doc/groonga/en/html/reference/functions/highlight_html.html +54 -52
  379. data/vendor/local/share/doc/groonga/en/html/reference/functions/html_untag.html +35 -33
  380. data/vendor/local/share/doc/groonga/en/html/reference/functions/in_values.html +34 -32
  381. data/vendor/local/share/doc/groonga/en/html/reference/functions/now.html +23 -21
  382. data/vendor/local/share/doc/groonga/en/html/reference/functions/query.html +55 -53
  383. data/vendor/local/share/doc/groonga/en/html/reference/functions/rand.html +24 -22
  384. data/vendor/local/share/doc/groonga/en/html/reference/functions/snippet_html.html +49 -47
  385. data/vendor/local/share/doc/groonga/en/html/reference/functions/sub_filter.html +45 -43
  386. data/vendor/local/share/doc/groonga/en/html/reference/functions/vector_size.html +33 -31
  387. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr.html +29 -27
  388. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/query_syntax.html +244 -242
  389. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/script_syntax.html +327 -325
  390. data/vendor/local/share/doc/groonga/en/html/reference/indexing.html +35 -29
  391. data/vendor/local/share/doc/groonga/en/html/reference/log.html +43 -41
  392. data/vendor/local/share/doc/groonga/en/html/reference/normalizers.html +49 -47
  393. data/vendor/local/share/doc/groonga/en/html/reference/operations.html +21 -19
  394. data/vendor/local/share/doc/groonga/en/html/reference/operations/geolocation_search.html +23 -21
  395. data/vendor/local/share/doc/groonga/en/html/reference/output.html +36 -34
  396. data/vendor/local/share/doc/groonga/en/html/reference/query_expanders.html +21 -19
  397. data/vendor/local/share/doc/groonga/en/html/reference/query_expanders/tsv.html +62 -60
  398. data/vendor/local/share/doc/groonga/en/html/reference/regular_expression.html +107 -103
  399. data/vendor/local/share/doc/groonga/en/html/reference/scorer.html +50 -40
  400. data/vendor/local/share/doc/groonga/en/html/reference/scorers/scorer_tf_at_most.html +27 -25
  401. data/vendor/local/share/doc/groonga/en/html/reference/scorers/scorer_tf_idf.html +41 -31
  402. data/vendor/local/share/doc/groonga/en/html/reference/scoring_note.html +19 -17
  403. data/vendor/local/share/doc/groonga/en/html/reference/sharding.html +241 -0
  404. data/vendor/local/share/doc/groonga/en/html/reference/suggest.html +21 -19
  405. data/vendor/local/share/doc/groonga/en/html/reference/suggest/completion.html +30 -28
  406. data/vendor/local/share/doc/groonga/en/html/reference/suggest/correction.html +23 -21
  407. data/vendor/local/share/doc/groonga/en/html/reference/suggest/introduction.html +23 -21
  408. data/vendor/local/share/doc/groonga/en/html/reference/suggest/suggestion.html +23 -21
  409. data/vendor/local/share/doc/groonga/en/html/reference/tables.html +56 -54
  410. data/vendor/local/share/doc/groonga/en/html/reference/token_filters.html +41 -39
  411. data/vendor/local/share/doc/groonga/en/html/reference/tokenizers.html +341 -289
  412. data/vendor/local/share/doc/groonga/en/html/reference/tuning.html +68 -66
  413. data/vendor/local/share/doc/groonga/en/html/reference/types.html +43 -41
  414. data/vendor/local/share/doc/groonga/en/html/search.html +11 -11
  415. data/vendor/local/share/doc/groonga/en/html/searchindex.js +1 -1
  416. data/vendor/local/share/doc/groonga/en/html/server.html +19 -17
  417. data/vendor/local/share/doc/groonga/en/html/server/gqtp.html +22 -20
  418. data/vendor/local/share/doc/groonga/en/html/server/http.html +21 -19
  419. data/vendor/local/share/doc/groonga/en/html/server/http/comparison.html +37 -35
  420. data/vendor/local/share/doc/groonga/en/html/server/http/groonga-httpd.html +23 -21
  421. data/vendor/local/share/doc/groonga/en/html/server/http/groonga.html +23 -21
  422. data/vendor/local/share/doc/groonga/en/html/server/memcached.html +21 -19
  423. data/vendor/local/share/doc/groonga/en/html/server/package.html +39 -37
  424. data/vendor/local/share/doc/groonga/en/html/spec.html +23 -21
  425. data/vendor/local/share/doc/groonga/en/html/spec/gqtp.html +129 -127
  426. data/vendor/local/share/doc/groonga/en/html/spec/search.html +22 -20
  427. data/vendor/local/share/doc/groonga/en/html/troubleshooting.html +19 -17
  428. data/vendor/local/share/doc/groonga/en/html/troubleshooting/different_results_with_the_same_keyword.html +25 -23
  429. data/vendor/local/share/doc/groonga/en/html/troubleshooting/mmap_cannot_allocate_memory.html +22 -20
  430. data/vendor/local/share/doc/groonga/en/html/tutorial.html +20 -18
  431. data/vendor/local/share/doc/groonga/en/html/tutorial/data.html +29 -23
  432. data/vendor/local/share/doc/groonga/en/html/tutorial/drilldown.html +35 -33
  433. data/vendor/local/share/doc/groonga/en/html/tutorial/index.html +25 -23
  434. data/vendor/local/share/doc/groonga/en/html/tutorial/introduction.html +46 -39
  435. data/vendor/local/share/doc/groonga/en/html/tutorial/lexicon.html +21 -19
  436. data/vendor/local/share/doc/groonga/en/html/tutorial/match_columns.html +65 -63
  437. data/vendor/local/share/doc/groonga/en/html/tutorial/micro_blog.html +55 -53
  438. data/vendor/local/share/doc/groonga/en/html/tutorial/network.html +25 -23
  439. data/vendor/local/share/doc/groonga/en/html/tutorial/patricia_trie.html +22 -20
  440. data/vendor/local/share/doc/groonga/en/html/tutorial/query_expansion.html +25 -23
  441. data/vendor/local/share/doc/groonga/en/html/tutorial/search.html +37 -35
  442. data/vendor/local/share/doc/groonga/ja/html/.buildinfo +1 -1
  443. data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development.txt +3 -2
  444. data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/build.txt +19 -0
  445. data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/build/unix_autotools.txt +101 -0
  446. data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/build/unix_cmake.txt +94 -0
  447. data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/build/windows_cmake.txt +93 -0
  448. data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/release.txt +16 -7
  449. data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/repository.txt +7 -3
  450. data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/test.txt +4 -0
  451. data/vendor/local/share/doc/groonga/ja/html/_sources/install/centos.txt +3 -3
  452. data/vendor/local/share/doc/groonga/ja/html/_sources/install/debian.txt +4 -4
  453. data/vendor/local/share/doc/groonga/ja/html/_sources/install/fedora.txt +3 -3
  454. data/vendor/local/share/doc/groonga/ja/html/_sources/install/mac_os_x.txt +3 -3
  455. data/vendor/local/share/doc/groonga/ja/html/_sources/install/others.txt +4 -4
  456. data/vendor/local/share/doc/groonga/ja/html/_sources/install/solaris.txt +3 -3
  457. data/vendor/local/share/doc/groonga/ja/html/_sources/install/ubuntu.txt +3 -4
  458. data/vendor/local/share/doc/groonga/ja/html/_sources/install/windows.txt +9 -9
  459. data/vendor/local/share/doc/groonga/ja/html/_sources/news.txt +319 -0
  460. data/vendor/local/share/doc/groonga/ja/html/_sources/reference.txt +1 -0
  461. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/grn_ctx.txt +1 -1
  462. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/grn_db.txt +23 -0
  463. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/grn_thread.txt +122 -0
  464. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/cache_limit.txt +1 -1
  465. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/column_copy.txt +381 -0
  466. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/column_list.txt +1 -1
  467. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/column_rename.txt +3 -1
  468. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/database_unmap.txt +85 -0
  469. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/io_flush.txt +218 -9
  470. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/lock_clear.txt +1 -3
  471. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/log_level.txt +1 -1
  472. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_count.txt +3 -1
  473. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_parameters.txt +138 -0
  474. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_range_filter.txt +97 -10
  475. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_select.txt +745 -23
  476. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_shard_list.txt +107 -0
  477. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_table_remove.txt +3 -1
  478. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/normalize.txt +2 -3
  479. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/normalizer_list.txt +1 -2
  480. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/object_exist.txt +90 -0
  481. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/plugin_register.txt +1 -1
  482. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/plugin_unregister.txt +1 -1
  483. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/register.txt +1 -1
  484. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/request_cancel.txt +1 -3
  485. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/ruby_eval.txt +1 -1
  486. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/ruby_load.txt +1 -1
  487. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/select.txt +240 -56
  488. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_create.txt +33 -7
  489. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_rename.txt +90 -0
  490. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_tokenize.txt +2 -1
  491. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/thread_limit.txt +110 -0
  492. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/tokenize.txt +2 -1
  493. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/tokenizer_list.txt +1 -3
  494. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/truncate.txt +1 -3
  495. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/groonga-httpd.txt +3 -4
  496. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/highlight_full.txt +0 -1
  497. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/highlight_html.txt +0 -1
  498. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/query.txt +2 -2
  499. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/snippet_html.txt +1 -1
  500. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/grn_expr/query_syntax.txt +1 -1
  501. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/grn_expr/script_syntax.txt +34 -14
  502. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/indexing.txt +2 -2
  503. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/query_expanders/tsv.txt +1 -1
  504. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/regular_expression.txt +3 -0
  505. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/scoring_note.txt +2 -0
  506. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/sharding.txt +108 -0
  507. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/tokenizers.txt +0 -21
  508. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/tuning.txt +1 -1
  509. data/vendor/local/share/doc/groonga/ja/html/_sources/spec/search.txt +1 -1
  510. data/vendor/local/share/doc/groonga/ja/html/_sources/troubleshooting/different_results_with_the_same_keyword.txt +4 -4
  511. data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/introduction.txt +24 -18
  512. data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/match_columns.txt +19 -19
  513. data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/micro_blog.txt +9 -9
  514. data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/query_expansion.txt +1 -1
  515. data/vendor/local/share/doc/groonga/ja/html/_static/basic.css +68 -6
  516. data/vendor/local/share/doc/groonga/ja/html/_static/doctools.js +27 -2
  517. data/vendor/local/share/doc/groonga/ja/html/_static/down-pressed.png +0 -0
  518. data/vendor/local/share/doc/groonga/ja/html/_static/down.png +0 -0
  519. data/vendor/local/share/doc/groonga/ja/html/_static/file.png +0 -0
  520. data/vendor/local/share/doc/groonga/ja/html/_static/jquery-1.11.1.js +10308 -0
  521. data/vendor/local/share/doc/groonga/ja/html/_static/jquery.js +4 -9404
  522. data/vendor/local/share/doc/groonga/ja/html/_static/minus.png +0 -0
  523. data/vendor/local/share/doc/groonga/ja/html/_static/plus.png +0 -0
  524. data/vendor/local/share/doc/groonga/ja/html/_static/searchtools.js +2 -2
  525. data/vendor/local/share/doc/groonga/ja/html/_static/underscore-1.3.1.js +999 -0
  526. data/vendor/local/share/doc/groonga/ja/html/_static/underscore.js +31 -1415
  527. data/vendor/local/share/doc/groonga/ja/html/_static/up-pressed.png +0 -0
  528. data/vendor/local/share/doc/groonga/ja/html/_static/up.png +0 -0
  529. data/vendor/local/share/doc/groonga/ja/html/_static/websupport.js +15 -15
  530. data/vendor/local/share/doc/groonga/ja/html/characteristic.html +19 -17
  531. data/vendor/local/share/doc/groonga/ja/html/client.html +19 -17
  532. data/vendor/local/share/doc/groonga/ja/html/community.html +19 -17
  533. data/vendor/local/share/doc/groonga/ja/html/contribution.html +77 -69
  534. data/vendor/local/share/doc/groonga/ja/html/contribution/development.html +30 -27
  535. data/vendor/local/share/doc/groonga/ja/html/contribution/development/build.html +144 -0
  536. data/vendor/local/share/doc/groonga/ja/html/contribution/development/build/unix_autotools.html +226 -0
  537. data/vendor/local/share/doc/groonga/ja/html/contribution/development/build/unix_cmake.html +215 -0
  538. data/vendor/local/share/doc/groonga/ja/html/contribution/development/build/windows_cmake.html +229 -0
  539. data/vendor/local/share/doc/groonga/ja/html/contribution/development/com.html +36 -34
  540. data/vendor/local/share/doc/groonga/ja/html/contribution/development/cooperation.html +53 -51
  541. data/vendor/local/share/doc/groonga/ja/html/contribution/development/query.html +79 -77
  542. data/vendor/local/share/doc/groonga/ja/html/contribution/development/release.html +134 -121
  543. data/vendor/local/share/doc/groonga/ja/html/contribution/development/repository.html +29 -27
  544. data/vendor/local/share/doc/groonga/ja/html/contribution/development/test.html +57 -53
  545. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation.html +21 -19
  546. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/c-api.html +23 -21
  547. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/i18n.html +23 -21
  548. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/introduction.html +30 -28
  549. data/vendor/local/share/doc/groonga/ja/html/contribution/report.html +21 -19
  550. data/vendor/local/share/doc/groonga/ja/html/development.html +19 -17
  551. data/vendor/local/share/doc/groonga/ja/html/development/travis-ci.html +25 -23
  552. data/vendor/local/share/doc/groonga/ja/html/genindex.html +48 -20
  553. data/vendor/local/share/doc/groonga/ja/html/index.html +122 -104
  554. data/vendor/local/share/doc/groonga/ja/html/install.html +33 -31
  555. data/vendor/local/share/doc/groonga/ja/html/install/centos.html +35 -33
  556. data/vendor/local/share/doc/groonga/ja/html/install/debian.html +33 -31
  557. data/vendor/local/share/doc/groonga/ja/html/install/fedora.html +30 -28
  558. data/vendor/local/share/doc/groonga/ja/html/install/mac_os_x.html +26 -24
  559. data/vendor/local/share/doc/groonga/ja/html/install/others.html +83 -81
  560. data/vendor/local/share/doc/groonga/ja/html/install/solaris.html +25 -23
  561. data/vendor/local/share/doc/groonga/ja/html/install/ubuntu.html +30 -29
  562. data/vendor/local/share/doc/groonga/ja/html/install/windows.html +33 -31
  563. data/vendor/local/share/doc/groonga/ja/html/limitations.html +19 -17
  564. data/vendor/local/share/doc/groonga/ja/html/news.html +460 -126
  565. data/vendor/local/share/doc/groonga/ja/html/news/0.x.html +19 -17
  566. data/vendor/local/share/doc/groonga/ja/html/news/1.0.x.html +20 -18
  567. data/vendor/local/share/doc/groonga/ja/html/news/1.1.x.html +19 -17
  568. data/vendor/local/share/doc/groonga/ja/html/news/1.2.x.html +34 -32
  569. data/vendor/local/share/doc/groonga/ja/html/news/1.3.x.html +29 -27
  570. data/vendor/local/share/doc/groonga/ja/html/news/2.x.html +102 -100
  571. data/vendor/local/share/doc/groonga/ja/html/news/3.x.html +66 -64
  572. data/vendor/local/share/doc/groonga/ja/html/news/4.x.html +91 -89
  573. data/vendor/local/share/doc/groonga/ja/html/news/senna.html +19 -17
  574. data/vendor/local/share/doc/groonga/ja/html/objects.inv +0 -0
  575. data/vendor/local/share/doc/groonga/ja/html/reference.html +111 -94
  576. data/vendor/local/share/doc/groonga/ja/html/reference/api.html +55 -52
  577. data/vendor/local/share/doc/groonga/ja/html/reference/api/global_configurations.html +51 -49
  578. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_cache.html +58 -56
  579. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_column.html +84 -82
  580. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_command_version.html +46 -44
  581. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_content_type.html +41 -39
  582. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ctx.html +85 -83
  583. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_db.html +88 -50
  584. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_encoding.html +48 -46
  585. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_expr.html +78 -76
  586. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_geo.html +46 -44
  587. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_hook.html +48 -46
  588. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ii.html +46 -44
  589. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_index_cursor.html +45 -43
  590. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_info.html +45 -43
  591. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_match_escalation.html +44 -42
  592. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_obj.html +93 -91
  593. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_proc.html +48 -46
  594. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_search.html +43 -41
  595. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table.html +79 -77
  596. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table_cursor.html +69 -67
  597. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_thread.html +286 -0
  598. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_type.html +45 -43
  599. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_user_data.html +38 -36
  600. data/vendor/local/share/doc/groonga/ja/html/reference/api/overview.html +48 -46
  601. data/vendor/local/share/doc/groonga/ja/html/reference/api/plugin.html +60 -58
  602. data/vendor/local/share/doc/groonga/ja/html/reference/cast.html +19 -17
  603. data/vendor/local/share/doc/groonga/ja/html/reference/column.html +21 -19
  604. data/vendor/local/share/doc/groonga/ja/html/reference/columns/index.html +23 -21
  605. data/vendor/local/share/doc/groonga/ja/html/reference/columns/pseudo.html +28 -26
  606. data/vendor/local/share/doc/groonga/ja/html/reference/columns/scalar.html +23 -21
  607. data/vendor/local/share/doc/groonga/ja/html/reference/columns/vector.html +61 -59
  608. data/vendor/local/share/doc/groonga/ja/html/reference/command.html +70 -61
  609. data/vendor/local/share/doc/groonga/ja/html/reference/command/command_version.html +23 -21
  610. data/vendor/local/share/doc/groonga/ja/html/reference/command/output_format.html +49 -47
  611. data/vendor/local/share/doc/groonga/ja/html/reference/command/request_id.html +28 -26
  612. data/vendor/local/share/doc/groonga/ja/html/reference/command/return_code.html +99 -97
  613. data/vendor/local/share/doc/groonga/ja/html/reference/commands/cache_limit.html +41 -39
  614. data/vendor/local/share/doc/groonga/ja/html/reference/commands/check.html +49 -47
  615. data/vendor/local/share/doc/groonga/ja/html/reference/commands/clearlock.html +33 -31
  616. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_copy.html +781 -0
  617. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_create.html +62 -60
  618. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_list.html +88 -86
  619. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_remove.html +46 -44
  620. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_rename.html +66 -63
  621. data/vendor/local/share/doc/groonga/ja/html/reference/commands/database_unmap.html +229 -0
  622. data/vendor/local/share/doc/groonga/ja/html/reference/commands/define_selector.html +62 -60
  623. data/vendor/local/share/doc/groonga/ja/html/reference/commands/defrag.html +46 -44
  624. data/vendor/local/share/doc/groonga/ja/html/reference/commands/delete.html +58 -56
  625. data/vendor/local/share/doc/groonga/ja/html/reference/commands/dump.html +63 -61
  626. data/vendor/local/share/doc/groonga/ja/html/reference/commands/io_flush.html +266 -54
  627. data/vendor/local/share/doc/groonga/ja/html/reference/commands/load.html +59 -57
  628. data/vendor/local/share/doc/groonga/ja/html/reference/commands/lock_clear.html +53 -52
  629. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_level.html +48 -46
  630. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_put.html +48 -46
  631. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_reopen.html +48 -46
  632. data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_count.html +78 -75
  633. data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_parameters.html +276 -0
  634. data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_range_filter.html +158 -85
  635. data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_select.html +2008 -80
  636. data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_shard_list.html +285 -0
  637. data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_table_remove.html +71 -68
  638. data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalize.html +82 -79
  639. data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalizer_list.html +52 -50
  640. data/vendor/local/share/doc/groonga/ja/html/reference/commands/object_exist.html +220 -0
  641. data/vendor/local/share/doc/groonga/ja/html/reference/commands/plugin_register.html +53 -51
  642. data/vendor/local/share/doc/groonga/ja/html/reference/commands/plugin_unregister.html +51 -49
  643. data/vendor/local/share/doc/groonga/ja/html/reference/commands/quit.html +43 -41
  644. data/vendor/local/share/doc/groonga/ja/html/reference/commands/range_filter.html +43 -41
  645. data/vendor/local/share/doc/groonga/ja/html/reference/commands/register.html +52 -50
  646. data/vendor/local/share/doc/groonga/ja/html/reference/commands/request_cancel.html +68 -67
  647. data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_eval.html +59 -57
  648. data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_load.html +59 -57
  649. data/vendor/local/share/doc/groonga/ja/html/reference/commands/select.html +680 -448
  650. data/vendor/local/share/doc/groonga/ja/html/reference/commands/shutdown.html +43 -41
  651. data/vendor/local/share/doc/groonga/ja/html/reference/commands/status.html +48 -46
  652. data/vendor/local/share/doc/groonga/ja/html/reference/commands/suggest.html +84 -82
  653. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_create.html +146 -126
  654. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_list.html +55 -53
  655. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_remove.html +46 -44
  656. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_rename.html +322 -0
  657. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_tokenize.html +73 -70
  658. data/vendor/local/share/doc/groonga/ja/html/reference/commands/thread_limit.html +229 -0
  659. data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenize.html +94 -91
  660. data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenizer_list.html +56 -51
  661. data/vendor/local/share/doc/groonga/ja/html/reference/commands/truncate.html +56 -55
  662. data/vendor/local/share/doc/groonga/ja/html/reference/executables.html +24 -22
  663. data/vendor/local/share/doc/groonga/ja/html/reference/executables/grndb.html +39 -37
  664. data/vendor/local/share/doc/groonga/ja/html/reference/executables/grnslap.html +28 -26
  665. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-benchmark.html +33 -31
  666. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-httpd.html +73 -72
  667. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-server-http.html +29 -27
  668. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-create-dataset.html +23 -21
  669. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-httpd.html +48 -46
  670. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-learner.html +40 -38
  671. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga.html +84 -82
  672. data/vendor/local/share/doc/groonga/ja/html/reference/function.html +22 -20
  673. data/vendor/local/share/doc/groonga/ja/html/reference/functions/between.html +46 -44
  674. data/vendor/local/share/doc/groonga/ja/html/reference/functions/edit_distance.html +25 -23
  675. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_distance.html +69 -67
  676. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_circle.html +36 -34
  677. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_rectangle.html +26 -24
  678. data/vendor/local/share/doc/groonga/ja/html/reference/functions/highlight_full.html +56 -54
  679. data/vendor/local/share/doc/groonga/ja/html/reference/functions/highlight_html.html +45 -43
  680. data/vendor/local/share/doc/groonga/ja/html/reference/functions/html_untag.html +34 -32
  681. data/vendor/local/share/doc/groonga/ja/html/reference/functions/in_values.html +35 -33
  682. data/vendor/local/share/doc/groonga/ja/html/reference/functions/now.html +23 -21
  683. data/vendor/local/share/doc/groonga/ja/html/reference/functions/query.html +48 -46
  684. data/vendor/local/share/doc/groonga/ja/html/reference/functions/rand.html +24 -22
  685. data/vendor/local/share/doc/groonga/ja/html/reference/functions/snippet_html.html +35 -33
  686. data/vendor/local/share/doc/groonga/ja/html/reference/functions/sub_filter.html +37 -35
  687. data/vendor/local/share/doc/groonga/ja/html/reference/functions/vector_size.html +33 -31
  688. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr.html +26 -24
  689. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/query_syntax.html +143 -141
  690. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/script_syntax.html +236 -234
  691. data/vendor/local/share/doc/groonga/ja/html/reference/indexing.html +34 -28
  692. data/vendor/local/share/doc/groonga/ja/html/reference/log.html +43 -41
  693. data/vendor/local/share/doc/groonga/ja/html/reference/normalizers.html +39 -37
  694. data/vendor/local/share/doc/groonga/ja/html/reference/operations.html +21 -19
  695. data/vendor/local/share/doc/groonga/ja/html/reference/operations/geolocation_search.html +23 -21
  696. data/vendor/local/share/doc/groonga/ja/html/reference/output.html +32 -30
  697. data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders.html +21 -19
  698. data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders/tsv.html +42 -39
  699. data/vendor/local/share/doc/groonga/ja/html/reference/regular_expression.html +91 -88
  700. data/vendor/local/share/doc/groonga/ja/html/reference/scorer.html +50 -40
  701. data/vendor/local/share/doc/groonga/ja/html/reference/scorers/scorer_tf_at_most.html +27 -25
  702. data/vendor/local/share/doc/groonga/ja/html/reference/scorers/scorer_tf_idf.html +41 -31
  703. data/vendor/local/share/doc/groonga/ja/html/reference/scoring_note.html +19 -17
  704. data/vendor/local/share/doc/groonga/ja/html/reference/sharding.html +223 -0
  705. data/vendor/local/share/doc/groonga/ja/html/reference/suggest.html +21 -19
  706. data/vendor/local/share/doc/groonga/ja/html/reference/suggest/completion.html +27 -25
  707. data/vendor/local/share/doc/groonga/ja/html/reference/suggest/correction.html +23 -21
  708. data/vendor/local/share/doc/groonga/ja/html/reference/suggest/introduction.html +23 -21
  709. data/vendor/local/share/doc/groonga/ja/html/reference/suggest/suggestion.html +23 -21
  710. data/vendor/local/share/doc/groonga/ja/html/reference/tables.html +46 -44
  711. data/vendor/local/share/doc/groonga/ja/html/reference/token_filters.html +38 -36
  712. data/vendor/local/share/doc/groonga/ja/html/reference/tokenizers.html +303 -243
  713. data/vendor/local/share/doc/groonga/ja/html/reference/tuning.html +62 -60
  714. data/vendor/local/share/doc/groonga/ja/html/reference/types.html +42 -40
  715. data/vendor/local/share/doc/groonga/ja/html/search.html +11 -11
  716. data/vendor/local/share/doc/groonga/ja/html/searchindex.js +1 -1
  717. data/vendor/local/share/doc/groonga/ja/html/server.html +19 -17
  718. data/vendor/local/share/doc/groonga/ja/html/server/gqtp.html +21 -19
  719. data/vendor/local/share/doc/groonga/ja/html/server/http.html +21 -19
  720. data/vendor/local/share/doc/groonga/ja/html/server/http/comparison.html +31 -29
  721. data/vendor/local/share/doc/groonga/ja/html/server/http/groonga-httpd.html +23 -21
  722. data/vendor/local/share/doc/groonga/ja/html/server/http/groonga.html +23 -21
  723. data/vendor/local/share/doc/groonga/ja/html/server/memcached.html +21 -19
  724. data/vendor/local/share/doc/groonga/ja/html/server/package.html +38 -36
  725. data/vendor/local/share/doc/groonga/ja/html/spec.html +23 -21
  726. data/vendor/local/share/doc/groonga/ja/html/spec/gqtp.html +128 -126
  727. data/vendor/local/share/doc/groonga/ja/html/spec/search.html +22 -20
  728. data/vendor/local/share/doc/groonga/ja/html/troubleshooting.html +19 -17
  729. data/vendor/local/share/doc/groonga/ja/html/troubleshooting/different_results_with_the_same_keyword.html +25 -23
  730. data/vendor/local/share/doc/groonga/ja/html/troubleshooting/mmap_cannot_allocate_memory.html +22 -20
  731. data/vendor/local/share/doc/groonga/ja/html/tutorial.html +20 -18
  732. data/vendor/local/share/doc/groonga/ja/html/tutorial/data.html +29 -23
  733. data/vendor/local/share/doc/groonga/ja/html/tutorial/drilldown.html +34 -32
  734. data/vendor/local/share/doc/groonga/ja/html/tutorial/index.html +22 -20
  735. data/vendor/local/share/doc/groonga/ja/html/tutorial/introduction.html +46 -39
  736. data/vendor/local/share/doc/groonga/ja/html/tutorial/lexicon.html +21 -19
  737. data/vendor/local/share/doc/groonga/ja/html/tutorial/match_columns.html +66 -64
  738. data/vendor/local/share/doc/groonga/ja/html/tutorial/micro_blog.html +52 -50
  739. data/vendor/local/share/doc/groonga/ja/html/tutorial/network.html +25 -23
  740. data/vendor/local/share/doc/groonga/ja/html/tutorial/patricia_trie.html +22 -20
  741. data/vendor/local/share/doc/groonga/ja/html/tutorial/query_expansion.html +25 -23
  742. data/vendor/local/share/doc/groonga/ja/html/tutorial/search.html +35 -33
  743. data/vendor/local/share/license/groonga/README.md +6 -0
  744. data/vendor/local/share/license/mruby/AUTHORS +1 -0
  745. data/vendor/local/share/license/mruby/MITL +1 -1
  746. data/vendor/local/share/license/mruby/README.md +6 -5
  747. data/vendor/local/share/license/msgpack/README +219 -0
  748. data/vendor/local/share/man/ja/man1/groonga.1 +23512 -15126
  749. data/vendor/local/share/man/man1/groonga.1 +26542 -17745
  750. metadata +77 -3
  751. data/vendor/local/share/license/msgpack/AUTHORS +0 -0
@@ -7,7 +7,7 @@
7
7
  <head>
8
8
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
9
9
 
10
- <title>7.3.35. ruby_load &mdash; Groonga v5.0.4-139-g6629adb documentation</title>
10
+ <title>7.3.40. ruby_load &mdash; Groonga v5.0.6-226-gd7da7e7 documentation</title>
11
11
 
12
12
  <link rel="stylesheet" href="../../_static/groonga.css" type="text/css" />
13
13
  <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
15
15
  <script type="text/javascript">
16
16
  var DOCUMENTATION_OPTIONS = {
17
17
  URL_ROOT: '../../',
18
- VERSION: '5.0.4-139-g6629adb',
18
+ VERSION: '5.0.6-226-gd7da7e7',
19
19
  COLLAPSE_INDEX: false,
20
20
  FILE_SUFFIX: '.html',
21
21
  HAS_SOURCE: true
@@ -25,12 +25,12 @@
25
25
  <script type="text/javascript" src="../../_static/underscore.js"></script>
26
26
  <script type="text/javascript" src="../../_static/doctools.js"></script>
27
27
  <link rel="shortcut icon" href="../../_static/favicon.ico"/>
28
- <link rel="top" title="Groonga v5.0.4-139-g6629adb documentation" href="../../index.html" />
28
+ <link rel="top" title="Groonga v5.0.6-226-gd7da7e7 documentation" href="../../index.html" />
29
29
  <link rel="up" title="7.3. Command" href="../command.html" />
30
- <link rel="next" title="7.3.36. select" href="select.html" />
31
- <link rel="prev" title="7.3.34. ruby_eval" href="ruby_eval.html" />
30
+ <link rel="next" title="7.3.41. select" href="select.html" />
31
+ <link rel="prev" title="7.3.39. ruby_eval" href="ruby_eval.html" />
32
32
  </head>
33
- <body>
33
+ <body role="document">
34
34
  <div class="header">
35
35
  <h1 class="title">
36
36
  <a id="top-link" href="../../index.html">
@@ -48,46 +48,46 @@
48
48
  </div>
49
49
 
50
50
 
51
- <div class="related">
51
+ <div class="related" role="navigation" aria-label="related navigation">
52
52
  <h3>Navigation</h3>
53
53
  <ul>
54
54
  <li class="right" style="margin-right: 10px">
55
55
  <a href="../../genindex.html" title="General Index"
56
56
  accesskey="I">index</a></li>
57
57
  <li class="right" >
58
- <a href="select.html" title="7.3.36. select"
58
+ <a href="select.html" title="7.3.41. select"
59
59
  accesskey="N">next</a> |</li>
60
60
  <li class="right" >
61
- <a href="ruby_eval.html" title="7.3.34. ruby_eval"
61
+ <a href="ruby_eval.html" title="7.3.39. ruby_eval"
62
62
  accesskey="P">previous</a> |</li>
63
- <li><a href="../../index.html">Groonga v5.0.4-139-g6629adb documentation</a> &raquo;</li>
64
- <li><a href="../../reference.html" >7. Reference manual</a> &raquo;</li>
65
- <li><a href="../command.html" accesskey="U">7.3. Command</a> &raquo;</li>
63
+ <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.6-226-gd7da7e7 documentation</a> &raquo;</li>
64
+ <li class="nav-item nav-item-1"><a href="../../reference.html" >7. Reference manual</a> &raquo;</li>
65
+ <li class="nav-item nav-item-2"><a href="../command.html" accesskey="U">7.3. Command</a> &raquo;</li>
66
66
  </ul>
67
67
  </div>
68
68
 
69
69
  <div class="document">
70
70
  <div class="documentwrapper">
71
71
  <div class="bodywrapper">
72
- <div class="body">
72
+ <div class="body" role="main">
73
73
 
74
74
  <div class="section" id="ruby-load">
75
- <h1>7.3.35. <tt class="docutils literal"><span class="pre">ruby_load</span></tt><a class="headerlink" href="#ruby-load" title="Permalink to this headline">¶</a></h1>
75
+ <h1>7.3.40. <code class="docutils literal"><span class="pre">ruby_load</span></code><a class="headerlink" href="#ruby-load" title="Permalink to this headline">¶</a></h1>
76
76
  <div class="section" id="summary">
77
- <h2>7.3.35.1. Summary<a class="headerlink" href="#summary" title="Permalink to this headline">¶</a></h2>
78
- <p><tt class="docutils literal"><span class="pre">ruby_load</span></tt> command loads specified Ruby script.</p>
77
+ <h2>7.3.40.1. Summary<a class="headerlink" href="#summary" title="Permalink to this headline">¶</a></h2>
78
+ <p><code class="docutils literal"><span class="pre">ruby_load</span></code> command loads specified Ruby script.</p>
79
79
  </div>
80
80
  <div class="section" id="syntax">
81
- <h2>7.3.35.2. Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
82
- <p><tt class="docutils literal"><span class="pre">ruby_load</span></tt> has one required parameter:</p>
81
+ <h2>7.3.40.2. Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
82
+ <p>This command takes only one required parameter:</p>
83
83
  <div class="highlight-none"><div class="highlight"><pre>ruby_load path
84
84
  </pre></div>
85
85
  </div>
86
86
  </div>
87
87
  <div class="section" id="usage">
88
- <h2>7.3.35.3. Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
89
- <p>You can load any script file which mruby supports by calling <tt class="docutils literal"><span class="pre">ruby_load</span></tt>.</p>
90
- <p>Here is an example that just load <tt class="docutils literal"><span class="pre">expression.rb</span></tt> as Ruby script.</p>
88
+ <h2>7.3.40.3. Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
89
+ <p>You can load any script file which mruby supports by calling <code class="docutils literal"><span class="pre">ruby_load</span></code>.</p>
90
+ <p>Here is an example that just load <code class="docutils literal"><span class="pre">expression.rb</span></code> as Ruby script.</p>
91
91
  <p>Execution example:</p>
92
92
  <div class="highlight-none"><div class="highlight"><pre>register ruby/load
93
93
  # [[0, 1337566253.89858, 0.000355720520019531], true]
@@ -95,36 +95,36 @@ ruby_load &quot;expression.rb&quot;
95
95
  # [[0, 1337566253.89858, 0.000355720520019531], {&quot;value&quot;: null}]
96
96
  </pre></div>
97
97
  </div>
98
- <p>Register <tt class="docutils literal"><span class="pre">ruby/load</span></tt> plugin to use <tt class="docutils literal"><span class="pre">ruby_load</span></tt> command in advance.</p>
99
- <p>Note that <tt class="docutils literal"><span class="pre">ruby_load</span></tt> is implemented as an experimental plugin,
98
+ <p>Register <code class="docutils literal"><span class="pre">ruby/load</span></code> plugin to use <code class="docutils literal"><span class="pre">ruby_load</span></code> command in advance.</p>
99
+ <p>Note that <code class="docutils literal"><span class="pre">ruby_load</span></code> is implemented as an experimental plugin,
100
100
  and the specification may be changed in the future.</p>
101
101
  </div>
102
102
  <div class="section" id="parameters">
103
- <h2>7.3.35.4. Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h2>
103
+ <h2>7.3.40.4. Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h2>
104
104
  <p>This section describes all parameters.</p>
105
105
  <div class="section" id="path">
106
- <h3>7.3.35.4.1. <tt class="docutils literal"><span class="pre">path</span></tt><a class="headerlink" href="#path" title="Permalink to this headline">¶</a></h3>
106
+ <h3>7.3.40.4.1. <code class="docutils literal"><span class="pre">path</span></code><a class="headerlink" href="#path" title="Permalink to this headline">¶</a></h3>
107
107
  <p>Specifies the Ruby script path which you want to load.</p>
108
108
  </div>
109
109
  </div>
110
110
  <div class="section" id="return-value">
111
- <h2>7.3.35.5. Return value<a class="headerlink" href="#return-value" title="Permalink to this headline">¶</a></h2>
112
- <p><tt class="docutils literal"><span class="pre">ruby_load</span></tt> returns the loaded result with metadata such as
111
+ <h2>7.3.40.5. Return value<a class="headerlink" href="#return-value" title="Permalink to this headline">¶</a></h2>
112
+ <p><code class="docutils literal"><span class="pre">ruby_load</span></code> returns the loaded result with metadata such as
113
113
  exception information (Including metadata isn't implemented yet):</p>
114
114
  <div class="highlight-none"><div class="highlight"><pre>[HEADER, {&quot;value&quot;: LOADED_VALUE}]
115
115
  </pre></div>
116
116
  </div>
117
- <p><tt class="docutils literal"><span class="pre">HEADER</span></tt></p>
117
+ <p><code class="docutils literal"><span class="pre">HEADER</span></code></p>
118
118
  <blockquote>
119
- <div>See <a class="reference internal" href="../command/output_format.html"><em>Output format</em></a> about <tt class="docutils literal"><span class="pre">HEADER</span></tt>.</div></blockquote>
120
- <p><tt class="docutils literal"><span class="pre">LOADED_VALUE</span></tt></p>
119
+ <div>See <a class="reference internal" href="../command/output_format.html"><em>Output format</em></a> about <code class="docutils literal"><span class="pre">HEADER</span></code>.</div></blockquote>
120
+ <p><code class="docutils literal"><span class="pre">LOADED_VALUE</span></code></p>
121
121
  <blockquote>
122
- <div><p><tt class="docutils literal"><span class="pre">LOADED_VALUE</span></tt> is the loaded value of ruby script.</p>
123
- <p><tt class="docutils literal"><span class="pre">ruby_load</span></tt> just return <tt class="docutils literal"><span class="pre">null</span></tt> as <tt class="docutils literal"><span class="pre">LOADED_VALUE</span></tt> for now, it will be supported in the future.</p>
122
+ <div><p><code class="docutils literal"><span class="pre">LOADED_VALUE</span></code> is the loaded value of ruby script.</p>
123
+ <p><code class="docutils literal"><span class="pre">ruby_load</span></code> just return <code class="docutils literal"><span class="pre">null</span></code> as <code class="docutils literal"><span class="pre">LOADED_VALUE</span></code> for now, it will be supported in the future.</p>
124
124
  </div></blockquote>
125
125
  </div>
126
126
  <div class="section" id="see-also">
127
- <h2>7.3.35.6. See also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
127
+ <h2>7.3.40.6. See also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
128
128
  <p><a class="reference internal" href="ruby_eval.html"><em>ruby_eval</em></a></p>
129
129
  </div>
130
130
  </div>
@@ -133,36 +133,38 @@ exception information (Including metadata isn't implemented yet):</p>
133
133
  </div>
134
134
  </div>
135
135
  </div>
136
- <div class="sphinxsidebar">
136
+ <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
137
137
  <div class="sphinxsidebarwrapper">
138
138
  <h3><a href="../../index.html">Table Of Contents</a></h3>
139
139
  <ul>
140
- <li><a class="reference internal" href="#">7.3.35. <tt class="docutils literal"><span class="pre">ruby_load</span></tt></a><ul>
141
- <li><a class="reference internal" href="#summary">7.3.35.1. Summary</a></li>
142
- <li><a class="reference internal" href="#syntax">7.3.35.2. Syntax</a></li>
143
- <li><a class="reference internal" href="#usage">7.3.35.3. Usage</a></li>
144
- <li><a class="reference internal" href="#parameters">7.3.35.4. Parameters</a><ul>
145
- <li><a class="reference internal" href="#path">7.3.35.4.1. <tt class="docutils literal"><span class="pre">path</span></tt></a></li>
140
+ <li><a class="reference internal" href="#">7.3.40. <code class="docutils literal"><span class="pre">ruby_load</span></code></a><ul>
141
+ <li><a class="reference internal" href="#summary">7.3.40.1. Summary</a></li>
142
+ <li><a class="reference internal" href="#syntax">7.3.40.2. Syntax</a></li>
143
+ <li><a class="reference internal" href="#usage">7.3.40.3. Usage</a></li>
144
+ <li><a class="reference internal" href="#parameters">7.3.40.4. Parameters</a><ul>
145
+ <li><a class="reference internal" href="#path">7.3.40.4.1. <code class="docutils literal"><span class="pre">path</span></code></a></li>
146
146
  </ul>
147
147
  </li>
148
- <li><a class="reference internal" href="#return-value">7.3.35.5. Return value</a></li>
149
- <li><a class="reference internal" href="#see-also">7.3.35.6. See also</a></li>
148
+ <li><a class="reference internal" href="#return-value">7.3.40.5. Return value</a></li>
149
+ <li><a class="reference internal" href="#see-also">7.3.40.6. See also</a></li>
150
150
  </ul>
151
151
  </li>
152
152
  </ul>
153
153
 
154
154
  <h4>Previous topic</h4>
155
155
  <p class="topless"><a href="ruby_eval.html"
156
- title="previous chapter">7.3.34. <tt class="docutils literal"><span class="pre">ruby_eval</span></tt></a></p>
156
+ title="previous chapter">7.3.39. <code class="docutils literal"><span class="pre">ruby_eval</span></code></a></p>
157
157
  <h4>Next topic</h4>
158
158
  <p class="topless"><a href="select.html"
159
- title="next chapter">7.3.36. <tt class="docutils literal"><span class="pre">select</span></tt></a></p>
160
- <h3>This Page</h3>
161
- <ul class="this-page-menu">
162
- <li><a href="../../_sources/reference/commands/ruby_load.txt"
163
- rel="nofollow">Show Source</a></li>
164
- </ul>
165
- <div id="searchbox" style="display: none">
159
+ title="next chapter">7.3.41. <code class="docutils literal"><span class="pre">select</span></code></a></p>
160
+ <div role="note" aria-label="source link">
161
+ <h3>This Page</h3>
162
+ <ul class="this-page-menu">
163
+ <li><a href="../../_sources/reference/commands/ruby_load.txt"
164
+ rel="nofollow">Show Source</a></li>
165
+ </ul>
166
+ </div>
167
+ <div id="searchbox" style="display: none" role="search">
166
168
  <h3>Quick search</h3>
167
169
  <form class="search" action="../../search.html" method="get">
168
170
  <input type="text" name="q" />
@@ -179,24 +181,24 @@ exception information (Including metadata isn't implemented yet):</p>
179
181
  </div>
180
182
  <div class="clearer"></div>
181
183
  </div>
182
- <div class="related">
184
+ <div class="related" role="navigation" aria-label="related navigation">
183
185
  <h3>Navigation</h3>
184
186
  <ul>
185
187
  <li class="right" style="margin-right: 10px">
186
188
  <a href="../../genindex.html" title="General Index"
187
189
  >index</a></li>
188
190
  <li class="right" >
189
- <a href="select.html" title="7.3.36. select"
191
+ <a href="select.html" title="7.3.41. select"
190
192
  >next</a> |</li>
191
193
  <li class="right" >
192
- <a href="ruby_eval.html" title="7.3.34. ruby_eval"
194
+ <a href="ruby_eval.html" title="7.3.39. ruby_eval"
193
195
  >previous</a> |</li>
194
- <li><a href="../../index.html">Groonga v5.0.4-139-g6629adb documentation</a> &raquo;</li>
195
- <li><a href="../../reference.html" >7. Reference manual</a> &raquo;</li>
196
- <li><a href="../command.html" >7.3. Command</a> &raquo;</li>
196
+ <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.6-226-gd7da7e7 documentation</a> &raquo;</li>
197
+ <li class="nav-item nav-item-1"><a href="../../reference.html" >7. Reference manual</a> &raquo;</li>
198
+ <li class="nav-item nav-item-2"><a href="../command.html" >7.3. Command</a> &raquo;</li>
197
199
  </ul>
198
200
  </div>
199
- <div class="footer">
201
+ <div class="footer" role="contentinfo">
200
202
  &copy; Copyright 2009-2015, Brazil, Inc.
201
203
  </div>
202
204
  </body>
@@ -7,7 +7,7 @@
7
7
  <head>
8
8
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
9
9
 
10
- <title>7.3.36. select &mdash; Groonga v5.0.4-139-g6629adb documentation</title>
10
+ <title>7.3.41. select &mdash; Groonga v5.0.6-226-gd7da7e7 documentation</title>
11
11
 
12
12
  <link rel="stylesheet" href="../../_static/groonga.css" type="text/css" />
13
13
  <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
15
15
  <script type="text/javascript">
16
16
  var DOCUMENTATION_OPTIONS = {
17
17
  URL_ROOT: '../../',
18
- VERSION: '5.0.4-139-g6629adb',
18
+ VERSION: '5.0.6-226-gd7da7e7',
19
19
  COLLAPSE_INDEX: false,
20
20
  FILE_SUFFIX: '.html',
21
21
  HAS_SOURCE: true
@@ -25,12 +25,12 @@
25
25
  <script type="text/javascript" src="../../_static/underscore.js"></script>
26
26
  <script type="text/javascript" src="../../_static/doctools.js"></script>
27
27
  <link rel="shortcut icon" href="../../_static/favicon.ico"/>
28
- <link rel="top" title="Groonga v5.0.4-139-g6629adb documentation" href="../../index.html" />
28
+ <link rel="top" title="Groonga v5.0.6-226-gd7da7e7 documentation" href="../../index.html" />
29
29
  <link rel="up" title="7.3. Command" href="../command.html" />
30
- <link rel="next" title="7.3.37. shutdown" href="shutdown.html" />
31
- <link rel="prev" title="7.3.35. ruby_load" href="ruby_load.html" />
30
+ <link rel="next" title="7.3.42. shutdown" href="shutdown.html" />
31
+ <link rel="prev" title="7.3.40. ruby_load" href="ruby_load.html" />
32
32
  </head>
33
- <body>
33
+ <body role="document">
34
34
  <div class="header">
35
35
  <h1 class="title">
36
36
  <a id="top-link" href="../../index.html">
@@ -48,42 +48,43 @@
48
48
  </div>
49
49
 
50
50
 
51
- <div class="related">
51
+ <div class="related" role="navigation" aria-label="related navigation">
52
52
  <h3>Navigation</h3>
53
53
  <ul>
54
54
  <li class="right" style="margin-right: 10px">
55
55
  <a href="../../genindex.html" title="General Index"
56
56
  accesskey="I">index</a></li>
57
57
  <li class="right" >
58
- <a href="shutdown.html" title="7.3.37. shutdown"
58
+ <a href="shutdown.html" title="7.3.42. shutdown"
59
59
  accesskey="N">next</a> |</li>
60
60
  <li class="right" >
61
- <a href="ruby_load.html" title="7.3.35. ruby_load"
61
+ <a href="ruby_load.html" title="7.3.40. ruby_load"
62
62
  accesskey="P">previous</a> |</li>
63
- <li><a href="../../index.html">Groonga v5.0.4-139-g6629adb documentation</a> &raquo;</li>
64
- <li><a href="../../reference.html" >7. Reference manual</a> &raquo;</li>
65
- <li><a href="../command.html" accesskey="U">7.3. Command</a> &raquo;</li>
63
+ <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.6-226-gd7da7e7 documentation</a> &raquo;</li>
64
+ <li class="nav-item nav-item-1"><a href="../../reference.html" >7. Reference manual</a> &raquo;</li>
65
+ <li class="nav-item nav-item-2"><a href="../command.html" accesskey="U">7.3. Command</a> &raquo;</li>
66
66
  </ul>
67
67
  </div>
68
68
 
69
69
  <div class="document">
70
70
  <div class="documentwrapper">
71
71
  <div class="bodywrapper">
72
- <div class="body">
72
+ <div class="body" role="main">
73
73
 
74
74
  <div class="section" id="select">
75
- <h1>7.3.36. <tt class="docutils literal"><span class="pre">select</span></tt><a class="headerlink" href="#select" title="Permalink to this headline">¶</a></h1>
75
+ <h1>7.3.41. <code class="docutils literal"><span class="pre">select</span></code><a class="headerlink" href="#select" title="Permalink to this headline">¶</a></h1>
76
76
  <div class="section" id="summary">
77
- <h2>7.3.36.1. Summary<a class="headerlink" href="#summary" title="Permalink to this headline">¶</a></h2>
78
- <p><tt class="docutils literal"><span class="pre">select</span></tt> searches records that are matched to specified conditions
77
+ <h2>7.3.41.1. Summary<a class="headerlink" href="#summary" title="Permalink to this headline">¶</a></h2>
78
+ <p><code class="docutils literal"><span class="pre">select</span></code> searches records that are matched to specified conditions
79
79
  from a table and then outputs them.</p>
80
- <p><tt class="docutils literal"><span class="pre">select</span></tt> is the most important command in groonga. You need to
81
- understand <tt class="docutils literal"><span class="pre">select</span></tt> to use the full power of groonga.</p>
80
+ <p><code class="docutils literal"><span class="pre">select</span></code> is the most important command in groonga. You need to
81
+ understand <code class="docutils literal"><span class="pre">select</span></code> to use the full power of Groonga.</p>
82
82
  </div>
83
83
  <div class="section" id="syntax">
84
- <h2>7.3.36.2. Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
85
- <p><tt class="docutils literal"><span class="pre">select</span></tt> has many parameters. The required parameter is only
86
- <tt class="docutils literal"><span class="pre">table</span></tt> and others are optional:</p>
84
+ <h2>7.3.41.2. Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
85
+ <p>This command takes many parameters.</p>
86
+ <p>The required parameter is only <code class="docutils literal"><span class="pre">table</span></code>. Other parameters are
87
+ optional:</p>
87
88
  <div class="highlight-none"><div class="highlight"><pre>select table
88
89
  [match_columns=null]
89
90
  [query=null]
@@ -108,41 +109,41 @@ understand <tt class="docutils literal"><span class="pre">select</span></tt> to
108
109
  [drilldown_calc_target=null]
109
110
  </pre></div>
110
111
  </div>
111
- <p><tt class="docutils literal"><span class="pre">select</span></tt> has the following named parameters for advanced drilldown:</p>
112
+ <p><code class="docutils literal"><span class="pre">select</span></code> has the following named parameters for advanced drilldown:</p>
112
113
  <blockquote>
113
114
  <div><ul class="simple">
114
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].keys=null</span></tt></li>
115
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].sortby=null</span></tt></li>
116
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns=&quot;_key,</span> <span class="pre">_nsubrecs&quot;</span></tt></li>
117
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].offset=0</span></tt></li>
118
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].limit=10</span></tt></li>
119
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_types=NONE</span></tt></li>
120
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_target=null</span></tt></li>
115
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys=null</span></code></li>
116
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].sortby=null</span></code></li>
117
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns=&quot;_key,</span> <span class="pre">_nsubrecs&quot;</span></code></li>
118
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].offset=0</span></code></li>
119
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].limit=10</span></code></li>
120
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_types=NONE</span></code></li>
121
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_target=null</span></code></li>
121
122
  </ul>
122
123
  </div></blockquote>
123
- <p>You can use one or more alphabets, digits, <tt class="docutils literal"><span class="pre">_</span></tt> and <tt class="docutils literal"><span class="pre">.</span></tt> for
124
- <tt class="docutils literal"><span class="pre">${LABEL}</span></tt>. For example, <tt class="docutils literal"><span class="pre">parent.sub1</span></tt> is a valid <tt class="docutils literal"><span class="pre">${LABEL}</span></tt>.</p>
125
- <p>Parameters that have the same <tt class="docutils literal"><span class="pre">${LABEL}</span></tt> are grouped.</p>
124
+ <p>You can use one or more alphabets, digits, <code class="docutils literal"><span class="pre">_</span></code> and <code class="docutils literal"><span class="pre">.</span></code> for
125
+ <code class="docutils literal"><span class="pre">${LABEL}</span></code>. For example, <code class="docutils literal"><span class="pre">parent.sub1</span></code> is a valid <code class="docutils literal"><span class="pre">${LABEL}</span></code>.</p>
126
+ <p>Parameters that have the same <code class="docutils literal"><span class="pre">${LABEL}</span></code> are grouped.</p>
126
127
  <p>For example, the following parameters specify one drilldown:</p>
127
128
  <blockquote>
128
129
  <div><ul class="simple">
129
- <li><tt class="docutils literal"><span class="pre">--drilldown[label].keys</span> <span class="pre">column</span></tt></li>
130
- <li><tt class="docutils literal"><span class="pre">--drilldown[label].sortby</span> <span class="pre">-_nsubrecs</span></tt></li>
130
+ <li><code class="docutils literal"><span class="pre">--drilldown[label].keys</span> <span class="pre">column</span></code></li>
131
+ <li><code class="docutils literal"><span class="pre">--drilldown[label].sortby</span> <span class="pre">-_nsubrecs</span></code></li>
131
132
  </ul>
132
133
  </div></blockquote>
133
134
  <p>The following parameters specify two drilldowns:</p>
134
135
  <blockquote>
135
136
  <div><ul class="simple">
136
- <li><tt class="docutils literal"><span class="pre">--drilldown[label1].keys</span> <span class="pre">column1</span></tt></li>
137
- <li><tt class="docutils literal"><span class="pre">--drilldown[label1].sortby</span> <span class="pre">-_nsubrecs</span></tt></li>
138
- <li><tt class="docutils literal"><span class="pre">--drilldown[label2].keys</span> <span class="pre">column2</span></tt></li>
139
- <li><tt class="docutils literal"><span class="pre">--drilldown[label2].sortby</span> <span class="pre">_key</span></tt></li>
137
+ <li><code class="docutils literal"><span class="pre">--drilldown[label1].keys</span> <span class="pre">column1</span></code></li>
138
+ <li><code class="docutils literal"><span class="pre">--drilldown[label1].sortby</span> <span class="pre">-_nsubrecs</span></code></li>
139
+ <li><code class="docutils literal"><span class="pre">--drilldown[label2].keys</span> <span class="pre">column2</span></code></li>
140
+ <li><code class="docutils literal"><span class="pre">--drilldown[label2].sortby</span> <span class="pre">_key</span></code></li>
140
141
  </ul>
141
142
  </div></blockquote>
142
143
  </div>
143
144
  <div class="section" id="usage">
144
- <h2>7.3.36.3. Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
145
- <p>Let's learn about <tt class="docutils literal"><span class="pre">select</span></tt> usage with examples. This section shows
145
+ <h2>7.3.41.3. Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
146
+ <p>Let's learn about <code class="docutils literal"><span class="pre">select</span></code> usage with examples. This section shows
146
147
  many popular usages.</p>
147
148
  <p>Here are a schema definition and sample data to show usage.</p>
148
149
  <p>Execution example:</p>
@@ -154,7 +155,7 @@ column_create Entries n_likes COLUMN_SCALAR UInt32
154
155
  # [[0, 1337566253.89858, 0.000355720520019531], true]
155
156
  column_create Entries tag COLUMN_SCALAR ShortText
156
157
  # [[0, 1337566253.89858, 0.000355720520019531], true]
157
- table_create Terms TABLE_PAT_KEY|KEY_NORMALIZE ShortText --default_tokenizer TokenBigram
158
+ table_create Terms TABLE_PAT_KEY ShortText --default_tokenizer TokenBigram --normalizer NormalizerAuto
158
159
  # [[0, 1337566253.89858, 0.000355720520019531], true]
159
160
  column_create Terms entries_key_index COLUMN_INDEX|WITH_POSITION Entries _key
160
161
  # [[0, 1337566253.89858, 0.000355720520019531], true]
@@ -186,19 +187,19 @@ load --table Entries
186
187
  # [[0, 1337566253.89858, 0.000355720520019531], 5]
187
188
  </pre></div>
188
189
  </div>
189
- <p>There is a table, <tt class="docutils literal"><span class="pre">Entries</span></tt>, for blog entries. An entry has title,
190
+ <p>There is a table, <code class="docutils literal"><span class="pre">Entries</span></code>, for blog entries. An entry has title,
190
191
  content, the number of likes for the entry and tag. Title is key of
191
- <tt class="docutils literal"><span class="pre">Entries</span></tt>. Content is value of <tt class="docutils literal"><span class="pre">Entries.content</span></tt> column. The
192
- number of likes is value of <tt class="docutils literal"><span class="pre">Entries.n_likes</span></tt> column. Tag is value
193
- of <tt class="docutils literal"><span class="pre">Entries.tag</span></tt> column.</p>
194
- <p><tt class="docutils literal"><span class="pre">Entries._key</span></tt> column and <tt class="docutils literal"><span class="pre">Entries.content</span></tt> column are indexed
195
- using <tt class="docutils literal"><span class="pre">TokenBigram</span></tt> tokenizer. So both <tt class="docutils literal"><span class="pre">Entries._key</span></tt> and
196
- <tt class="docutils literal"><span class="pre">Entries.content</span></tt> are fulltext search ready.</p>
192
+ <code class="docutils literal"><span class="pre">Entries</span></code>. Content is value of <code class="docutils literal"><span class="pre">Entries.content</span></code> column. The
193
+ number of likes is value of <code class="docutils literal"><span class="pre">Entries.n_likes</span></code> column. Tag is value
194
+ of <code class="docutils literal"><span class="pre">Entries.tag</span></code> column.</p>
195
+ <p><code class="docutils literal"><span class="pre">Entries._key</span></code> column and <code class="docutils literal"><span class="pre">Entries.content</span></code> column are indexed
196
+ using <code class="docutils literal"><span class="pre">TokenBigram</span></code> tokenizer. So both <code class="docutils literal"><span class="pre">Entries._key</span></code> and
197
+ <code class="docutils literal"><span class="pre">Entries.content</span></code> are fulltext search ready.</p>
197
198
  <p>OK. The schema and data for examples are ready.</p>
198
199
  <div class="section" id="simple-usage">
199
- <h3>7.3.36.3.1. Simple usage<a class="headerlink" href="#simple-usage" title="Permalink to this headline">¶</a></h3>
200
+ <span id="select-simple-usage"></span><h3>7.3.41.3.1. Simple usage<a class="headerlink" href="#simple-usage" title="Permalink to this headline">¶</a></h3>
200
201
  <p>Here is the most simple usage with the above schema and data. It outputs
201
- all records in <tt class="docutils literal"><span class="pre">Entries</span></tt> table.</p>
202
+ all records in <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
202
203
  <p>Execution example:</p>
203
204
  <div class="highlight-none"><div class="highlight"><pre>select Entries
204
205
  # [
@@ -277,29 +278,29 @@ all records in <tt class="docutils literal"><span class="pre">Entries</span></tt
277
278
  <p>Why does the command output all records? There are two reasons. The
278
279
  first reason is that the command doesn't specify any search
279
280
  conditions. No search condition means all records are matched. The
280
- second reason is that the number of all records is 5. <tt class="docutils literal"><span class="pre">select</span></tt>
281
+ second reason is that the number of all records is 5. <code class="docutils literal"><span class="pre">select</span></code>
281
282
  command outputs 10 records at a maximum by default. There are only 5
282
283
  records. It is less than 10. So the command outputs all records.</p>
283
284
  </div>
284
285
  <div class="section" id="search-conditions">
285
- <h3>7.3.36.3.2. Search conditions<a class="headerlink" href="#search-conditions" title="Permalink to this headline">¶</a></h3>
286
- <p>Search conditions are specified by <tt class="docutils literal"><span class="pre">query</span></tt> or <tt class="docutils literal"><span class="pre">filter</span></tt>. You can
287
- also specify both <tt class="docutils literal"><span class="pre">query</span></tt> and <tt class="docutils literal"><span class="pre">filter</span></tt>. It means that selected
288
- records must be matched against both <tt class="docutils literal"><span class="pre">query</span></tt> and <tt class="docutils literal"><span class="pre">filter</span></tt>.</p>
286
+ <h3>7.3.41.3.2. Search conditions<a class="headerlink" href="#search-conditions" title="Permalink to this headline">¶</a></h3>
287
+ <p>Search conditions are specified by <code class="docutils literal"><span class="pre">query</span></code> or <code class="docutils literal"><span class="pre">filter</span></code>. You can
288
+ also specify both <code class="docutils literal"><span class="pre">query</span></code> and <code class="docutils literal"><span class="pre">filter</span></code>. It means that selected
289
+ records must be matched against both <code class="docutils literal"><span class="pre">query</span></code> and <code class="docutils literal"><span class="pre">filter</span></code>.</p>
289
290
  <div class="section" id="search-condition-query">
290
- <h4>7.3.36.3.2.1. Search condition: <tt class="docutils literal"><span class="pre">query</span></tt><a class="headerlink" href="#search-condition-query" title="Permalink to this headline">¶</a></h4>
291
- <p><tt class="docutils literal"><span class="pre">query</span></tt> is designed for search box in Web page. Imagine a search box
292
- in google.com. You specify search conditions for <tt class="docutils literal"><span class="pre">query</span></tt> as space
293
- separated keywords. For example, <tt class="docutils literal"><span class="pre">search</span> <span class="pre">engine</span></tt> means a matched
294
- record should contain two words, <tt class="docutils literal"><span class="pre">search</span></tt> and <tt class="docutils literal"><span class="pre">engine</span></tt>.</p>
295
- <p>Normally, <tt class="docutils literal"><span class="pre">query</span></tt> parameter is used for specifying fulltext search
291
+ <h4>7.3.41.3.2.1. Search condition: <code class="docutils literal"><span class="pre">query</span></code><a class="headerlink" href="#search-condition-query" title="Permalink to this headline">¶</a></h4>
292
+ <p><code class="docutils literal"><span class="pre">query</span></code> is designed for search box in Web page. Imagine a search box
293
+ in google.com. You specify search conditions for <code class="docutils literal"><span class="pre">query</span></code> as space
294
+ separated keywords. For example, <code class="docutils literal"><span class="pre">search</span> <span class="pre">engine</span></code> means a matched
295
+ record should contain two words, <code class="docutils literal"><span class="pre">search</span></code> and <code class="docutils literal"><span class="pre">engine</span></code>.</p>
296
+ <p>Normally, <code class="docutils literal"><span class="pre">query</span></code> parameter is used for specifying fulltext search
296
297
  conditions. It can be used for non fulltext search conditions but
297
- <tt class="docutils literal"><span class="pre">filter</span></tt> is used for the propose.</p>
298
- <p><tt class="docutils literal"><span class="pre">query</span></tt> parameter is used with <tt class="docutils literal"><span class="pre">match_columns</span></tt> parameter when
299
- <tt class="docutils literal"><span class="pre">query</span></tt> parameter is used for specifying fulltext search
300
- conditions. <tt class="docutils literal"><span class="pre">match_columns</span></tt> specifies which columnes and indexes are
301
- matched against <tt class="docutils literal"><span class="pre">query</span></tt>.</p>
302
- <p>Here is a simple <tt class="docutils literal"><span class="pre">query</span></tt> usage example.</p>
298
+ <code class="docutils literal"><span class="pre">filter</span></code> is used for the propose.</p>
299
+ <p><code class="docutils literal"><span class="pre">query</span></code> parameter is used with <code class="docutils literal"><span class="pre">match_columns</span></code> parameter when
300
+ <code class="docutils literal"><span class="pre">query</span></code> parameter is used for specifying fulltext search
301
+ conditions. <code class="docutils literal"><span class="pre">match_columns</span></code> specifies which columnes and indexes are
302
+ matched against <code class="docutils literal"><span class="pre">query</span></code>.</p>
303
+ <p>Here is a simple <code class="docutils literal"><span class="pre">query</span></code> usage example.</p>
303
304
  <p>Execution example:</p>
304
305
  <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query fast
305
306
  # [
@@ -354,16 +355,16 @@ matched against <tt class="docutils literal"><span class="pre">query</span></tt>
354
355
  # ]
355
356
  </pre></div>
356
357
  </div>
357
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command searches records that contain a word <tt class="docutils literal"><span class="pre">fast</span></tt>
358
- in <tt class="docutils literal"><span class="pre">content</span></tt> column value from <tt class="docutils literal"><span class="pre">Entries</span></tt> table.</p>
359
- <p><tt class="docutils literal"><span class="pre">query</span></tt> has query syntax but its deatils aren't described here. See
358
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain a word <code class="docutils literal"><span class="pre">fast</span></code>
359
+ in <code class="docutils literal"><span class="pre">content</span></code> column value from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
360
+ <p><code class="docutils literal"><span class="pre">query</span></code> has query syntax but its deatils aren't described here. See
360
361
  <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a> for datails.</p>
361
362
  </div>
362
363
  <div class="section" id="search-condition-filter">
363
- <h4>7.3.36.3.2.2. Search condition: <tt class="docutils literal"><span class="pre">filter</span></tt><a class="headerlink" href="#search-condition-filter" title="Permalink to this headline">¶</a></h4>
364
- <p><tt class="docutils literal"><span class="pre">filter</span></tt> is designed for complex search conditions. You specify
365
- search conditions for <tt class="docutils literal"><span class="pre">filter</span></tt> as ECMAScript like syntax.</p>
366
- <p>Here is a simple <tt class="docutils literal"><span class="pre">filter</span></tt> usage example.</p>
364
+ <h4>7.3.41.3.2.2. Search condition: <code class="docutils literal"><span class="pre">filter</span></code><a class="headerlink" href="#search-condition-filter" title="Permalink to this headline">¶</a></h4>
365
+ <p><code class="docutils literal"><span class="pre">filter</span></code> is designed for complex search conditions. You specify
366
+ search conditions for <code class="docutils literal"><span class="pre">filter</span></code> as ECMAScript like syntax.</p>
367
+ <p>Here is a simple <code class="docutils literal"><span class="pre">filter</span></code> usage example.</p>
367
368
  <p>Execution example:</p>
368
369
  <div class="highlight-none"><div class="highlight"><pre>select Entries --filter &#39;content @ &quot;fast&quot; &amp;&amp; _key == &quot;Groonga&quot;&#39;
369
370
  # [
@@ -411,20 +412,20 @@ search conditions for <tt class="docutils literal"><span class="pre">filter</spa
411
412
  # ]
412
413
  </pre></div>
413
414
  </div>
414
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command searches records that contain a word <tt class="docutils literal"><span class="pre">fast</span></tt>
415
- in <tt class="docutils literal"><span class="pre">content</span></tt> column value and has <tt class="docutils literal"><span class="pre">Groonga</span></tt> as <tt class="docutils literal"><span class="pre">_key</span></tt> from
416
- <tt class="docutils literal"><span class="pre">Entries</span></tt> table. There are three operators in the command, <tt class="docutils literal"><span class="pre">&#64;</span></tt>,
417
- <tt class="docutils literal"><span class="pre">&amp;&amp;</span></tt> and <tt class="docutils literal"><span class="pre">==</span></tt>. <tt class="docutils literal"><span class="pre">&#64;</span></tt> is fulltext search operator. <tt class="docutils literal"><span class="pre">&amp;&amp;</span></tt> and
418
- <tt class="docutils literal"><span class="pre">==</span></tt> are the same as ECMAScript. <tt class="docutils literal"><span class="pre">&amp;&amp;</span></tt> is logical AND operator and
419
- <tt class="docutils literal"><span class="pre">==</span></tt> is equality operator.</p>
420
- <p><tt class="docutils literal"><span class="pre">filter</span></tt> has more operators and syntax like grouping by <tt class="docutils literal"><span class="pre">(...)</span></tt>
415
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain a word <code class="docutils literal"><span class="pre">fast</span></code>
416
+ in <code class="docutils literal"><span class="pre">content</span></code> column value and has <code class="docutils literal"><span class="pre">Groonga</span></code> as <code class="docutils literal"><span class="pre">_key</span></code> from
417
+ <code class="docutils literal"><span class="pre">Entries</span></code> table. There are three operators in the command, <code class="docutils literal"><span class="pre">&#64;</span></code>,
418
+ <code class="docutils literal"><span class="pre">&amp;&amp;</span></code> and <code class="docutils literal"><span class="pre">==</span></code>. <code class="docutils literal"><span class="pre">&#64;</span></code> is fulltext search operator. <code class="docutils literal"><span class="pre">&amp;&amp;</span></code> and
419
+ <code class="docutils literal"><span class="pre">==</span></code> are the same as ECMAScript. <code class="docutils literal"><span class="pre">&amp;&amp;</span></code> is logical AND operator and
420
+ <code class="docutils literal"><span class="pre">==</span></code> is equality operator.</p>
421
+ <p><code class="docutils literal"><span class="pre">filter</span></code> has more operators and syntax like grouping by <code class="docutils literal"><span class="pre">(...)</span></code>
421
422
  its details aren't described here. See
422
423
  <a class="reference internal" href="../grn_expr/script_syntax.html"><em>Script syntax</em></a> for datails.</p>
423
424
  </div>
424
425
  </div>
425
426
  <div class="section" id="paging">
426
- <h3>7.3.36.3.3. Paging<a class="headerlink" href="#paging" title="Permalink to this headline">¶</a></h3>
427
- <p>You can specify range of outputted records by <tt class="docutils literal"><span class="pre">offset</span></tt> and <tt class="docutils literal"><span class="pre">limit</span></tt>.
427
+ <h3>7.3.41.3.3. Paging<a class="headerlink" href="#paging" title="Permalink to this headline">¶</a></h3>
428
+ <p>You can specify range of outputted records by <code class="docutils literal"><span class="pre">offset</span></code> and <code class="docutils literal"><span class="pre">limit</span></code>.
428
429
  Here is an example to output only the 2nd record.</p>
429
430
  <p>Execution example:</p>
430
431
  <div class="highlight-none"><div class="highlight"><pre>select Entries --offset 1 --limit 1
@@ -473,15 +474,15 @@ Here is an example to output only the 2nd record.</p>
473
474
  # ]
474
475
  </pre></div>
475
476
  </div>
476
- <p><tt class="docutils literal"><span class="pre">offset</span></tt> is zero-based. <tt class="docutils literal"><span class="pre">--offset</span> <span class="pre">1</span></tt> means output range is
477
+ <p><code class="docutils literal"><span class="pre">offset</span></code> is zero-based. <code class="docutils literal"><span class="pre">--offset</span> <span class="pre">1</span></code> means output range is
477
478
  started from the 2nd record.</p>
478
- <p><tt class="docutils literal"><span class="pre">limit</span></tt> specifies the max number of output records. <tt class="docutils literal"><span class="pre">--limit</span> <span class="pre">1</span></tt>
479
+ <p><code class="docutils literal"><span class="pre">limit</span></code> specifies the max number of output records. <code class="docutils literal"><span class="pre">--limit</span> <span class="pre">1</span></code>
479
480
  means the number of output records is 1 at a maximium. If no records
480
- are matched, <tt class="docutils literal"><span class="pre">select</span></tt> command outputs no records.</p>
481
+ are matched, <code class="docutils literal"><span class="pre">select</span></code> command outputs no records.</p>
481
482
  </div>
482
483
  <div class="section" id="the-total-number-of-records">
483
- <h3>7.3.36.3.4. The total number of records<a class="headerlink" href="#the-total-number-of-records" title="Permalink to this headline">¶</a></h3>
484
- <p>You can use <tt class="docutils literal"><span class="pre">--limit</span> <span class="pre">0</span></tt> to retrieve the total number of recrods
484
+ <h3>7.3.41.3.4. The total number of records<a class="headerlink" href="#the-total-number-of-records" title="Permalink to this headline">¶</a></h3>
485
+ <p>You can use <code class="docutils literal"><span class="pre">--limit</span> <span class="pre">0</span></code> to retrieve the total number of recrods
485
486
  without any contents of records.</p>
486
487
  <p>Execution example:</p>
487
488
  <div class="highlight-none"><div class="highlight"><pre>select Entries --limit 0
@@ -523,19 +524,19 @@ without any contents of records.</p>
523
524
  # ]
524
525
  </pre></div>
525
526
  </div>
526
- <p><tt class="docutils literal"><span class="pre">--limit</span> <span class="pre">0</span></tt> is also useful for retrieving only the number of matched
527
+ <p><code class="docutils literal"><span class="pre">--limit</span> <span class="pre">0</span></code> is also useful for retrieving only the number of matched
527
528
  records.</p>
528
529
  </div>
529
530
  <div class="section" id="drilldown">
530
- <h3>7.3.36.3.5. Drilldown<a class="headerlink" href="#drilldown" title="Permalink to this headline">¶</a></h3>
531
+ <h3>7.3.41.3.5. Drilldown<a class="headerlink" href="#drilldown" title="Permalink to this headline">¶</a></h3>
531
532
  <p>You can get additional grouped results against the search result in
532
- one <tt class="docutils literal"><span class="pre">select</span></tt>. You need to use two or more <tt class="docutils literal"><span class="pre">SELECT``s</span> <span class="pre">in</span> <span class="pre">SQL</span> <span class="pre">but</span>
533
- <span class="pre">``select</span></tt> in Groonga can do it in one <tt class="docutils literal"><span class="pre">select</span></tt>.</p>
533
+ one <code class="docutils literal"><span class="pre">select</span></code>. You need to use two or more <code class="docutils literal"><span class="pre">SELECT``s</span> <span class="pre">in</span> <span class="pre">SQL</span> <span class="pre">but</span>
534
+ <span class="pre">``select</span></code> in Groonga can do it in one <code class="docutils literal"><span class="pre">select</span></code>.</p>
534
535
  <p>This feature is called as <a class="reference external" href="http://en.wikipedia.org/wiki/Drill_down">drilldown</a> in Groonga. It's also
535
536
  called as <a class="reference external" href="http://en.wikipedia.org/wiki/Faceted_search">faceted search</a> in other search
536
537
  engine.</p>
537
538
  <p>For example, think about the following situation.</p>
538
- <p>You search entries that has <tt class="docutils literal"><span class="pre">fast</span></tt> word:</p>
539
+ <p>You search entries that has <code class="docutils literal"><span class="pre">fast</span></code> word:</p>
539
540
  <p>Execution example:</p>
540
541
  <div class="highlight-none"><div class="highlight"><pre>select Entries --filter &#39;content @ &quot;fast&quot;&#39;
541
542
  # [
@@ -590,9 +591,9 @@ engine.</p>
590
591
  # ]
591
592
  </pre></div>
592
593
  </div>
593
- <p>You want to use <tt class="docutils literal"><span class="pre">tag</span></tt> for additional search condition like
594
- <tt class="docutils literal"><span class="pre">--filter</span> <span class="pre">'content</span> <span class="pre">&#64;</span> <span class="pre">&quot;fast&quot;</span> <span class="pre">&amp;&amp;</span> <span class="pre">tag</span> <span class="pre">==</span> <span class="pre">&quot;???&quot;</span></tt>. But you don't know
595
- suitable tag until you see the result of <tt class="docutils literal"><span class="pre">content</span> <span class="pre">&#64;</span> <span class="pre">&quot;fast&quot;</span></tt>.</p>
594
+ <p>You want to use <code class="docutils literal"><span class="pre">tag</span></code> for additional search condition like
595
+ <code class="docutils literal"><span class="pre">--filter</span> <span class="pre">'content</span> <span class="pre">&#64;</span> <span class="pre">&quot;fast&quot;</span> <span class="pre">&amp;&amp;</span> <span class="pre">tag</span> <span class="pre">==</span> <span class="pre">&quot;???&quot;</span></code>. But you don't know
596
+ suitable tag until you see the result of <code class="docutils literal"><span class="pre">content</span> <span class="pre">&#64;</span> <span class="pre">&quot;fast&quot;</span></code>.</p>
596
597
  <p>If you know the number of matched records of each available tag, you
597
598
  can choose suitable tag. You can use drilldown for the case:</p>
598
599
  <p>Execution example:</p>
@@ -668,7 +669,7 @@ can choose suitable tag. You can use drilldown for the case:</p>
668
669
  # ]
669
670
  </pre></div>
670
671
  </div>
671
- <p><tt class="docutils literal"><span class="pre">--drilldown</span> <span class="pre">tag</span></tt> returns a list of pair of available tag and the
672
+ <p><code class="docutils literal"><span class="pre">--drilldown</span> <span class="pre">tag</span></code> returns a list of pair of available tag and the
672
673
  number of matched records. You can avoid &quot;no hit search&quot; case by
673
674
  choosing a tag from the list. You can also avoid &quot;too many search
674
675
  results&quot; case by choosing a tag that the number of matched records is
@@ -684,18 +685,18 @@ search query by their keyboard. They just click a link.)</li>
684
685
  <p>Groonga supports not only counting grouped records but also finding
685
686
  the maximum and/or minimum value from grouped records, summing values
686
687
  in grouped records and so on. See
687
- <a class="reference internal" href="#select-drilldown-related-parameters"><em>Drilldown related parameters</em></a> for details.</p>
688
+ <a class="reference internal" href="#select-drilldown-related-parameters"><span>Drilldown related parameters</span></a> for details.</p>
688
689
  </div>
689
690
  </div>
690
691
  <div class="section" id="parameters">
691
- <h2>7.3.36.4. Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h2>
692
+ <h2>7.3.41.4. Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h2>
692
693
  <p>This section describes all parameters. Parameters are categorized.</p>
693
694
  <div class="section" id="required-parameter">
694
- <h3>7.3.36.4.1. Required parameter<a class="headerlink" href="#required-parameter" title="Permalink to this headline">¶</a></h3>
695
- <p>There is a required parameter, <tt class="docutils literal"><span class="pre">table</span></tt>.</p>
695
+ <h3>7.3.41.4.1. Required parameter<a class="headerlink" href="#required-parameter" title="Permalink to this headline">¶</a></h3>
696
+ <p>There is a required parameter, <code class="docutils literal"><span class="pre">table</span></code>.</p>
696
697
  <div class="section" id="table">
697
- <span id="select-table"></span><h4>7.3.36.4.1.1. <tt class="docutils literal"><span class="pre">table</span></tt><a class="headerlink" href="#table" title="Permalink to this headline">¶</a></h4>
698
- <p>Specifies a table to be searched. <tt class="docutils literal"><span class="pre">table</span></tt> must be specified.</p>
698
+ <span id="select-table"></span><h4>7.3.41.4.1.1. <code class="docutils literal"><span class="pre">table</span></code><a class="headerlink" href="#table" title="Permalink to this headline">¶</a></h4>
699
+ <p>Specifies a table to be searched. <code class="docutils literal"><span class="pre">table</span></code> must be specified.</p>
699
700
  <p>If nonexistent table is specified, an error is returned.</p>
700
701
  <p>Execution example:</p>
701
702
  <div class="highlight-none"><div class="highlight"><pre>select Nonexistent
@@ -709,7 +710,7 @@ in grouped records and so on. See
709
710
  # [
710
711
  # &quot;grn_select&quot;,
711
712
  # &quot;proc.c&quot;,
712
- # 1175
713
+ # 1217
713
714
  # ]
714
715
  # ]
715
716
  # ]
@@ -719,25 +720,25 @@ in grouped records and so on. See
719
720
  </div>
720
721
  </div>
721
722
  <div class="section" id="search-related-parameters">
722
- <h3>7.3.36.4.2. Search related parameters<a class="headerlink" href="#search-related-parameters" title="Permalink to this headline">¶</a></h3>
723
- <p>There are search related parameters. Typically, <tt class="docutils literal"><span class="pre">match_columns</span></tt> and
724
- <tt class="docutils literal"><span class="pre">query</span></tt> parameters are used for implementing a search
725
- box. <tt class="docutils literal"><span class="pre">filter</span></tt> parameters is used for implementing complex search
723
+ <span id="select-search-related-parameters"></span><h3>7.3.41.4.2. Search related parameters<a class="headerlink" href="#search-related-parameters" title="Permalink to this headline">¶</a></h3>
724
+ <p>There are search related parameters. Typically, <code class="docutils literal"><span class="pre">match_columns</span></code> and
725
+ <code class="docutils literal"><span class="pre">query</span></code> parameters are used for implementing a search
726
+ box. <code class="docutils literal"><span class="pre">filter</span></code> parameters is used for implementing complex search
726
727
  feature.</p>
727
- <p>If both <tt class="docutils literal"><span class="pre">query</span></tt> and <tt class="docutils literal"><span class="pre">filter</span></tt> are specified, selected records must
728
- be matched against both <tt class="docutils literal"><span class="pre">query</span></tt> and <tt class="docutils literal"><span class="pre">filter</span></tt>. If both <tt class="docutils literal"><span class="pre">query</span></tt>
729
- and <tt class="docutils literal"><span class="pre">filter</span></tt> aren't specified, all records are selected.</p>
728
+ <p>If both <code class="docutils literal"><span class="pre">query</span></code> and <code class="docutils literal"><span class="pre">filter</span></code> are specified, selected records must
729
+ be matched against both <code class="docutils literal"><span class="pre">query</span></code> and <code class="docutils literal"><span class="pre">filter</span></code>. If both <code class="docutils literal"><span class="pre">query</span></code>
730
+ and <code class="docutils literal"><span class="pre">filter</span></code> aren't specified, all records are selected.</p>
730
731
  <div class="section" id="match-columns">
731
- <span id="select-match-columns"></span><h4>7.3.36.4.2.1. <tt class="docutils literal"><span class="pre">match_columns</span></tt><a class="headerlink" href="#match-columns" title="Permalink to this headline">¶</a></h4>
732
+ <span id="select-match-columns"></span><h4>7.3.41.4.2.1. <code class="docutils literal"><span class="pre">match_columns</span></code><a class="headerlink" href="#match-columns" title="Permalink to this headline">¶</a></h4>
732
733
  <p>Specifies the default target column for fulltext search by
733
- <tt class="docutils literal"><span class="pre">query</span></tt> parameter value. A target column for fulltext search can be
734
- specified in <tt class="docutils literal"><span class="pre">query</span></tt> parameter. The difference between
735
- <tt class="docutils literal"><span class="pre">match_columns</span></tt> and <tt class="docutils literal"><span class="pre">query</span></tt> is whether weight is supported or
736
- not. <tt class="docutils literal"><span class="pre">match_columns</span></tt> supports weight but <tt class="docutils literal"><span class="pre">query</span></tt> doesn't.</p>
734
+ <code class="docutils literal"><span class="pre">query</span></code> parameter value. A target column for fulltext search can be
735
+ specified in <code class="docutils literal"><span class="pre">query</span></code> parameter. The difference between
736
+ <code class="docutils literal"><span class="pre">match_columns</span></code> and <code class="docutils literal"><span class="pre">query</span></code> is whether weight is supported or
737
+ not. <code class="docutils literal"><span class="pre">match_columns</span></code> supports weight but <code class="docutils literal"><span class="pre">query</span></code> doesn't.</p>
737
738
  <p>Weight is relative importance of target column. A higher weight target
738
739
  column gets more hit score rather than a lower weight target column
739
740
  when a record is matched by fulltext search. The default weight is 1.</p>
740
- <p>Here is a simple <tt class="docutils literal"><span class="pre">match_columns</span></tt> usage example.</p>
741
+ <p>Here is a simple <code class="docutils literal"><span class="pre">match_columns</span></code> usage example.</p>
741
742
  <p>Execution example:</p>
742
743
  <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query fast --output_columns &#39;_key, _score&#39;
743
744
  # [
@@ -774,18 +775,18 @@ when a record is matched by fulltext search. The default weight is 1.</p>
774
775
  # ]
775
776
  </pre></div>
776
777
  </div>
777
- <p><tt class="docutils literal"><span class="pre">--match_columns</span> <span class="pre">content</span></tt> means the default target column for
778
- fulltext search is <tt class="docutils literal"><span class="pre">content</span></tt> column and its weight
779
- is 1. <tt class="docutils literal"><span class="pre">--output_columns</span> <span class="pre">'_key,</span> <span class="pre">_score'</span></tt> means that the <tt class="docutils literal"><span class="pre">select</span></tt>
780
- command outputs <tt class="docutils literal"><span class="pre">_key</span></tt> value and <tt class="docutils literal"><span class="pre">_score</span></tt> value for matched
778
+ <p><code class="docutils literal"><span class="pre">--match_columns</span> <span class="pre">content</span></code> means the default target column for
779
+ fulltext search is <code class="docutils literal"><span class="pre">content</span></code> column and its weight
780
+ is 1. <code class="docutils literal"><span class="pre">--output_columns</span> <span class="pre">'_key,</span> <span class="pre">_score'</span></code> means that the <code class="docutils literal"><span class="pre">select</span></code>
781
+ command outputs <code class="docutils literal"><span class="pre">_key</span></code> value and <code class="docutils literal"><span class="pre">_score</span></code> value for matched
781
782
  records.</p>
782
- <p>Pay attention to <tt class="docutils literal"><span class="pre">_score</span></tt> value. <tt class="docutils literal"><span class="pre">_score</span></tt> value is the number of
783
- matched counts against <tt class="docutils literal"><span class="pre">query</span></tt> parameter value. In the example,
784
- <tt class="docutils literal"><span class="pre">query</span></tt> parameter value is <tt class="docutils literal"><span class="pre">fast</span></tt>. The fact that <tt class="docutils literal"><span class="pre">_score</span></tt> value
785
- is 1 means that <tt class="docutils literal"><span class="pre">fast</span></tt> appers in <tt class="docutils literal"><span class="pre">content</span></tt> column only once. The
786
- fact that <tt class="docutils literal"><span class="pre">_score</span></tt> value is 2 means that <tt class="docutils literal"><span class="pre">fast</span></tt> appears in
787
- <tt class="docutils literal"><span class="pre">content</span></tt> column twice.</p>
788
- <p>To specify weight, <tt class="docutils literal"><span class="pre">column</span> <span class="pre">*</span> <span class="pre">weight</span></tt> syntax is used. Here is a
783
+ <p>Pay attention to <code class="docutils literal"><span class="pre">_score</span></code> value. <code class="docutils literal"><span class="pre">_score</span></code> value is the number of
784
+ matched counts against <code class="docutils literal"><span class="pre">query</span></code> parameter value. In the example,
785
+ <code class="docutils literal"><span class="pre">query</span></code> parameter value is <code class="docutils literal"><span class="pre">fast</span></code>. The fact that <code class="docutils literal"><span class="pre">_score</span></code> value
786
+ is 1 means that <code class="docutils literal"><span class="pre">fast</span></code> appers in <code class="docutils literal"><span class="pre">content</span></code> column only once. The
787
+ fact that <code class="docutils literal"><span class="pre">_score</span></code> value is 2 means that <code class="docutils literal"><span class="pre">fast</span></code> appears in
788
+ <code class="docutils literal"><span class="pre">content</span></code> column twice.</p>
789
+ <p>To specify weight, <code class="docutils literal"><span class="pre">column</span> <span class="pre">*</span> <span class="pre">weight</span></code> syntax is used. Here is a
789
790
  weight usage example.</p>
790
791
  <p>Execution example:</p>
791
792
  <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns &#39;content * 2&#39; --query fast --output_columns &#39;_key, _score&#39;
@@ -823,17 +824,17 @@ weight usage example.</p>
823
824
  # ]
824
825
  </pre></div>
825
826
  </div>
826
- <p><tt class="docutils literal"><span class="pre">--match_columns</span> <span class="pre">'content</span> <span class="pre">*</span> <span class="pre">2'</span></tt> means the default target column for
827
- fulltext search is <tt class="docutils literal"><span class="pre">content</span></tt> column and its weight is 2.</p>
828
- <p>Pay attention to <tt class="docutils literal"><span class="pre">_score</span></tt> value. <tt class="docutils literal"><span class="pre">_score</span></tt> value is doubled because
827
+ <p><code class="docutils literal"><span class="pre">--match_columns</span> <span class="pre">'content</span> <span class="pre">*</span> <span class="pre">2'</span></code> means the default target column for
828
+ fulltext search is <code class="docutils literal"><span class="pre">content</span></code> column and its weight is 2.</p>
829
+ <p>Pay attention to <code class="docutils literal"><span class="pre">_score</span></code> value. <code class="docutils literal"><span class="pre">_score</span></code> value is doubled because
829
830
  weight is 2.</p>
830
831
  <p>You can specify one or more columns as the default target columns for
831
832
  fulltext search. If one or more columns are specified, fulltext search
832
833
  is done for all columns and scores are accumulated. If one of the
833
- columns is matched against <tt class="docutils literal"><span class="pre">query</span></tt> parameter value, the record is
834
+ columns is matched against <code class="docutils literal"><span class="pre">query</span></code> parameter value, the record is
834
835
  treated as matched.</p>
835
- <p>To specify one or more columns, <tt class="docutils literal"><span class="pre">column1</span> <span class="pre">*</span> <span class="pre">weight1</span> <span class="pre">||</span> <span class="pre">column2</span> <span class="pre">*</span>
836
- <span class="pre">weight2</span> <span class="pre">||</span> <span class="pre">...</span></tt> syntax is used. <tt class="docutils literal"><span class="pre">*</span> <span class="pre">weight</span></tt> can be omitted. If it is
836
+ <p>To specify one or more columns, <code class="docutils literal"><span class="pre">column1</span> <span class="pre">*</span> <span class="pre">weight1</span> <span class="pre">||</span> <span class="pre">column2</span> <span class="pre">*</span>
837
+ <span class="pre">weight2</span> <span class="pre">||</span> <span class="pre">...</span></code> syntax is used. <code class="docutils literal"><span class="pre">*</span> <span class="pre">weight</span></code> can be omitted. If it is
837
838
  omitted, 1 is used for weight. Here is a one or more columns usage
838
839
  example.</p>
839
840
  <p>Execution example:</p>
@@ -868,23 +869,23 @@ example.</p>
868
869
  # ]
869
870
  </pre></div>
870
871
  </div>
871
- <p><tt class="docutils literal"><span class="pre">--match_columns</span> <span class="pre">'_key</span> <span class="pre">*</span> <span class="pre">10</span> <span class="pre">||</span> <span class="pre">content'</span></tt> means the default target
872
- columns for fulltext search are <tt class="docutils literal"><span class="pre">_key</span></tt> and <tt class="docutils literal"><span class="pre">content</span></tt> columns and
873
- <tt class="docutils literal"><span class="pre">_key</span></tt> column's weight is 10 and <tt class="docutils literal"><span class="pre">content</span></tt> column's weight
874
- is 1. This weight allocation means <tt class="docutils literal"><span class="pre">_key</span></tt> column value is more
875
- important rather than <tt class="docutils literal"><span class="pre">content</span></tt> column value. In this example, title
872
+ <p><code class="docutils literal"><span class="pre">--match_columns</span> <span class="pre">'_key</span> <span class="pre">*</span> <span class="pre">10</span> <span class="pre">||</span> <span class="pre">content'</span></code> means the default target
873
+ columns for fulltext search are <code class="docutils literal"><span class="pre">_key</span></code> and <code class="docutils literal"><span class="pre">content</span></code> columns and
874
+ <code class="docutils literal"><span class="pre">_key</span></code> column's weight is 10 and <code class="docutils literal"><span class="pre">content</span></code> column's weight
875
+ is 1. This weight allocation means <code class="docutils literal"><span class="pre">_key</span></code> column value is more
876
+ important rather than <code class="docutils literal"><span class="pre">content</span></code> column value. In this example, title
876
877
  of blog entry is more important rather thatn content of blog entry.</p>
877
878
  </div>
878
879
  <div class="section" id="query">
879
- <span id="select-query"></span><h4>7.3.36.4.2.2. <tt class="docutils literal"><span class="pre">query</span></tt><a class="headerlink" href="#query" title="Permalink to this headline">¶</a></h4>
880
+ <span id="select-query"></span><h4>7.3.41.4.2.2. <code class="docutils literal"><span class="pre">query</span></code><a class="headerlink" href="#query" title="Permalink to this headline">¶</a></h4>
880
881
  <p>Specifies the query text. Normally, it is used for fulltext search
881
- with <tt class="docutils literal"><span class="pre">match_columns</span></tt> parameter. <tt class="docutils literal"><span class="pre">query</span></tt> parameter is designed for
882
+ with <code class="docutils literal"><span class="pre">match_columns</span></code> parameter. <code class="docutils literal"><span class="pre">query</span></code> parameter is designed for
882
883
  a fulltext search form in a Web page. A query text should be formatted
883
884
  in <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a>. The syntax is similar to common search
884
- form like Google's search form. For example, <tt class="docutils literal"><span class="pre">word1</span> <span class="pre">word2</span></tt> means
885
- that groonga searches records that contain both <tt class="docutils literal"><span class="pre">word1</span></tt> and
886
- <tt class="docutils literal"><span class="pre">word2</span></tt>. <tt class="docutils literal"><span class="pre">word1</span> <span class="pre">OR</span> <span class="pre">word2</span></tt> means that groogna searches records that
887
- contain either <tt class="docutils literal"><span class="pre">word1</span></tt> or <tt class="docutils literal"><span class="pre">word2</span></tt>.</p>
885
+ form like Google's search form. For example, <code class="docutils literal"><span class="pre">word1</span> <span class="pre">word2</span></code> means
886
+ that groonga searches records that contain both <code class="docutils literal"><span class="pre">word1</span></code> and
887
+ <code class="docutils literal"><span class="pre">word2</span></code>. <code class="docutils literal"><span class="pre">word1</span> <span class="pre">OR</span> <span class="pre">word2</span></code> means that groogna searches records that
888
+ contain either <code class="docutils literal"><span class="pre">word1</span></code> or <code class="docutils literal"><span class="pre">word2</span></code>.</p>
888
889
  <p>Here is a simple logical and search example.</p>
889
890
  <p>Execution example:</p>
890
891
  <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query &quot;fast groonga&quot;
@@ -933,8 +934,8 @@ contain either <tt class="docutils literal"><span class="pre">word1</span></tt>
933
934
  # ]
934
935
  </pre></div>
935
936
  </div>
936
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command searches records that contain two words
937
- <tt class="docutils literal"><span class="pre">fast</span></tt> and <tt class="docutils literal"><span class="pre">groonga</span></tt> in <tt class="docutils literal"><span class="pre">content</span></tt> column value from <tt class="docutils literal"><span class="pre">Entries</span></tt>
937
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain two words
938
+ <code class="docutils literal"><span class="pre">fast</span></code> and <code class="docutils literal"><span class="pre">groonga</span></code> in <code class="docutils literal"><span class="pre">content</span></code> column value from <code class="docutils literal"><span class="pre">Entries</span></code>
938
939
  table.</p>
939
940
  <p>Here is a simple logical or search example.</p>
940
941
  <p>Execution example:</p>
@@ -991,14 +992,14 @@ table.</p>
991
992
  # ]
992
993
  </pre></div>
993
994
  </div>
994
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command searches records that contain one of two words
995
- <tt class="docutils literal"><span class="pre">groonga</span></tt> or <tt class="docutils literal"><span class="pre">mroonga</span></tt> in <tt class="docutils literal"><span class="pre">content</span></tt> column value from
996
- <tt class="docutils literal"><span class="pre">Entries</span></tt> table.</p>
995
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain one of two words
996
+ <code class="docutils literal"><span class="pre">groonga</span></code> or <code class="docutils literal"><span class="pre">mroonga</span></code> in <code class="docutils literal"><span class="pre">content</span></code> column value from
997
+ <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
997
998
  <p>See <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a> for other syntax.</p>
998
999
  <p>It can be used for not only fulltext search but also other
999
- conditions. For example, <tt class="docutils literal"><span class="pre">column:value</span></tt> means the value of
1000
- <tt class="docutils literal"><span class="pre">column</span></tt> column is equal to <tt class="docutils literal"><span class="pre">value</span></tt>. <tt class="docutils literal"><span class="pre">column:&lt;value</span></tt> means the
1001
- value of <tt class="docutils literal"><span class="pre">column</span></tt> column is less than <tt class="docutils literal"><span class="pre">value</span></tt>.</p>
1000
+ conditions. For example, <code class="docutils literal"><span class="pre">column:value</span></code> means the value of
1001
+ <code class="docutils literal"><span class="pre">column</span></code> column is equal to <code class="docutils literal"><span class="pre">value</span></code>. <code class="docutils literal"><span class="pre">column:&lt;value</span></code> means the
1002
+ value of <code class="docutils literal"><span class="pre">column</span></code> column is less than <code class="docutils literal"><span class="pre">value</span></code>.</p>
1002
1003
  <p>Here is a simple equality operator search example.</p>
1003
1004
  <p>Execution example:</p>
1004
1005
  <div class="highlight-none"><div class="highlight"><pre>select Entries --query _key:Groonga
@@ -1047,8 +1048,8 @@ value of <tt class="docutils literal"><span class="pre">column</span></tt> colum
1047
1048
  # ]
1048
1049
  </pre></div>
1049
1050
  </div>
1050
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command searches records that <tt class="docutils literal"><span class="pre">_key</span></tt> column value is
1051
- <tt class="docutils literal"><span class="pre">Groonga</span></tt> from <tt class="docutils literal"><span class="pre">Entries</span></tt> table.</p>
1051
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that <code class="docutils literal"><span class="pre">_key</span></code> column value is
1052
+ <code class="docutils literal"><span class="pre">Groonga</span></code> from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
1052
1053
  <p>Here is a simple less than operator search example.</p>
1053
1054
  <p>Execution example:</p>
1054
1055
  <div class="highlight-none"><div class="highlight"><pre>select Entries --query n_likes:&lt;11
@@ -1118,23 +1119,23 @@ value of <tt class="docutils literal"><span class="pre">column</span></tt> colum
1118
1119
  # ]
1119
1120
  </pre></div>
1120
1121
  </div>
1121
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command searches records that <tt class="docutils literal"><span class="pre">n_likes</span></tt> column value
1122
- is less than <tt class="docutils literal"><span class="pre">11</span></tt> from <tt class="docutils literal"><span class="pre">Entries</span></tt> table.</p>
1122
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that <code class="docutils literal"><span class="pre">n_likes</span></code> column value
1123
+ is less than <code class="docutils literal"><span class="pre">11</span></code> from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
1123
1124
  <p>See <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a> for other operations.</p>
1124
1125
  </div>
1125
1126
  <div class="section" id="filter">
1126
- <span id="select-filter"></span><h4>7.3.36.4.2.3. <tt class="docutils literal"><span class="pre">filter</span></tt><a class="headerlink" href="#filter" title="Permalink to this headline">¶</a></h4>
1127
+ <span id="select-filter"></span><h4>7.3.41.4.2.3. <code class="docutils literal"><span class="pre">filter</span></code><a class="headerlink" href="#filter" title="Permalink to this headline">¶</a></h4>
1127
1128
  <p>Specifies the filter text. Normally, it is used for complex search
1128
- conditions. <tt class="docutils literal"><span class="pre">filter</span></tt> can be used with <tt class="docutils literal"><span class="pre">query</span></tt> parameter. If both
1129
- <tt class="docutils literal"><span class="pre">filter</span></tt> and <tt class="docutils literal"><span class="pre">query</span></tt> are specified, there are conbined with
1129
+ conditions. <code class="docutils literal"><span class="pre">filter</span></code> can be used with <code class="docutils literal"><span class="pre">query</span></code> parameter. If both
1130
+ <code class="docutils literal"><span class="pre">filter</span></code> and <code class="docutils literal"><span class="pre">query</span></code> are specified, there are conbined with
1130
1131
  logical and. It means that matched records should be matched against
1131
- both <tt class="docutils literal"><span class="pre">filter</span></tt> and <tt class="docutils literal"><span class="pre">query</span></tt>.</p>
1132
- <p><tt class="docutils literal"><span class="pre">filter</span></tt> parameter is designed for complex conditions. A filter text
1132
+ both <code class="docutils literal"><span class="pre">filter</span></code> and <code class="docutils literal"><span class="pre">query</span></code>.</p>
1133
+ <p><code class="docutils literal"><span class="pre">filter</span></code> parameter is designed for complex conditions. A filter text
1133
1134
  should be formated in <a class="reference internal" href="../grn_expr/script_syntax.html"><em>Script syntax</em></a>. The syntax is
1134
- similar to ECMAScript. For example, <tt class="docutils literal"><span class="pre">column</span> <span class="pre">==</span> <span class="pre">&quot;value&quot;</span></tt> means that
1135
- the value of <tt class="docutils literal"><span class="pre">column</span></tt> column is equal to <tt class="docutils literal"><span class="pre">&quot;value&quot;</span></tt>. <tt class="docutils literal"><span class="pre">column</span> <span class="pre">&lt;</span>
1136
- <span class="pre">value</span></tt> means that the value of <tt class="docutils literal"><span class="pre">column</span></tt> column is less than
1137
- <tt class="docutils literal"><span class="pre">value</span></tt>.</p>
1135
+ similar to ECMAScript. For example, <code class="docutils literal"><span class="pre">column</span> <span class="pre">==</span> <span class="pre">&quot;value&quot;</span></code> means that
1136
+ the value of <code class="docutils literal"><span class="pre">column</span></code> column is equal to <code class="docutils literal"><span class="pre">&quot;value&quot;</span></code>. <code class="docutils literal"><span class="pre">column</span> <span class="pre">&lt;</span>
1137
+ <span class="pre">value</span></code> means that the value of <code class="docutils literal"><span class="pre">column</span></code> column is less than
1138
+ <code class="docutils literal"><span class="pre">value</span></code>.</p>
1138
1139
  <p>Here is a simple equality operator search example.</p>
1139
1140
  <p>Execution example:</p>
1140
1141
  <div class="highlight-none"><div class="highlight"><pre>select Entries --filter &#39;_key == &quot;Groonga&quot;&#39;
@@ -1183,8 +1184,8 @@ the value of <tt class="docutils literal"><span class="pre">column</span></tt> c
1183
1184
  # ]
1184
1185
  </pre></div>
1185
1186
  </div>
1186
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command searches records that <tt class="docutils literal"><span class="pre">_key</span></tt> column value is
1187
- <tt class="docutils literal"><span class="pre">Groonga</span></tt> from <tt class="docutils literal"><span class="pre">Entries</span></tt> table.</p>
1187
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that <code class="docutils literal"><span class="pre">_key</span></code> column value is
1188
+ <code class="docutils literal"><span class="pre">Groonga</span></code> from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
1188
1189
  <p>Here is a simple less than operator search example.</p>
1189
1190
  <p>Execution example:</p>
1190
1191
  <div class="highlight-none"><div class="highlight"><pre>select Entries --filter &#39;n_likes &lt; 11&#39;
@@ -1254,15 +1255,15 @@ the value of <tt class="docutils literal"><span class="pre">column</span></tt> c
1254
1255
  # ]
1255
1256
  </pre></div>
1256
1257
  </div>
1257
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command searches records that <tt class="docutils literal"><span class="pre">n_likes</span></tt> column value
1258
- is less than <tt class="docutils literal"><span class="pre">11</span></tt> from <tt class="docutils literal"><span class="pre">Entries</span></tt> table.</p>
1258
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that <code class="docutils literal"><span class="pre">n_likes</span></code> column value
1259
+ is less than <code class="docutils literal"><span class="pre">11</span></code> from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
1259
1260
  <p>See <a class="reference internal" href="../grn_expr/script_syntax.html"><em>Script syntax</em></a> for other operators.</p>
1260
1261
  </div>
1261
1262
  </div>
1262
1263
  <div class="section" id="advanced-search-parameters">
1263
- <h3>7.3.36.4.3. Advanced search parameters<a class="headerlink" href="#advanced-search-parameters" title="Permalink to this headline">¶</a></h3>
1264
+ <span id="select-advanced-search-parameters"></span><h3>7.3.41.4.3. Advanced search parameters<a class="headerlink" href="#advanced-search-parameters" title="Permalink to this headline">¶</a></h3>
1264
1265
  <div class="section" id="match-escalation-threshold">
1265
- <span id="id2"></span><h4>7.3.36.4.3.1. <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt><a class="headerlink" href="#match-escalation-threshold" title="Permalink to this headline">¶</a></h4>
1266
+ <span id="select-match-escalation-threshold"></span><h4>7.3.41.4.3.1. <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code><a class="headerlink" href="#match-escalation-threshold" title="Permalink to this headline">¶</a></h4>
1266
1267
  <p>Specifies threshold to determine whether search storategy
1267
1268
  escalation is used or not. The threshold is compared against the
1268
1269
  number of matched records. If the number of matched records is equal
@@ -1273,15 +1274,15 @@ is used only when no records are matched.</p>
1273
1274
  <p>The default threshold can be customized by one of the followings.</p>
1274
1275
  <blockquote>
1275
1276
  <div><ul class="simple">
1276
- <li><tt class="docutils literal"><span class="pre">--with-match-escalation-threshold</span></tt> option of configure</li>
1277
- <li><tt class="docutils literal"><span class="pre">--match-escalation-threshold</span></tt> option of groogna command</li>
1278
- <li><tt class="docutils literal"><span class="pre">match-escalation-threshold</span></tt> configuration item in configuration
1277
+ <li><code class="docutils literal"><span class="pre">--with-match-escalation-threshold</span></code> option of configure</li>
1278
+ <li><code class="docutils literal"><span class="pre">--match-escalation-threshold</span></code> option of groogna command</li>
1279
+ <li><code class="docutils literal"><span class="pre">match-escalation-threshold</span></code> configuration item in configuration
1279
1280
  file</li>
1280
1281
  </ul>
1281
1282
  </div></blockquote>
1282
- <p>Here is a simple <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt> usage example. The
1283
- first <tt class="docutils literal"><span class="pre">select</span></tt> doesn't have <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt>
1284
- parameter. The second <tt class="docutils literal"><span class="pre">select</span></tt> has <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt>
1283
+ <p>Here is a simple <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code> usage example. The
1284
+ first <code class="docutils literal"><span class="pre">select</span></code> doesn't have <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code>
1285
+ parameter. The second <code class="docutils literal"><span class="pre">select</span></code> has <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code>
1285
1286
  parameter.</p>
1286
1287
  <p>Execution example:</p>
1287
1288
  <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query groo
@@ -1367,60 +1368,60 @@ select Entries --match_columns content --query groo --match_escalation_threshold
1367
1368
  # ]
1368
1369
  </pre></div>
1369
1370
  </div>
1370
- <p>The first <tt class="docutils literal"><span class="pre">select</span></tt> command searches records that contain a word
1371
- <tt class="docutils literal"><span class="pre">groo</span></tt> in <tt class="docutils literal"><span class="pre">content</span></tt> column value from <tt class="docutils literal"><span class="pre">Entries</span></tt> table. But no
1372
- records are matched because the <tt class="docutils literal"><span class="pre">TokenBigram</span></tt> tokenizer tokenizes
1373
- <tt class="docutils literal"><span class="pre">groonga</span></tt> to <tt class="docutils literal"><span class="pre">groonga</span></tt> not <tt class="docutils literal"><span class="pre">gr|ro|oo|on|ng|ga</span></tt>. (The
1374
- <tt class="docutils literal"><span class="pre">TokenBigramSplitSymbolAlpha</span></tt> tokenizer tokenizes <tt class="docutils literal"><span class="pre">groonga</span></tt> to
1375
- <tt class="docutils literal"><span class="pre">gr|ro|oo|on|ng|ga</span></tt>. See <a class="reference internal" href="../tokenizers.html"><em>Tokenizers</em></a> for details.)
1376
- It means that <tt class="docutils literal"><span class="pre">groonga</span></tt> is indexed but <tt class="docutils literal"><span class="pre">groo</span></tt> isn't indexed. So no
1377
- records are matched against <tt class="docutils literal"><span class="pre">groo</span></tt> by exact match. In the case, the
1371
+ <p>The first <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain a word
1372
+ <code class="docutils literal"><span class="pre">groo</span></code> in <code class="docutils literal"><span class="pre">content</span></code> column value from <code class="docutils literal"><span class="pre">Entries</span></code> table. But no
1373
+ records are matched because the <code class="docutils literal"><span class="pre">TokenBigram</span></code> tokenizer tokenizes
1374
+ <code class="docutils literal"><span class="pre">groonga</span></code> to <code class="docutils literal"><span class="pre">groonga</span></code> not <code class="docutils literal"><span class="pre">gr|ro|oo|on|ng|ga</span></code>. (The
1375
+ <code class="docutils literal"><span class="pre">TokenBigramSplitSymbolAlpha</span></code> tokenizer tokenizes <code class="docutils literal"><span class="pre">groonga</span></code> to
1376
+ <code class="docutils literal"><span class="pre">gr|ro|oo|on|ng|ga</span></code>. See <a class="reference internal" href="../tokenizers.html"><em>Tokenizers</em></a> for details.)
1377
+ It means that <code class="docutils literal"><span class="pre">groonga</span></code> is indexed but <code class="docutils literal"><span class="pre">groo</span></code> isn't indexed. So no
1378
+ records are matched against <code class="docutils literal"><span class="pre">groo</span></code> by exact match. In the case, the
1378
1379
  search storategy escalation is used because the number of matched
1379
- records (0) is equal to <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt> (0). One record
1380
- is matched against <tt class="docutils literal"><span class="pre">groo</span></tt> by unsplit search.</p>
1381
- <p>The second <tt class="docutils literal"><span class="pre">select</span></tt> command also searches records that contain a
1382
- word <tt class="docutils literal"><span class="pre">groo</span></tt> in <tt class="docutils literal"><span class="pre">content</span></tt> column value from <tt class="docutils literal"><span class="pre">Entries</span></tt> table. And
1380
+ records (0) is equal to <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code> (0). One record
1381
+ is matched against <code class="docutils literal"><span class="pre">groo</span></code> by unsplit search.</p>
1382
+ <p>The second <code class="docutils literal"><span class="pre">select</span></code> command also searches records that contain a
1383
+ word <code class="docutils literal"><span class="pre">groo</span></code> in <code class="docutils literal"><span class="pre">content</span></code> column value from <code class="docutils literal"><span class="pre">Entries</span></code> table. And
1383
1384
  it also doesn't found matched records. In this case, the search
1384
1385
  storategy escalation is not used because the number of matched
1385
- records (0) is larger than <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt> (-1). So no
1386
+ records (0) is larger than <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code> (-1). So no
1386
1387
  more searches aren't executed. And no records are matched.</p>
1387
1388
  </div>
1388
1389
  <div class="section" id="query-expansion">
1389
- <span id="id3"></span><h4>7.3.36.4.3.2. <tt class="docutils literal"><span class="pre">query_expansion</span></tt><a class="headerlink" href="#query-expansion" title="Permalink to this headline">¶</a></h4>
1390
- <p>Deprecated. Use <a class="reference internal" href="#query-expander"><em>query_expander</em></a> instead.</p>
1390
+ <span id="select-query-expansion"></span><h4>7.3.41.4.3.2. <code class="docutils literal"><span class="pre">query_expansion</span></code><a class="headerlink" href="#query-expansion" title="Permalink to this headline">¶</a></h4>
1391
+ <p>Deprecated. Use <a class="reference internal" href="#select-query-expander"><span>query_expander</span></a> instead.</p>
1391
1392
  </div>
1392
1393
  <div class="section" id="query-flags">
1393
- <span id="id4"></span><h4>7.3.36.4.3.3. <tt class="docutils literal"><span class="pre">query_flags</span></tt><a class="headerlink" href="#query-flags" title="Permalink to this headline">¶</a></h4>
1394
- <p>It customs <tt class="docutils literal"><span class="pre">query</span></tt> parameter syntax. You cannot update column value
1395
- by <tt class="docutils literal"><span class="pre">query</span></tt> parameter by default. But if you specify
1396
- <tt class="docutils literal"><span class="pre">ALLOW_COLUMN|ALLOW_UPDATE</span></tt> as <tt class="docutils literal"><span class="pre">query_flags</span></tt>, you can update
1397
- column value by <tt class="docutils literal"><span class="pre">query</span></tt>.</p>
1394
+ <span id="select-query-flags"></span><h4>7.3.41.4.3.3. <code class="docutils literal"><span class="pre">query_flags</span></code><a class="headerlink" href="#query-flags" title="Permalink to this headline">¶</a></h4>
1395
+ <p>It customs <code class="docutils literal"><span class="pre">query</span></code> parameter syntax. You cannot update column value
1396
+ by <code class="docutils literal"><span class="pre">query</span></code> parameter by default. But if you specify
1397
+ <code class="docutils literal"><span class="pre">ALLOW_COLUMN|ALLOW_UPDATE</span></code> as <code class="docutils literal"><span class="pre">query_flags</span></code>, you can update
1398
+ column value by <code class="docutils literal"><span class="pre">query</span></code>.</p>
1398
1399
  <p>Here are available values:</p>
1399
1400
  <ul class="simple">
1400
- <li><tt class="docutils literal"><span class="pre">ALLOW_PRAGMA</span></tt></li>
1401
- <li><tt class="docutils literal"><span class="pre">ALLOW_COLUMN</span></tt></li>
1402
- <li><tt class="docutils literal"><span class="pre">ALLOW_UPDATE</span></tt></li>
1403
- <li><tt class="docutils literal"><span class="pre">ALLOW_LEADING_NOT</span></tt></li>
1404
- <li><tt class="docutils literal"><span class="pre">NONE</span></tt></li>
1401
+ <li><code class="docutils literal"><span class="pre">ALLOW_PRAGMA</span></code></li>
1402
+ <li><code class="docutils literal"><span class="pre">ALLOW_COLUMN</span></code></li>
1403
+ <li><code class="docutils literal"><span class="pre">ALLOW_UPDATE</span></code></li>
1404
+ <li><code class="docutils literal"><span class="pre">ALLOW_LEADING_NOT</span></code></li>
1405
+ <li><code class="docutils literal"><span class="pre">NONE</span></code></li>
1405
1406
  </ul>
1406
- <p><tt class="docutils literal"><span class="pre">ALLOW_PRAGMA</span></tt> enables pragma at the head of <tt class="docutils literal"><span class="pre">query</span></tt>. This is not
1407
+ <p><code class="docutils literal"><span class="pre">ALLOW_PRAGMA</span></code> enables pragma at the head of <code class="docutils literal"><span class="pre">query</span></code>. This is not
1407
1408
  implemented yet.</p>
1408
- <p><tt class="docutils literal"><span class="pre">ALLOW_COLUMN</span></tt> enables search againt columns that are not included
1409
- in <tt class="docutils literal"><span class="pre">match_columns</span></tt>. To specify column, there are <tt class="docutils literal"><span class="pre">COLUMN:...</span></tt>
1409
+ <p><code class="docutils literal"><span class="pre">ALLOW_COLUMN</span></code> enables search againt columns that are not included
1410
+ in <code class="docutils literal"><span class="pre">match_columns</span></code>. To specify column, there are <code class="docutils literal"><span class="pre">COLUMN:...</span></code>
1410
1411
  syntaxes.</p>
1411
- <p><tt class="docutils literal"><span class="pre">ALLOW_UPDATE</span></tt> enables column update by <tt class="docutils literal"><span class="pre">query</span></tt> with
1412
- <tt class="docutils literal"><span class="pre">COLUMN:=NEW_VALUE</span></tt> syntax. <tt class="docutils literal"><span class="pre">ALLOW_COLUMN</span></tt> is also required to
1412
+ <p><code class="docutils literal"><span class="pre">ALLOW_UPDATE</span></code> enables column update by <code class="docutils literal"><span class="pre">query</span></code> with
1413
+ <code class="docutils literal"><span class="pre">COLUMN:=NEW_VALUE</span></code> syntax. <code class="docutils literal"><span class="pre">ALLOW_COLUMN</span></code> is also required to
1413
1414
  update column because the column update syntax specifies column.</p>
1414
- <p><tt class="docutils literal"><span class="pre">ALLOW_LEADING_NOT</span></tt> enables leading NOT condition with <tt class="docutils literal"><span class="pre">-WORD</span></tt>
1415
+ <p><code class="docutils literal"><span class="pre">ALLOW_LEADING_NOT</span></code> enables leading NOT condition with <code class="docutils literal"><span class="pre">-WORD</span></code>
1415
1416
  syntax. The query searches records that doesn't match
1416
- <tt class="docutils literal"><span class="pre">WORD</span></tt>. Leading NOT condition query is heavy query in many cases
1417
+ <code class="docutils literal"><span class="pre">WORD</span></code>. Leading NOT condition query is heavy query in many cases
1417
1418
  because it matches many records. So this flag is disabled by
1418
1419
  default. Be careful about it when you use the flag.</p>
1419
- <p><tt class="docutils literal"><span class="pre">NONE</span></tt> is just ignores. You can use <tt class="docutils literal"><span class="pre">NONE</span></tt> for specifying no flags.</p>
1420
- <p>They can be combined by separated <tt class="docutils literal"><span class="pre">|</span></tt> such as
1421
- <tt class="docutils literal"><span class="pre">ALLOW_COLUMN|ALLOW_UPDATE</span></tt>.</p>
1422
- <p>The default value is <tt class="docutils literal"><span class="pre">ALLOW_PRAGMA|ALLOW_COLUMN</span></tt>.</p>
1423
- <p>Here is a usage example of <tt class="docutils literal"><span class="pre">ALLOW_COLUMN</span></tt>.</p>
1420
+ <p><code class="docutils literal"><span class="pre">NONE</span></code> is just ignores. You can use <code class="docutils literal"><span class="pre">NONE</span></code> for specifying no flags.</p>
1421
+ <p>They can be combined by separated <code class="docutils literal"><span class="pre">|</span></code> such as
1422
+ <code class="docutils literal"><span class="pre">ALLOW_COLUMN|ALLOW_UPDATE</span></code>.</p>
1423
+ <p>The default value is <code class="docutils literal"><span class="pre">ALLOW_PRAGMA|ALLOW_COLUMN</span></code>.</p>
1424
+ <p>Here is a usage example of <code class="docutils literal"><span class="pre">ALLOW_COLUMN</span></code>.</p>
1424
1425
  <p>Execution example:</p>
1425
1426
  <div class="highlight-none"><div class="highlight"><pre>select Entries --query content:@mroonga --query_flags ALLOW_COLUMN
1426
1427
  # [
@@ -1468,9 +1469,9 @@ default. Be careful about it when you use the flag.</p>
1468
1469
  # ]
1469
1470
  </pre></div>
1470
1471
  </div>
1471
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command searches records that contain <tt class="docutils literal"><span class="pre">mroonga</span></tt> in
1472
- <tt class="docutils literal"><span class="pre">content</span></tt> column value from <tt class="docutils literal"><span class="pre">Entries</span></tt> table.</p>
1473
- <p>Here is a usage example of <tt class="docutils literal"><span class="pre">ALLOW_UPDATE</span></tt>.</p>
1472
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain <code class="docutils literal"><span class="pre">mroonga</span></code> in
1473
+ <code class="docutils literal"><span class="pre">content</span></code> column value from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
1474
+ <p>Here is a usage example of <code class="docutils literal"><span class="pre">ALLOW_UPDATE</span></code>.</p>
1474
1475
  <p>Execution example:</p>
1475
1476
  <div class="highlight-none"><div class="highlight"><pre>table_create Users TABLE_HASH_KEY ShortText
1476
1477
  # [[0, 1337566253.89858, 0.000355720520019531], true]
@@ -1562,10 +1563,10 @@ select Users
1562
1563
  # ]
1563
1564
  </pre></div>
1564
1565
  </div>
1565
- <p>The first <tt class="docutils literal"><span class="pre">select</span></tt> command sets <tt class="docutils literal"><span class="pre">age</span></tt> column value of all records
1566
- to <tt class="docutils literal"><span class="pre">19</span></tt>. The second <tt class="docutils literal"><span class="pre">select</span></tt> command outputs updated <tt class="docutils literal"><span class="pre">age</span></tt>
1566
+ <p>The first <code class="docutils literal"><span class="pre">select</span></code> command sets <code class="docutils literal"><span class="pre">age</span></code> column value of all records
1567
+ to <code class="docutils literal"><span class="pre">19</span></code>. The second <code class="docutils literal"><span class="pre">select</span></code> command outputs updated <code class="docutils literal"><span class="pre">age</span></code>
1567
1568
  column values.</p>
1568
- <p>Here is a usage example of <tt class="docutils literal"><span class="pre">ALLOW_LEADING_NOT</span></tt>.</p>
1569
+ <p>Here is a usage example of <code class="docutils literal"><span class="pre">ALLOW_LEADING_NOT</span></code>.</p>
1569
1570
  <p>Execution example:</p>
1570
1571
  <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query -mroonga --query_flags ALLOW_LEADING_NOT
1571
1572
  # [
@@ -1634,9 +1635,9 @@ column values.</p>
1634
1635
  # ]
1635
1636
  </pre></div>
1636
1637
  </div>
1637
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command searches records that don't contain <tt class="docutils literal"><span class="pre">mroonga</span></tt>
1638
- in <tt class="docutils literal"><span class="pre">content</span></tt> column value from <tt class="docutils literal"><span class="pre">Entries</span></tt> table.</p>
1639
- <p>Here is a usage example of <tt class="docutils literal"><span class="pre">NONE</span></tt>.</p>
1638
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that don't contain <code class="docutils literal"><span class="pre">mroonga</span></code>
1639
+ in <code class="docutils literal"><span class="pre">content</span></code> column value from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
1640
+ <p>Here is a usage example of <code class="docutils literal"><span class="pre">NONE</span></code>.</p>
1640
1641
  <p>Execution example:</p>
1641
1642
  <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query &#39;mroonga OR _key:Groonga&#39; --query_flags NONE
1642
1643
  # [
@@ -1684,38 +1685,38 @@ in <tt class="docutils literal"><span class="pre">content</span></tt> column val
1684
1685
  # ]
1685
1686
  </pre></div>
1686
1687
  </div>
1687
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command searches records that contain one of two words
1688
- <tt class="docutils literal"><span class="pre">mroonga</span></tt> or <tt class="docutils literal"><span class="pre">_key:Groonga</span></tt> in <tt class="docutils literal"><span class="pre">content</span></tt> from <tt class="docutils literal"><span class="pre">Entries</span></tt> table.
1689
- Note that <tt class="docutils literal"><span class="pre">_key:Groonga</span></tt> doesn't mean that the value of <tt class="docutils literal"><span class="pre">_key</span></tt>
1690
- column is equal to <tt class="docutils literal"><span class="pre">Groonga</span></tt>. Because <tt class="docutils literal"><span class="pre">ALLOW_COLUMN</span></tt> flag is not
1688
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain one of two words
1689
+ <code class="docutils literal"><span class="pre">mroonga</span></code> or <code class="docutils literal"><span class="pre">_key:Groonga</span></code> in <code class="docutils literal"><span class="pre">content</span></code> from <code class="docutils literal"><span class="pre">Entries</span></code> table.
1690
+ Note that <code class="docutils literal"><span class="pre">_key:Groonga</span></code> doesn't mean that the value of <code class="docutils literal"><span class="pre">_key</span></code>
1691
+ column is equal to <code class="docutils literal"><span class="pre">Groonga</span></code>. Because <code class="docutils literal"><span class="pre">ALLOW_COLUMN</span></code> flag is not
1691
1692
  specified.</p>
1692
1693
  <p>See also <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a>.</p>
1693
1694
  </div>
1694
1695
  <div class="section" id="query-expander">
1695
- <span id="id5"></span><h4>7.3.36.4.3.4. <tt class="docutils literal"><span class="pre">query_expander</span></tt><a class="headerlink" href="#query-expander" title="Permalink to this headline">¶</a></h4>
1696
+ <span id="select-query-expander"></span><h4>7.3.41.4.3.4. <code class="docutils literal"><span class="pre">query_expander</span></code><a class="headerlink" href="#query-expander" title="Permalink to this headline">¶</a></h4>
1696
1697
  <p>It's for query expansion. Query expansion substitutes specific words
1697
1698
  to another words in query. Nomally, it's used for synonym search.</p>
1698
- <p>It specifies a column that is used to substitute <tt class="docutils literal"><span class="pre">query</span></tt> parameter
1699
+ <p>It specifies a column that is used to substitute <code class="docutils literal"><span class="pre">query</span></code> parameter
1699
1700
  value. The format of this parameter value is
1700
- &quot;<tt class="docutils literal"><span class="pre">${TABLE}.${COLUMN}</span></tt>&quot;. For example, &quot;<tt class="docutils literal"><span class="pre">Terms.synonym</span></tt>&quot; specifies
1701
- <tt class="docutils literal"><span class="pre">synonym</span></tt> column in <tt class="docutils literal"><span class="pre">Terms</span></tt> table.</p>
1701
+ &quot;<code class="docutils literal"><span class="pre">${TABLE}.${COLUMN}</span></code>&quot;. For example, &quot;<code class="docutils literal"><span class="pre">Terms.synonym</span></code>&quot; specifies
1702
+ <code class="docutils literal"><span class="pre">synonym</span></code> column in <code class="docutils literal"><span class="pre">Terms</span></code> table.</p>
1702
1703
  <p>Table for query expansion is called &quot;substitution table&quot;. Substitution
1703
- table's key must be <tt class="docutils literal"><span class="pre">ShortText</span></tt>. So array table (<tt class="docutils literal"><span class="pre">TABLE_NO_KEY</span></tt>)
1704
+ table's key must be <code class="docutils literal"><span class="pre">ShortText</span></code>. So array table (<code class="docutils literal"><span class="pre">TABLE_NO_KEY</span></code>)
1704
1705
  can't be used for query expansion. Because array table doesn't have
1705
1706
  key.</p>
1706
1707
  <p>Column for query expansion is called &quot;substitution
1707
1708
  column&quot;. Substitution column's value type must be
1708
- <tt class="docutils literal"><span class="pre">ShortText</span></tt>. Column type must be vector (<tt class="docutils literal"><span class="pre">COLUMN_VECTOR</span></tt>).</p>
1709
+ <code class="docutils literal"><span class="pre">ShortText</span></code>. Column type must be vector (<code class="docutils literal"><span class="pre">COLUMN_VECTOR</span></code>).</p>
1709
1710
  <p>Query expansion substitutes key of substitution table in query with
1710
- values in substitution column. If a word in <tt class="docutils literal"><span class="pre">query</span></tt> is a key of
1711
+ values in substitution column. If a word in <code class="docutils literal"><span class="pre">query</span></code> is a key of
1711
1712
  substitution table, the word is substituted with substitution column
1712
1713
  value that is associated with the key. Substition isn't performed
1713
1714
  recursively. It means that substitution target words in substituted
1714
1715
  query aren't substituted.</p>
1715
1716
  <p>Here is a sample substitution table to show a simple
1716
- <tt class="docutils literal"><span class="pre">query_expander</span></tt> usage example.</p>
1717
+ <code class="docutils literal"><span class="pre">query_expander</span></code> usage example.</p>
1717
1718
  <p>Execution example:</p>
1718
- <div class="highlight-none"><div class="highlight"><pre>table_create Thesaurus TABLE_PAT_KEY|KEY_NORMALIZE ShortText
1719
+ <div class="highlight-none"><div class="highlight"><pre>table_create Thesaurus TABLE_PAT_KEY ShortText --normalizer NormalizerAuto
1719
1720
  # [[0, 1337566253.89858, 0.000355720520019531], true]
1720
1721
  column_create Thesaurus synonym COLUMN_VECTOR ShortText
1721
1722
  # [[0, 1337566253.89858, 0.000355720520019531], true]
@@ -1727,22 +1728,24 @@ load --table Thesaurus
1727
1728
  # [[0, 1337566253.89858, 0.000355720520019531], 2]
1728
1729
  </pre></div>
1729
1730
  </div>
1730
- <p><tt class="docutils literal"><span class="pre">Thesaurus</span></tt> substitution table has two synonyms, <tt class="docutils literal"><span class="pre">&quot;mroonga&quot;</span></tt> and
1731
- <tt class="docutils literal"><span class="pre">&quot;groonga&quot;</span></tt>. If an user searches with <tt class="docutils literal"><span class="pre">&quot;mroonga&quot;</span></tt>, groonga
1732
- searches with <tt class="docutils literal"><span class="pre">&quot;((mroonga)</span> <span class="pre">OR</span> <span class="pre">(tritonn)</span> <span class="pre">OR</span> <span class="pre">(groonga</span> <span class="pre">mysql))&quot;</span></tt>. If an
1733
- user searches with <tt class="docutils literal"><span class="pre">&quot;groonga&quot;</span></tt>, groonga searches with <tt class="docutils literal"><span class="pre">&quot;((groonga)</span>
1734
- <span class="pre">OR</span> <span class="pre">(senna))&quot;</span></tt>. Nomrally, it's good idea that substitution table has
1735
- <tt class="docutils literal"><span class="pre">KEY_NORMALIZE</span></tt> flag. If the flag is used, substitute target word is
1736
- matched in case insensitive manner.</p>
1731
+ <p><code class="docutils literal"><span class="pre">Thesaurus</span></code> substitution table has two synonyms, <code class="docutils literal"><span class="pre">&quot;mroonga&quot;</span></code> and
1732
+ <code class="docutils literal"><span class="pre">&quot;groonga&quot;</span></code>. If an user searches with <code class="docutils literal"><span class="pre">&quot;mroonga&quot;</span></code>, Groonga
1733
+ searches with <code class="docutils literal"><span class="pre">&quot;((mroonga)</span> <span class="pre">OR</span> <span class="pre">(tritonn)</span> <span class="pre">OR</span> <span class="pre">(groonga</span> <span class="pre">mysql))&quot;</span></code>. If an
1734
+ user searches with <code class="docutils literal"><span class="pre">&quot;groonga&quot;</span></code>, Groonga searches with <code class="docutils literal"><span class="pre">&quot;((groonga)</span>
1735
+ <span class="pre">OR</span> <span class="pre">(senna))&quot;</span></code>.</p>
1736
+ <p>Normally, it's good idea that substitution table uses a
1737
+ normalizer. For example, if normalizer is used, substitute target word
1738
+ is matched in case insensitive manner. See
1739
+ <a class="reference internal" href="../normalizers.html"><em>Normalizers</em></a> for available normalizers.</p>
1737
1740
  <p>Note that those synonym values include the key value such as
1738
- <tt class="docutils literal"><span class="pre">&quot;mroonga&quot;</span></tt> and <tt class="docutils literal"><span class="pre">&quot;groonga&quot;</span></tt>. It's recommended that you include the
1741
+ <code class="docutils literal"><span class="pre">&quot;mroonga&quot;</span></code> and <code class="docutils literal"><span class="pre">&quot;groonga&quot;</span></code>. It's recommended that you include the
1739
1742
  key value. If you don't include key value, substituted value doesn't
1740
1743
  include the original substitute target value. Normally, including the
1741
1744
  original value is better search result. If you have a word that you
1742
1745
  don't want to be searched, you should not include the original
1743
1746
  word. For example, you can implement &quot;stop words&quot; by an empty vector
1744
1747
  value.</p>
1745
- <p>Here is a simple <tt class="docutils literal"><span class="pre">query_expander</span></tt> usage example.</p>
1748
+ <p>Here is a simple <code class="docutils literal"><span class="pre">query_expander</span></code> usage example.</p>
1746
1749
  <p>Execution example:</p>
1747
1750
  <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query &quot;mroonga&quot;
1748
1751
  # [
@@ -1892,13 +1895,13 @@ select Entries --match_columns content --query &quot;((mroonga) OR (tritonn) OR
1892
1895
  # ]
1893
1896
  </pre></div>
1894
1897
  </div>
1895
- <p>The first <tt class="docutils literal"><span class="pre">select</span></tt> command doesn't use query expansion. So a record
1896
- that has <tt class="docutils literal"><span class="pre">&quot;tritonn&quot;</span></tt> isn't found. The second <tt class="docutils literal"><span class="pre">select</span></tt> command uses
1897
- query expansion. So a record that has <tt class="docutils literal"><span class="pre">&quot;tritonn&quot;</span></tt> is found. The
1898
- third <tt class="docutils literal"><span class="pre">select</span></tt> command doesn't use query expansion but it is same as
1899
- the second <tt class="docutils literal"><span class="pre">select</span></tt> command. The third one uses expanded query.</p>
1898
+ <p>The first <code class="docutils literal"><span class="pre">select</span></code> command doesn't use query expansion. So a record
1899
+ that has <code class="docutils literal"><span class="pre">&quot;tritonn&quot;</span></code> isn't found. The second <code class="docutils literal"><span class="pre">select</span></code> command uses
1900
+ query expansion. So a record that has <code class="docutils literal"><span class="pre">&quot;tritonn&quot;</span></code> is found. The
1901
+ third <code class="docutils literal"><span class="pre">select</span></code> command doesn't use query expansion but it is same as
1902
+ the second <code class="docutils literal"><span class="pre">select</span></code> command. The third one uses expanded query.</p>
1900
1903
  <p>Each substitute value can contain any <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a> syntax
1901
- such as <tt class="docutils literal"><span class="pre">(...)</span></tt> and <tt class="docutils literal"><span class="pre">OR</span></tt>. You can use complex substitution by
1904
+ such as <code class="docutils literal"><span class="pre">(...)</span></code> and <code class="docutils literal"><span class="pre">OR</span></code>. You can use complex substitution by
1902
1905
  using those syntax.</p>
1903
1906
  <p>Here is a complex substitution usage example that uses query syntax.</p>
1904
1907
  <p>Execution example:</p>
@@ -1960,20 +1963,20 @@ select Entries --match_columns content --query &quot;popular&quot; --query_expan
1960
1963
  # ]
1961
1964
  </pre></div>
1962
1965
  </div>
1963
- <p>The <tt class="docutils literal"><span class="pre">load</span></tt> command registers a new synonym <tt class="docutils literal"><span class="pre">&quot;popular&quot;</span></tt>. It is
1964
- substituted with <tt class="docutils literal"><span class="pre">((popular)</span> <span class="pre">OR</span> <span class="pre">(n_likes:&gt;=10))</span></tt>. The substituted
1966
+ <p>The <code class="docutils literal"><span class="pre">load</span></code> command registers a new synonym <code class="docutils literal"><span class="pre">&quot;popular&quot;</span></code>. It is
1967
+ substituted with <code class="docutils literal"><span class="pre">((popular)</span> <span class="pre">OR</span> <span class="pre">(n_likes:&gt;=10))</span></code>. The substituted
1965
1968
  query means that &quot;popular&quot; is containing the word &quot;popular&quot; or 10 or
1966
1969
  more liked entries.</p>
1967
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs records that <tt class="docutils literal"><span class="pre">n_likes</span></tt> column value
1968
- is equal to or more than <tt class="docutils literal"><span class="pre">10</span></tt> from <tt class="docutils literal"><span class="pre">Entries</span></tt> table.</p>
1970
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs records that <code class="docutils literal"><span class="pre">n_likes</span></code> column value
1971
+ is equal to or more than <code class="docutils literal"><span class="pre">10</span></code> from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
1969
1972
  </div>
1970
1973
  </div>
1971
1974
  <div class="section" id="output-related-parameters">
1972
- <h3>7.3.36.4.4. Output related parameters<a class="headerlink" href="#output-related-parameters" title="Permalink to this headline">¶</a></h3>
1975
+ <h3>7.3.41.4.4. Output related parameters<a class="headerlink" href="#output-related-parameters" title="Permalink to this headline">¶</a></h3>
1973
1976
  <div class="section" id="output-columns">
1974
- <span id="select-output-columns"></span><h4>7.3.36.4.4.1. <tt class="docutils literal"><span class="pre">output_columns</span></tt><a class="headerlink" href="#output-columns" title="Permalink to this headline">¶</a></h4>
1975
- <p>Specifies output columns separated by <tt class="docutils literal"><span class="pre">,</span></tt>.</p>
1976
- <p>Here is a simple <tt class="docutils literal"><span class="pre">output_columns</span></tt> usage example.</p>
1977
+ <span id="select-output-columns"></span><h4>7.3.41.4.4.1. <code class="docutils literal"><span class="pre">output_columns</span></code><a class="headerlink" href="#output-columns" title="Permalink to this headline">¶</a></h4>
1978
+ <p>Specifies output columns separated by <code class="docutils literal"><span class="pre">,</span></code>.</p>
1979
+ <p>Here is a simple <code class="docutils literal"><span class="pre">output_columns</span></code> usage example.</p>
1977
1980
  <p>Execution example:</p>
1978
1981
  <div class="highlight-none"><div class="highlight"><pre>select Entries --output_columns &#39;_id, _key&#39; --limit 1
1979
1982
  # [
@@ -2006,11 +2009,11 @@ is equal to or more than <tt class="docutils literal"><span class="pre">10</span
2006
2009
  # ]
2007
2010
  </pre></div>
2008
2011
  </div>
2009
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command just outputs <tt class="docutils literal"><span class="pre">_id</span></tt> and <tt class="docutils literal"><span class="pre">_key</span></tt> column
2012
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command just outputs <code class="docutils literal"><span class="pre">_id</span></code> and <code class="docutils literal"><span class="pre">_key</span></code> column
2010
2013
  values.</p>
2011
- <p><tt class="docutils literal"><span class="pre">*</span></tt> is a special value. It means that all columns that are not
2014
+ <p><code class="docutils literal"><span class="pre">*</span></code> is a special value. It means that all columns that are not
2012
2015
  <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a>.</p>
2013
- <p>Here is a <tt class="docutils literal"><span class="pre">*</span></tt> usage example.</p>
2016
+ <p>Here is a <code class="docutils literal"><span class="pre">*</span></code> usage example.</p>
2014
2017
  <p>Execution example:</p>
2015
2018
  <div class="highlight-none"><div class="highlight"><pre>select Entries --output_columns &#39;_key, *&#39; --limit 1
2016
2019
  # [
@@ -2053,17 +2056,17 @@ values.</p>
2053
2056
  # ]
2054
2057
  </pre></div>
2055
2058
  </div>
2056
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs <tt class="docutils literal"><span class="pre">_key</span></tt> pseudo column, <tt class="docutils literal"><span class="pre">content</span></tt>
2057
- column and <tt class="docutils literal"><span class="pre">n_likes</span></tt> column values but doesn't output <tt class="docutils literal"><span class="pre">_id</span></tt> pseudo
2059
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs <code class="docutils literal"><span class="pre">_key</span></code> pseudo column, <code class="docutils literal"><span class="pre">content</span></code>
2060
+ column and <code class="docutils literal"><span class="pre">n_likes</span></code> column values but doesn't output <code class="docutils literal"><span class="pre">_id</span></code> pseudo
2058
2061
  column value.</p>
2059
- <p>The default value is <tt class="docutils literal"><span class="pre">_id,</span> <span class="pre">_key,</span> <span class="pre">*</span></tt>. It means that all column
2060
- values except <tt class="docutils literal"><span class="pre">_score</span></tt> are outputted.</p>
2062
+ <p>The default value is <code class="docutils literal"><span class="pre">_id,</span> <span class="pre">_key,</span> <span class="pre">*</span></code>. It means that all column
2063
+ values except <code class="docutils literal"><span class="pre">_score</span></code> are outputted.</p>
2061
2064
  </div>
2062
2065
  <div class="section" id="sortby">
2063
- <span id="select-sortby"></span><h4>7.3.36.4.4.2. <tt class="docutils literal"><span class="pre">sortby</span></tt><a class="headerlink" href="#sortby" title="Permalink to this headline">¶</a></h4>
2064
- <p>Specifies sort keys separated by <tt class="docutils literal"><span class="pre">,</span></tt>. Each sort key is column
2066
+ <span id="select-sortby"></span><h4>7.3.41.4.4.2. <code class="docutils literal"><span class="pre">sortby</span></code><a class="headerlink" href="#sortby" title="Permalink to this headline">¶</a></h4>
2067
+ <p>Specifies sort keys separated by <code class="docutils literal"><span class="pre">,</span></code>. Each sort key is column
2065
2068
  name.</p>
2066
- <p>Here is a simple <tt class="docutils literal"><span class="pre">sortby</span></tt> usage example.</p>
2069
+ <p>Here is a simple <code class="docutils literal"><span class="pre">sortby</span></code> usage example.</p>
2067
2070
  <p>Execution example:</p>
2068
2071
  <div class="highlight-none"><div class="highlight"><pre>select Entries --sortby &#39;n_likes, _id&#39;
2069
2072
  # [
@@ -2139,12 +2142,12 @@ name.</p>
2139
2142
  # ]
2140
2143
  </pre></div>
2141
2144
  </div>
2142
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command sorts by <tt class="docutils literal"><span class="pre">n_likes</span></tt> column value in ascending
2143
- order. For records that has the same <tt class="docutils literal"><span class="pre">n_likes</span></tt> are sorted by <tt class="docutils literal"><span class="pre">_id</span></tt>
2144
- in ascending order. <tt class="docutils literal"><span class="pre">&quot;Good-bye</span> <span class="pre">Senna&quot;</span></tt> and <tt class="docutils literal"><span class="pre">&quot;Good-bye</span> <span class="pre">Tritonn&quot;</span></tt>
2145
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command sorts by <code class="docutils literal"><span class="pre">n_likes</span></code> column value in ascending
2146
+ order. For records that has the same <code class="docutils literal"><span class="pre">n_likes</span></code> are sorted by <code class="docutils literal"><span class="pre">_id</span></code>
2147
+ in ascending order. <code class="docutils literal"><span class="pre">&quot;Good-bye</span> <span class="pre">Senna&quot;</span></code> and <code class="docutils literal"><span class="pre">&quot;Good-bye</span> <span class="pre">Tritonn&quot;</span></code>
2145
2148
  are the case.</p>
2146
- <p>If you want to sort in descending order, add <tt class="docutils literal"><span class="pre">-</span></tt> before column name.</p>
2147
- <p>Here is a descending order <tt class="docutils literal"><span class="pre">sortby</span></tt> usage example.</p>
2149
+ <p>If you want to sort in descending order, add <code class="docutils literal"><span class="pre">-</span></code> before column name.</p>
2150
+ <p>Here is a descending order <code class="docutils literal"><span class="pre">sortby</span></code> usage example.</p>
2148
2151
  <p>Execution example:</p>
2149
2152
  <div class="highlight-none"><div class="highlight"><pre>select Entries --sortby &#39;-n_likes, _id&#39;
2150
2153
  # [
@@ -2220,10 +2223,10 @@ are the case.</p>
2220
2223
  # ]
2221
2224
  </pre></div>
2222
2225
  </div>
2223
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command sorts by <tt class="docutils literal"><span class="pre">n_likes</span></tt> column value in descending
2224
- order. But ascending order is used for sorting by <tt class="docutils literal"><span class="pre">_id</span></tt>.</p>
2225
- <p>You can use <tt class="docutils literal"><span class="pre">_score</span></tt> pseudo column in <tt class="docutils literal"><span class="pre">sortby</span></tt> if you use
2226
- <tt class="docutils literal"><span class="pre">query</span></tt> or <tt class="docutils literal"><span class="pre">filter</span></tt> parameter.</p>
2226
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command sorts by <code class="docutils literal"><span class="pre">n_likes</span></code> column value in descending
2227
+ order. But ascending order is used for sorting by <code class="docutils literal"><span class="pre">_id</span></code>.</p>
2228
+ <p>You can use <code class="docutils literal"><span class="pre">_score</span></code> pseudo column in <code class="docutils literal"><span class="pre">sortby</span></code> if you use
2229
+ <code class="docutils literal"><span class="pre">query</span></code> or <code class="docutils literal"><span class="pre">filter</span></code> parameter.</p>
2227
2230
  <p>Execution example:</p>
2228
2231
  <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query fast --sortby -_score --output_columns &#39;_key, _score&#39;
2229
2232
  # [
@@ -2260,15 +2263,15 @@ order. But ascending order is used for sorting by <tt class="docutils literal"><
2260
2263
  # ]
2261
2264
  </pre></div>
2262
2265
  </div>
2263
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command sorts matched records by hit score in
2266
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command sorts matched records by hit score in
2264
2267
  descending order and outputs record key and hit score.</p>
2265
- <p>If you use <tt class="docutils literal"><span class="pre">_score</span></tt> without <tt class="docutils literal"><span class="pre">query</span></tt> nor <tt class="docutils literal"><span class="pre">filter</span></tt> parameters,
2268
+ <p>If you use <code class="docutils literal"><span class="pre">_score</span></code> without <code class="docutils literal"><span class="pre">query</span></code> nor <code class="docutils literal"><span class="pre">filter</span></code> parameters,
2266
2269
  it's just ignored but get a warning in log file.</p>
2267
2270
  </div>
2268
2271
  <div class="section" id="offset">
2269
- <span id="select-offset"></span><h4>7.3.36.4.4.3. <tt class="docutils literal"><span class="pre">offset</span></tt><a class="headerlink" href="#offset" title="Permalink to this headline">¶</a></h4>
2272
+ <span id="select-offset"></span><h4>7.3.41.4.4.3. <code class="docutils literal"><span class="pre">offset</span></code><a class="headerlink" href="#offset" title="Permalink to this headline">¶</a></h4>
2270
2273
  <p>Specifies offset to determine output records range. Offset is
2271
- zero-based. <tt class="docutils literal"><span class="pre">--offset</span> <span class="pre">1</span></tt> means output range is started from the 2nd
2274
+ zero-based. <code class="docutils literal"><span class="pre">--offset</span> <span class="pre">1</span></code> means output range is started from the 2nd
2272
2275
  record.</p>
2273
2276
  <p>Execution example:</p>
2274
2277
  <div class="highlight-none"><div class="highlight"><pre>select Entries --sortby _id --offset 3 --output_columns _key
@@ -2300,10 +2303,10 @@ record.</p>
2300
2303
  # ]
2301
2304
  </pre></div>
2302
2305
  </div>
2303
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs from the 4th record.</p>
2304
- <p>You can specify negative value. It means that <tt class="docutils literal"><span class="pre">the</span> <span class="pre">number</span> <span class="pre">of</span> <span class="pre">matched</span>
2305
- <span class="pre">records</span> <span class="pre">+</span> <span class="pre">offset</span></tt>. If you have 3 matched records and specify
2306
- <tt class="docutils literal"><span class="pre">--offset</span> <span class="pre">-2</span></tt>, you get records from the 2nd (<tt class="docutils literal"><span class="pre">3</span> <span class="pre">+</span> <span class="pre">-2</span> <span class="pre">=</span> <span class="pre">1</span></tt>. <tt class="docutils literal"><span class="pre">1</span></tt>
2306
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs from the 4th record.</p>
2307
+ <p>You can specify negative value. It means that <code class="docutils literal"><span class="pre">the</span> <span class="pre">number</span> <span class="pre">of</span> <span class="pre">matched</span>
2308
+ <span class="pre">records</span> <span class="pre">+</span> <span class="pre">offset</span></code>. If you have 3 matched records and specify
2309
+ <code class="docutils literal"><span class="pre">--offset</span> <span class="pre">-2</span></code>, you get records from the 2nd (<code class="docutils literal"><span class="pre">3</span> <span class="pre">+</span> <span class="pre">-2</span> <span class="pre">=</span> <span class="pre">1</span></code>. <code class="docutils literal"><span class="pre">1</span></code>
2307
2310
  means 2nd. Remember that offset is zero-based.) record to the 3rd
2308
2311
  record.</p>
2309
2312
  <p>Execution example:</p>
@@ -2336,15 +2339,15 @@ record.</p>
2336
2339
  # ]
2337
2340
  </pre></div>
2338
2341
  </div>
2339
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs from the 4th record because the total
2340
- number of records is <tt class="docutils literal"><span class="pre">5</span></tt>.</p>
2341
- <p>The default value is <tt class="docutils literal"><span class="pre">0</span></tt>.</p>
2342
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs from the 4th record because the total
2343
+ number of records is <code class="docutils literal"><span class="pre">5</span></code>.</p>
2344
+ <p>The default value is <code class="docutils literal"><span class="pre">0</span></code>.</p>
2342
2345
  </div>
2343
2346
  <div class="section" id="limit">
2344
- <h4>7.3.36.4.4.4. <tt class="docutils literal"><span class="pre">limit</span></tt><a class="headerlink" href="#limit" title="Permalink to this headline">¶</a></h4>
2347
+ <span id="select-limit"></span><h4>7.3.41.4.4.4. <code class="docutils literal"><span class="pre">limit</span></code><a class="headerlink" href="#limit" title="Permalink to this headline">¶</a></h4>
2345
2348
  <p>Specifies the max number of output records. If the number of
2346
- matched records is less than <tt class="docutils literal"><span class="pre">limit</span></tt>, all records are outputted.</p>
2347
- <p>Here is a simple <tt class="docutils literal"><span class="pre">limit</span></tt> usage example.</p>
2349
+ matched records is less than <code class="docutils literal"><span class="pre">limit</span></code>, all records are outputted.</p>
2350
+ <p>Here is a simple <code class="docutils literal"><span class="pre">limit</span></code> usage example.</p>
2348
2351
  <p>Execution example:</p>
2349
2352
  <div class="highlight-none"><div class="highlight"><pre>select Entries --sortby _id --offset 2 --limit 3 --output_columns _key
2350
2353
  # [
@@ -2378,11 +2381,11 @@ matched records is less than <tt class="docutils literal"><span class="pre">limi
2378
2381
  # ]
2379
2382
  </pre></div>
2380
2383
  </div>
2381
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs the 3rd, the 4th and the 5th records.</p>
2382
- <p>You can specify negative value. It means that <tt class="docutils literal"><span class="pre">the</span> <span class="pre">number</span> <span class="pre">of</span> <span class="pre">matched</span>
2383
- <span class="pre">records</span> <span class="pre">+</span> <span class="pre">limit</span> <span class="pre">+</span> <span class="pre">1</span></tt>. For example, <tt class="docutils literal"><span class="pre">--limit</span> <span class="pre">-1</span></tt> outputs all
2384
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs the 3rd, the 4th and the 5th records.</p>
2385
+ <p>You can specify negative value. It means that <code class="docutils literal"><span class="pre">the</span> <span class="pre">number</span> <span class="pre">of</span> <span class="pre">matched</span>
2386
+ <span class="pre">records</span> <span class="pre">+</span> <span class="pre">limit</span> <span class="pre">+</span> <span class="pre">1</span></code>. For example, <code class="docutils literal"><span class="pre">--limit</span> <span class="pre">-1</span></code> outputs all
2384
2387
  records. It's very useful value to show all records.</p>
2385
- <p>Here is a simple negative <tt class="docutils literal"><span class="pre">limit</span></tt> value usage example.</p>
2388
+ <p>Here is a simple negative <code class="docutils literal"><span class="pre">limit</span></code> value usage example.</p>
2386
2389
  <p>Execution example:</p>
2387
2390
  <div class="highlight-none"><div class="highlight"><pre>select Entries --limit -1
2388
2391
  # [
@@ -2458,27 +2461,27 @@ records. It's very useful value to show all records.</p>
2458
2461
  # ]
2459
2462
  </pre></div>
2460
2463
  </div>
2461
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs all records.</p>
2462
- <p>The default value is <tt class="docutils literal"><span class="pre">10</span></tt>.</p>
2464
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs all records.</p>
2465
+ <p>The default value is <code class="docutils literal"><span class="pre">10</span></code>.</p>
2463
2466
  </div>
2464
2467
  <div class="section" id="scorer">
2465
- <h4>7.3.36.4.4.5. <tt class="docutils literal"><span class="pre">scorer</span></tt><a class="headerlink" href="#scorer" title="Permalink to this headline">¶</a></h4>
2468
+ <span id="select-scorer"></span><h4>7.3.41.4.4.5. <code class="docutils literal"><span class="pre">scorer</span></code><a class="headerlink" href="#scorer" title="Permalink to this headline">¶</a></h4>
2466
2469
  <p>TODO: write in English and add example.</p>
2467
2470
  <p>検索条件にマッチする全てのレコードに対して適用するgrn_exprをscript形式で指定します。</p>
2468
2471
  <p>scorerは、検索処理が完了し、ソート処理が実行される前に呼び出されます。従って、各レコードのスコアを操作する式を指定しておけば、検索結果のソート順序をカスタマイズできるようになります。</p>
2469
2472
  </div>
2470
2473
  </div>
2471
2474
  <div class="section" id="drilldown-related-parameters">
2472
- <span id="select-drilldown-related-parameters"></span><h3>7.3.36.4.5. Drilldown related parameters<a class="headerlink" href="#drilldown-related-parameters" title="Permalink to this headline">¶</a></h3>
2475
+ <span id="select-drilldown-related-parameters"></span><h3>7.3.41.4.5. Drilldown related parameters<a class="headerlink" href="#drilldown-related-parameters" title="Permalink to this headline">¶</a></h3>
2473
2476
  <p>This section describes basic drilldown related parameters. Advanced
2474
2477
  drilldown related parameters are described in another section.</p>
2475
2478
  <div class="section" id="select-drilldown">
2476
- <span id="id6"></span><h4>7.3.36.4.5.1. <tt class="docutils literal"><span class="pre">drilldown</span></tt><a class="headerlink" href="#select-drilldown" title="Permalink to this headline">¶</a></h4>
2477
- <p>Specifies keys for grouping separated by <tt class="docutils literal"><span class="pre">,</span></tt>.</p>
2479
+ <span id="id2"></span><h4>7.3.41.4.5.1. <code class="docutils literal"><span class="pre">drilldown</span></code><a class="headerlink" href="#select-drilldown" title="Permalink to this headline">¶</a></h4>
2480
+ <p>Specifies keys for grouping separated by <code class="docutils literal"><span class="pre">,</span></code>.</p>
2478
2481
  <p>Matched records by specified search conditions are grouped by each
2479
2482
  key. If you specify no search condition, all records are grouped by
2480
2483
  each key.</p>
2481
- <p>Here is a simple <tt class="docutils literal"><span class="pre">drilldown</span></tt> example:</p>
2484
+ <p>Here is a simple <code class="docutils literal"><span class="pre">drilldown</span></code> example:</p>
2482
2485
  <p>Execution example:</p>
2483
2486
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
2484
2487
  --output_columns _key,tag \
@@ -2556,7 +2559,7 @@ each key.</p>
2556
2559
  # ]
2557
2560
  </pre></div>
2558
2561
  </div>
2559
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs the following information:</p>
2562
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs the following information:</p>
2560
2563
  <blockquote>
2561
2564
  <div><ul class="simple">
2562
2565
  <li>There is one record that has &quot;Hello&quot; tag.</li>
@@ -2564,7 +2567,7 @@ each key.</p>
2564
2567
  <li>There is two records that has &quot;Senna&quot; tag.</li>
2565
2568
  </ul>
2566
2569
  </div></blockquote>
2567
- <p>Here is a <tt class="docutils literal"><span class="pre">drilldown</span></tt> with search condition example:</p>
2570
+ <p>Here is a <code class="docutils literal"><span class="pre">drilldown</span></code> with search condition example:</p>
2568
2571
  <p>Execution example:</p>
2569
2572
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
2570
2573
  --output_columns _key,tag \
@@ -2631,17 +2634,17 @@ each key.</p>
2631
2634
  # ]
2632
2635
  </pre></div>
2633
2636
  </div>
2634
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs the following information:</p>
2637
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs the following information:</p>
2635
2638
  <blockquote>
2636
2639
  <div><ul class="simple">
2637
- <li>In records that have 5 or larger as <tt class="docutils literal"><span class="pre">n_likes</span></tt> value:<ul>
2640
+ <li>In records that have 5 or larger as <code class="docutils literal"><span class="pre">n_likes</span></code> value:<ul>
2638
2641
  <li>There is one record that has &quot;Hello&quot; tag.</li>
2639
2642
  <li>There is two records that has &quot;Groonga&quot; tag.</li>
2640
2643
  </ul>
2641
2644
  </li>
2642
2645
  </ul>
2643
2646
  </div></blockquote>
2644
- <p>Here is a <tt class="docutils literal"><span class="pre">drilldown</span></tt> with multiple group keys example:</p>
2647
+ <p>Here is a <code class="docutils literal"><span class="pre">drilldown</span></code> with multiple group keys example:</p>
2645
2648
  <p>Execution example:</p>
2646
2649
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
2647
2650
  --limit 0 \
@@ -2743,16 +2746,16 @@ each key.</p>
2743
2746
  # ]
2744
2747
  </pre></div>
2745
2748
  </div>
2746
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs the following information:</p>
2749
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs the following information:</p>
2747
2750
  <blockquote>
2748
2751
  <div><ul class="simple">
2749
- <li>About <tt class="docutils literal"><span class="pre">tag</span></tt>:<ul>
2752
+ <li>About <code class="docutils literal"><span class="pre">tag</span></code>:<ul>
2750
2753
  <li>There is one record that has &quot;Hello&quot; tag.</li>
2751
2754
  <li>There is two records that has &quot;Groonga&quot; tag.</li>
2752
2755
  <li>There is two records that has &quot;Senna&quot; tag.</li>
2753
2756
  </ul>
2754
2757
  </li>
2755
- <li>About <tt class="docutils literal"><span class="pre">n_likes</span></tt>:<ul>
2758
+ <li>About <code class="docutils literal"><span class="pre">n_likes</span></code>:<ul>
2756
2759
  <li>There is one record that has &quot;Hello&quot; tag.</li>
2757
2760
  <li>There is two records that has &quot;Groonga&quot; tag.</li>
2758
2761
  <li>There is two records that has &quot;Senna&quot; tag.</li>
@@ -2762,12 +2765,12 @@ each key.</p>
2762
2765
  </div></blockquote>
2763
2766
  </div>
2764
2767
  <div class="section" id="drilldown-sortby">
2765
- <span id="select-drilldown-sortby"></span><h4>7.3.36.4.5.2. <tt class="docutils literal"><span class="pre">drilldown_sortby</span></tt><a class="headerlink" href="#drilldown-sortby" title="Permalink to this headline">¶</a></h4>
2766
- <p>Specifies sort keys for drilldown outputs separated by <tt class="docutils literal"><span class="pre">,</span></tt>. Each
2768
+ <span id="select-drilldown-sortby"></span><h4>7.3.41.4.5.2. <code class="docutils literal"><span class="pre">drilldown_sortby</span></code><a class="headerlink" href="#drilldown-sortby" title="Permalink to this headline">¶</a></h4>
2769
+ <p>Specifies sort keys for drilldown outputs separated by <code class="docutils literal"><span class="pre">,</span></code>. Each
2767
2770
  sort key is column name.</p>
2768
- <p>You can refer the number of grouped records by <tt class="docutils literal"><span class="pre">_nsubrecs</span></tt>
2771
+ <p>You can refer the number of grouped records by <code class="docutils literal"><span class="pre">_nsubrecs</span></code>
2769
2772
  <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a>.</p>
2770
- <p>Here is a simple <tt class="docutils literal"><span class="pre">drilldown_sortby</span></tt> example:</p>
2773
+ <p>Here is a simple <code class="docutils literal"><span class="pre">drilldown_sortby</span></code> example:</p>
2771
2774
  <p>Execution example:</p>
2772
2775
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
2773
2776
  --limit 0 \
@@ -2871,10 +2874,10 @@ sort key is column name.</p>
2871
2874
  </pre></div>
2872
2875
  </div>
2873
2876
  <p>Drilldown result is sorted by the number of grouped records (=
2874
- <tt class="docutils literal"><span class="pre">_nsubrecs</span></tt> ) in descending order. If there are grouped results that
2877
+ <code class="docutils literal"><span class="pre">_nsubrecs</span></code> ) in descending order. If there are grouped results that
2875
2878
  the number of records in the group are the same, these grouped results
2876
- are sorted by grouped key (= <tt class="docutils literal"><span class="pre">_key</span></tt> ) in ascending order.</p>
2877
- <p>The sort keys are used in all group keys specified in <tt class="docutils literal"><span class="pre">drilldown</span></tt>:</p>
2879
+ are sorted by grouped key (= <code class="docutils literal"><span class="pre">_key</span></code> ) in ascending order.</p>
2880
+ <p>The sort keys are used in all group keys specified in <code class="docutils literal"><span class="pre">drilldown</span></code>:</p>
2878
2881
  <p>Execution example:</p>
2879
2882
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
2880
2883
  --limit 0 \
@@ -2977,15 +2980,15 @@ are sorted by grouped key (= <tt class="docutils literal"><span class="pre">_key
2977
2980
  # ]
2978
2981
  </pre></div>
2979
2982
  </div>
2980
- <p>The same sort keys are used in <tt class="docutils literal"><span class="pre">tag</span></tt> drilldown and <tt class="docutils literal"><span class="pre">n_likes</span></tt>
2983
+ <p>The same sort keys are used in <code class="docutils literal"><span class="pre">tag</span></code> drilldown and <code class="docutils literal"><span class="pre">n_likes</span></code>
2981
2984
  drilldown.</p>
2982
2985
  <p>If you want to use different sort keys for each drilldown, use
2983
- <a class="reference internal" href="#select-advanced-drilldown-related-parameters"><em>Advanced drilldown related parameters</em></a>.</p>
2986
+ <a class="reference internal" href="#select-advanced-drilldown-related-parameters"><span>Advanced drilldown related parameters</span></a>.</p>
2984
2987
  </div>
2985
2988
  <div class="section" id="drilldown-output-columns">
2986
- <span id="select-drilldown-output-columns"></span><h4>7.3.36.4.5.3. <tt class="docutils literal"><span class="pre">drilldown_output_columns</span></tt><a class="headerlink" href="#drilldown-output-columns" title="Permalink to this headline">¶</a></h4>
2987
- <p>Specifies output columns for drilldown separated by <tt class="docutils literal"><span class="pre">,</span></tt>.</p>
2988
- <p>Here is a <tt class="docutils literal"><span class="pre">drilldown_output_columns</span></tt> example:</p>
2989
+ <span id="select-drilldown-output-columns"></span><h4>7.3.41.4.5.3. <code class="docutils literal"><span class="pre">drilldown_output_columns</span></code><a class="headerlink" href="#drilldown-output-columns" title="Permalink to this headline">¶</a></h4>
2990
+ <p>Specifies output columns for drilldown separated by <code class="docutils literal"><span class="pre">,</span></code>.</p>
2991
+ <p>Here is a <code class="docutils literal"><span class="pre">drilldown_output_columns</span></code> example:</p>
2989
2992
  <p>Execution example:</p>
2990
2993
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
2991
2994
  --limit 0 \
@@ -3050,7 +3053,7 @@ drilldown.</p>
3050
3053
  # ]
3051
3054
  </pre></div>
3052
3055
  </div>
3053
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command just outputs grouped key.</p>
3056
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command just outputs grouped key.</p>
3054
3057
  <p>If grouped key is a referenced type column (= column that its type is
3055
3058
  a table), you can access column of the table referenced by the
3056
3059
  referenced type column.</p>
@@ -3082,10 +3085,10 @@ load --table Items
3082
3085
  # [[0, 1337566253.89858, 0.000355720520019531], 3]
3083
3086
  </pre></div>
3084
3087
  </div>
3085
- <p><tt class="docutils literal"><span class="pre">Tags</span></tt> table is a referenced table. <tt class="docutils literal"><span class="pre">Items.tag</span></tt> is a referenced
3088
+ <p><code class="docutils literal"><span class="pre">Tags</span></code> table is a referenced table. <code class="docutils literal"><span class="pre">Items.tag</span></code> is a referenced
3086
3089
  type column.</p>
3087
- <p>You can refer <tt class="docutils literal"><span class="pre">Tags.label</span></tt> by <tt class="docutils literal"><span class="pre">label</span></tt> in
3088
- <tt class="docutils literal"><span class="pre">drilldown_output_columns</span></tt>:</p>
3090
+ <p>You can refer <code class="docutils literal"><span class="pre">Tags.label</span></code> by <code class="docutils literal"><span class="pre">label</span></code> in
3091
+ <code class="docutils literal"><span class="pre">drilldown_output_columns</span></code>:</p>
3089
3092
  <p>Execution example:</p>
3090
3093
  <div class="highlight-none"><div class="highlight"><pre>select Items \
3091
3094
  --limit 0 \
@@ -3145,7 +3148,7 @@ type column.</p>
3145
3148
  # ]
3146
3149
  </pre></div>
3147
3150
  </div>
3148
- <p>You can use <tt class="docutils literal"><span class="pre">*</span></tt> to refer all columns in referenced table (= <tt class="docutils literal"><span class="pre">Tags</span></tt>):</p>
3151
+ <p>You can use <code class="docutils literal"><span class="pre">*</span></code> to refer all columns in referenced table (= <code class="docutils literal"><span class="pre">Tags</span></code>):</p>
3149
3152
  <p>Execution example:</p>
3150
3153
  <div class="highlight-none"><div class="highlight"><pre>select Items \
3151
3154
  --limit 0 \
@@ -3211,21 +3214,21 @@ type column.</p>
3211
3214
  # ]
3212
3215
  </pre></div>
3213
3216
  </div>
3214
- <p><tt class="docutils literal"><span class="pre">*</span></tt> is expanded to <tt class="docutils literal"><span class="pre">label,</span> <span class="pre">priority</span></tt>.</p>
3215
- <p>The default value of <tt class="docutils literal"><span class="pre">drilldown_output_columns</span></tt> is <tt class="docutils literal"><span class="pre">_key,</span>
3216
- <span class="pre">_nsubrecs</span></tt>. It means that grouped key and the number of records in
3217
+ <p><code class="docutils literal"><span class="pre">*</span></code> is expanded to <code class="docutils literal"><span class="pre">label,</span> <span class="pre">priority</span></code>.</p>
3218
+ <p>The default value of <code class="docutils literal"><span class="pre">drilldown_output_columns</span></code> is <code class="docutils literal"><span class="pre">_key,</span>
3219
+ <span class="pre">_nsubrecs</span></code>. It means that grouped key and the number of records in
3217
3220
  the group are output.</p>
3218
3221
  <p>You can use more <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> in
3219
- <tt class="docutils literal"><span class="pre">drilldown_output_columns</span></tt> such as <tt class="docutils literal"><span class="pre">_max</span></tt>, <tt class="docutils literal"><span class="pre">_min</span></tt>, <tt class="docutils literal"><span class="pre">_sum</span></tt> and
3220
- <tt class="docutils literal"><span class="pre">_avg</span></tt> when you use <a class="reference internal" href="#select-drilldown-calc-types"><em>drilldown_calc_types</em></a>. See
3221
- <tt class="docutils literal"><span class="pre">drilldown_calc_types</span></tt> document for details.</p>
3222
+ <code class="docutils literal"><span class="pre">drilldown_output_columns</span></code> such as <code class="docutils literal"><span class="pre">_max</span></code>, <code class="docutils literal"><span class="pre">_min</span></code>, <code class="docutils literal"><span class="pre">_sum</span></code> and
3223
+ <code class="docutils literal"><span class="pre">_avg</span></code> when you use <a class="reference internal" href="#select-drilldown-calc-types"><span>drilldown_calc_types</span></a>. See
3224
+ <code class="docutils literal"><span class="pre">drilldown_calc_types</span></code> document for details.</p>
3222
3225
  </div>
3223
3226
  <div class="section" id="drilldown-offset">
3224
- <span id="select-drilldown-offset"></span><h4>7.3.36.4.5.4. <tt class="docutils literal"><span class="pre">drilldown_offset</span></tt><a class="headerlink" href="#drilldown-offset" title="Permalink to this headline">¶</a></h4>
3227
+ <span id="select-drilldown-offset"></span><h4>7.3.41.4.5.4. <code class="docutils literal"><span class="pre">drilldown_offset</span></code><a class="headerlink" href="#drilldown-offset" title="Permalink to this headline">¶</a></h4>
3225
3228
  <p>Specifies offset to determine range of drilldown output
3226
- records. Offset is zero-based. <tt class="docutils literal"><span class="pre">--drilldown_offset</span> <span class="pre">1</span></tt> means output
3229
+ records. Offset is zero-based. <code class="docutils literal"><span class="pre">--drilldown_offset</span> <span class="pre">1</span></code> means output
3227
3230
  range is started from the 2nd record.</p>
3228
- <p>Here is a <tt class="docutils literal"><span class="pre">drilldown_offset</span></tt> example:</p>
3231
+ <p>Here is a <code class="docutils literal"><span class="pre">drilldown_offset</span></code> example:</p>
3229
3232
  <p>Execution example:</p>
3230
3233
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
3231
3234
  --limit 0 \
@@ -3294,11 +3297,11 @@ range is started from the 2nd record.</p>
3294
3297
  # ]
3295
3298
  </pre></div>
3296
3299
  </div>
3297
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs from the 2nd record.</p>
3298
- <p>You can specify negative value. It means that <tt class="docutils literal"><span class="pre">the</span> <span class="pre">number</span> <span class="pre">of</span> <span class="pre">grouped</span>
3299
- <span class="pre">results</span> <span class="pre">+</span> <span class="pre">offset</span></tt>. If you have 3 grouped results and specify
3300
- <tt class="docutils literal"><span class="pre">--drilldown_offset</span> <span class="pre">-2</span></tt>, you get grouped results from the 2st
3301
- (<tt class="docutils literal"><span class="pre">3</span> <span class="pre">+</span> <span class="pre">-2</span> <span class="pre">=</span> <span class="pre">1</span></tt>. <tt class="docutils literal"><span class="pre">1</span></tt> means 2nd. Remember that offset is zero-based.)
3300
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs from the 2nd record.</p>
3301
+ <p>You can specify negative value. It means that <code class="docutils literal"><span class="pre">the</span> <span class="pre">number</span> <span class="pre">of</span> <span class="pre">grouped</span>
3302
+ <span class="pre">results</span> <span class="pre">+</span> <span class="pre">offset</span></code>. If you have 3 grouped results and specify
3303
+ <code class="docutils literal"><span class="pre">--drilldown_offset</span> <span class="pre">-2</span></code>, you get grouped results from the 2st
3304
+ (<code class="docutils literal"><span class="pre">3</span> <span class="pre">+</span> <span class="pre">-2</span> <span class="pre">=</span> <span class="pre">1</span></code>. <code class="docutils literal"><span class="pre">1</span></code> means 2nd. Remember that offset is zero-based.)
3302
3305
  grouped result to the 3rd grouped result.</p>
3303
3306
  <p>Execution example:</p>
3304
3307
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
@@ -3368,15 +3371,15 @@ grouped result to the 3rd grouped result.</p>
3368
3371
  # ]
3369
3372
  </pre></div>
3370
3373
  </div>
3371
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs from the 2nd grouped result because the
3372
- total number of grouped results is <tt class="docutils literal"><span class="pre">3</span></tt>.</p>
3373
- <p>The default value of <tt class="docutils literal"><span class="pre">drilldown_offset</span></tt> is <tt class="docutils literal"><span class="pre">0</span></tt>.</p>
3374
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs from the 2nd grouped result because the
3375
+ total number of grouped results is <code class="docutils literal"><span class="pre">3</span></code>.</p>
3376
+ <p>The default value of <code class="docutils literal"><span class="pre">drilldown_offset</span></code> is <code class="docutils literal"><span class="pre">0</span></code>.</p>
3374
3377
  </div>
3375
3378
  <div class="section" id="drilldown-limit">
3376
- <span id="select-drilldown-limit"></span><h4>7.3.36.4.5.5. <tt class="docutils literal"><span class="pre">drilldown_limit</span></tt><a class="headerlink" href="#drilldown-limit" title="Permalink to this headline">¶</a></h4>
3379
+ <span id="select-drilldown-limit"></span><h4>7.3.41.4.5.5. <code class="docutils literal"><span class="pre">drilldown_limit</span></code><a class="headerlink" href="#drilldown-limit" title="Permalink to this headline">¶</a></h4>
3377
3380
  <p>Specifies the max number of groups in a drilldown. If the number of
3378
- groups is less than <tt class="docutils literal"><span class="pre">drilldown_limit</span></tt>, all groups are outputted.</p>
3379
- <p>Here is a <tt class="docutils literal"><span class="pre">drilldown_limit</span></tt> example:</p>
3381
+ groups is less than <code class="docutils literal"><span class="pre">drilldown_limit</span></code>, all groups are outputted.</p>
3382
+ <p>Here is a <code class="docutils literal"><span class="pre">drilldown_limit</span></code> example:</p>
3380
3383
  <p>Execution example:</p>
3381
3384
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
3382
3385
  --limit 0 \
@@ -3446,11 +3449,11 @@ groups is less than <tt class="docutils literal"><span class="pre">drilldown_lim
3446
3449
  # ]
3447
3450
  </pre></div>
3448
3451
  </div>
3449
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs the 2rd and the 3rd groups.</p>
3450
- <p>You can specify negative value. It means that <tt class="docutils literal"><span class="pre">the</span> <span class="pre">number</span> <span class="pre">of</span> <span class="pre">groups</span> <span class="pre">+</span>
3451
- <span class="pre">drilldown_limit</span> <span class="pre">+</span> <span class="pre">1</span></tt>. For example, <tt class="docutils literal"><span class="pre">--drilldown_limit</span> <span class="pre">-1</span></tt> outputs
3452
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs the 2rd and the 3rd groups.</p>
3453
+ <p>You can specify negative value. It means that <code class="docutils literal"><span class="pre">the</span> <span class="pre">number</span> <span class="pre">of</span> <span class="pre">groups</span> <span class="pre">+</span>
3454
+ <span class="pre">drilldown_limit</span> <span class="pre">+</span> <span class="pre">1</span></code>. For example, <code class="docutils literal"><span class="pre">--drilldown_limit</span> <span class="pre">-1</span></code> outputs
3452
3455
  all groups. It's very useful value to show all groups.</p>
3453
- <p>Here is a negative <tt class="docutils literal"><span class="pre">drilldown_limit</span></tt> value example.</p>
3456
+ <p>Here is a negative <code class="docutils literal"><span class="pre">drilldown_limit</span></code> value example.</p>
3454
3457
  <p>Execution example:</p>
3455
3458
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
3456
3459
  --limit 0 \
@@ -3523,19 +3526,19 @@ all groups. It's very useful value to show all groups.</p>
3523
3526
  # ]
3524
3527
  </pre></div>
3525
3528
  </div>
3526
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs all groups.</p>
3527
- <p>The default value of <tt class="docutils literal"><span class="pre">drilldown_limit</span></tt> is <tt class="docutils literal"><span class="pre">10</span></tt>.</p>
3529
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs all groups.</p>
3530
+ <p>The default value of <code class="docutils literal"><span class="pre">drilldown_limit</span></code> is <code class="docutils literal"><span class="pre">10</span></code>.</p>
3528
3531
  </div>
3529
3532
  <div class="section" id="drilldown-calc-types">
3530
- <span id="select-drilldown-calc-types"></span><h4>7.3.36.4.5.6. <tt class="docutils literal"><span class="pre">drilldown_calc_types</span></tt><a class="headerlink" href="#drilldown-calc-types" title="Permalink to this headline">¶</a></h4>
3533
+ <span id="select-drilldown-calc-types"></span><h4>7.3.41.4.5.6. <code class="docutils literal"><span class="pre">drilldown_calc_types</span></code><a class="headerlink" href="#drilldown-calc-types" title="Permalink to this headline">¶</a></h4>
3531
3534
  <p>Specifies how to calculate (aggregate) values in grouped records by
3532
3535
  a drilldown. You can specify multiple calculation types separated by
3533
- &quot;<tt class="docutils literal"><span class="pre">,</span></tt>&quot;. For example, <tt class="docutils literal"><span class="pre">MAX,MIN</span></tt>.</p>
3536
+ &quot;<code class="docutils literal"><span class="pre">,</span></code>&quot;. For example, <code class="docutils literal"><span class="pre">MAX,MIN</span></code>.</p>
3534
3537
  <p>Calculation target values are read from a column of grouped
3535
3538
  records. The column is specified by
3536
- <a class="reference internal" href="#select-drilldown-calc-target"><em>drilldown_calc_target</em></a>.</p>
3539
+ <a class="reference internal" href="#select-drilldown-calc-target"><span>drilldown_calc_target</span></a>.</p>
3537
3540
  <p>You can read calculated value by <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> such
3538
- as <tt class="docutils literal"><span class="pre">_max</span></tt> and <tt class="docutils literal"><span class="pre">_min</span></tt> in <a class="reference internal" href="#select-drilldown-output-columns"><em>drilldown_output_columns</em></a>.</p>
3541
+ as <code class="docutils literal"><span class="pre">_max</span></code> and <code class="docutils literal"><span class="pre">_min</span></code> in <a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a>.</p>
3539
3542
  <p>You can use the following calculation types:</p>
3540
3543
  <table border="1" class="docutils">
3541
3544
  <colgroup>
@@ -3547,47 +3550,47 @@ as <tt class="docutils literal"><span class="pre">_max</span></tt> and <tt class
3547
3550
  <thead valign="bottom">
3548
3551
  <tr class="row-odd"><th class="head">Type name</th>
3549
3552
  <th class="head"><a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> name</th>
3550
- <th class="head">Need <a class="reference internal" href="#select-drilldown-calc-target"><em>drilldown_calc_target</em></a></th>
3553
+ <th class="head">Need <a class="reference internal" href="#select-drilldown-calc-target"><span>drilldown_calc_target</span></a></th>
3551
3554
  <th class="head">Description</th>
3552
3555
  </tr>
3553
3556
  </thead>
3554
3557
  <tbody valign="top">
3555
- <tr class="row-even"><td><tt class="docutils literal"><span class="pre">NONE</span></tt></td>
3558
+ <tr class="row-even"><td><code class="docutils literal"><span class="pre">NONE</span></code></td>
3556
3559
  <td>Nothing.</td>
3557
3560
  <td>Not needs.</td>
3558
3561
  <td>Just ignored.</td>
3559
3562
  </tr>
3560
- <tr class="row-odd"><td><tt class="docutils literal"><span class="pre">COUNT</span></tt></td>
3561
- <td><tt class="docutils literal"><span class="pre">_nsubrecs</span></tt></td>
3563
+ <tr class="row-odd"><td><code class="docutils literal"><span class="pre">COUNT</span></code></td>
3564
+ <td><code class="docutils literal"><span class="pre">_nsubrecs</span></code></td>
3562
3565
  <td>Not needs.</td>
3563
3566
  <td>Counting grouped records. It's always enabled. So you don't
3564
- specify it.</td>
3567
+ need to specify it.</td>
3565
3568
  </tr>
3566
- <tr class="row-even"><td><tt class="docutils literal"><span class="pre">MAX</span></tt></td>
3567
- <td><tt class="docutils literal"><span class="pre">_max</span></tt></td>
3569
+ <tr class="row-even"><td><code class="docutils literal"><span class="pre">MAX</span></code></td>
3570
+ <td><code class="docutils literal"><span class="pre">_max</span></code></td>
3568
3571
  <td>Needs.</td>
3569
3572
  <td>Finding the maximum integer value from integer values in
3570
3573
  grouped records.</td>
3571
3574
  </tr>
3572
- <tr class="row-odd"><td><tt class="docutils literal"><span class="pre">MIN</span></tt></td>
3573
- <td><tt class="docutils literal"><span class="pre">_min</span></tt></td>
3575
+ <tr class="row-odd"><td><code class="docutils literal"><span class="pre">MIN</span></code></td>
3576
+ <td><code class="docutils literal"><span class="pre">_min</span></code></td>
3574
3577
  <td>Needs.</td>
3575
3578
  <td>Finding the minimum integer value from integer values in
3576
3579
  grouped records.</td>
3577
3580
  </tr>
3578
- <tr class="row-even"><td><tt class="docutils literal"><span class="pre">SUM</span></tt></td>
3579
- <td><tt class="docutils literal"><span class="pre">_sum</span></tt></td>
3581
+ <tr class="row-even"><td><code class="docutils literal"><span class="pre">SUM</span></code></td>
3582
+ <td><code class="docutils literal"><span class="pre">_sum</span></code></td>
3580
3583
  <td>Needs.</td>
3581
3584
  <td>Summing integer values in grouped records.</td>
3582
3585
  </tr>
3583
- <tr class="row-odd"><td><tt class="docutils literal"><span class="pre">AVG</span></tt></td>
3584
- <td><tt class="docutils literal"><span class="pre">_avg</span></tt></td>
3586
+ <tr class="row-odd"><td><code class="docutils literal"><span class="pre">AVG</span></code></td>
3587
+ <td><code class="docutils literal"><span class="pre">_avg</span></code></td>
3585
3588
  <td>Needs.</td>
3586
3589
  <td>Averaging integer/float values in grouped records.</td>
3587
3590
  </tr>
3588
3591
  </tbody>
3589
3592
  </table>
3590
- <p>Here is a <tt class="docutils literal"><span class="pre">MAX</span></tt> example:</p>
3593
+ <p>Here is a <code class="docutils literal"><span class="pre">MAX</span></code> example:</p>
3591
3594
  <p>Execution example:</p>
3592
3595
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
3593
3596
  --limit -1 \
@@ -3696,12 +3699,12 @@ grouped records.</td>
3696
3699
  # ]
3697
3700
  </pre></div>
3698
3701
  </div>
3699
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command groups all records by <tt class="docutils literal"><span class="pre">tag</span></tt> column value,
3700
- finding the maximum <tt class="docutils literal"><span class="pre">n_likes</span></tt> column value for each group and
3701
- outputs pairs of grouped key and the maximum <tt class="docutils literal"><span class="pre">n_likes</span></tt> column value
3702
- for the group. It uses <tt class="docutils literal"><span class="pre">_max</span></tt> <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to
3703
- read the maximum <tt class="docutils literal"><span class="pre">n_likes</span></tt> column value.</p>
3704
- <p>Here is a <tt class="docutils literal"><span class="pre">MIN</span></tt> example:</p>
3702
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command groups all records by <code class="docutils literal"><span class="pre">tag</span></code> column value,
3703
+ finding the maximum <code class="docutils literal"><span class="pre">n_likes</span></code> column value for each group and
3704
+ outputs pairs of grouped key and the maximum <code class="docutils literal"><span class="pre">n_likes</span></code> column value
3705
+ for the group. It uses <code class="docutils literal"><span class="pre">_max</span></code> <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to
3706
+ read the maximum <code class="docutils literal"><span class="pre">n_likes</span></code> column value.</p>
3707
+ <p>Here is a <code class="docutils literal"><span class="pre">MIN</span></code> example:</p>
3705
3708
  <p>Execution example:</p>
3706
3709
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
3707
3710
  --limit -1 \
@@ -3810,12 +3813,12 @@ read the maximum <tt class="docutils literal"><span class="pre">n_likes</span></
3810
3813
  # ]
3811
3814
  </pre></div>
3812
3815
  </div>
3813
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command groups all records by <tt class="docutils literal"><span class="pre">tag</span></tt> column value,
3814
- finding the minimum <tt class="docutils literal"><span class="pre">n_likes</span></tt> column value for each group and
3815
- outputs pairs of grouped key and the minimum <tt class="docutils literal"><span class="pre">n_likes</span></tt> column value
3816
- for the group. It uses <tt class="docutils literal"><span class="pre">_min</span></tt> <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to
3817
- read the minimum <tt class="docutils literal"><span class="pre">n_likes</span></tt> column value.</p>
3818
- <p>Here is a <tt class="docutils literal"><span class="pre">SUM</span></tt> example:</p>
3816
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command groups all records by <code class="docutils literal"><span class="pre">tag</span></code> column value,
3817
+ finding the minimum <code class="docutils literal"><span class="pre">n_likes</span></code> column value for each group and
3818
+ outputs pairs of grouped key and the minimum <code class="docutils literal"><span class="pre">n_likes</span></code> column value
3819
+ for the group. It uses <code class="docutils literal"><span class="pre">_min</span></code> <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to
3820
+ read the minimum <code class="docutils literal"><span class="pre">n_likes</span></code> column value.</p>
3821
+ <p>Here is a <code class="docutils literal"><span class="pre">SUM</span></code> example:</p>
3819
3822
  <p>Execution example:</p>
3820
3823
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
3821
3824
  --limit -1 \
@@ -3924,12 +3927,12 @@ read the minimum <tt class="docutils literal"><span class="pre">n_likes</span></
3924
3927
  # ]
3925
3928
  </pre></div>
3926
3929
  </div>
3927
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command groups all records by <tt class="docutils literal"><span class="pre">tag</span></tt> column value,
3928
- sums all <tt class="docutils literal"><span class="pre">n_likes</span></tt> column values for each group and outputs pairs
3929
- of grouped key and the summed <tt class="docutils literal"><span class="pre">n_likes</span></tt> column values for the
3930
- group. It uses <tt class="docutils literal"><span class="pre">_sum</span></tt> <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to read the
3931
- summed <tt class="docutils literal"><span class="pre">n_likes</span></tt> column values.</p>
3932
- <p>Here is a <tt class="docutils literal"><span class="pre">AVG</span></tt> example:</p>
3930
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command groups all records by <code class="docutils literal"><span class="pre">tag</span></code> column value,
3931
+ sums all <code class="docutils literal"><span class="pre">n_likes</span></code> column values for each group and outputs pairs
3932
+ of grouped key and the summed <code class="docutils literal"><span class="pre">n_likes</span></code> column values for the
3933
+ group. It uses <code class="docutils literal"><span class="pre">_sum</span></code> <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to read the
3934
+ summed <code class="docutils literal"><span class="pre">n_likes</span></code> column values.</p>
3935
+ <p>Here is a <code class="docutils literal"><span class="pre">AVG</span></code> example:</p>
3933
3936
  <p>Execution example:</p>
3934
3937
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
3935
3938
  --limit -1 \
@@ -4038,11 +4041,11 @@ summed <tt class="docutils literal"><span class="pre">n_likes</span></tt> column
4038
4041
  # ]
4039
4042
  </pre></div>
4040
4043
  </div>
4041
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command groups all records by <tt class="docutils literal"><span class="pre">tag</span></tt> column value,
4042
- averages all <tt class="docutils literal"><span class="pre">n_likes</span></tt> column values for each group and outputs
4043
- pairs of grouped key and the averaged <tt class="docutils literal"><span class="pre">n_likes</span></tt> column values for
4044
- the group. It uses <tt class="docutils literal"><span class="pre">_avg</span></tt> <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to read
4045
- the averaged <tt class="docutils literal"><span class="pre">n_likes</span></tt> column values.</p>
4044
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command groups all records by <code class="docutils literal"><span class="pre">tag</span></code> column value,
4045
+ averages all <code class="docutils literal"><span class="pre">n_likes</span></code> column values for each group and outputs
4046
+ pairs of grouped key and the averaged <code class="docutils literal"><span class="pre">n_likes</span></code> column values for
4047
+ the group. It uses <code class="docutils literal"><span class="pre">_avg</span></code> <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to read
4048
+ the averaged <code class="docutils literal"><span class="pre">n_likes</span></code> column values.</p>
4046
4049
  <p>Here is an example that uses all calculation types:</p>
4047
4050
  <p>Execution example:</p>
4048
4051
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
@@ -4180,107 +4183,112 @@ the averaged <tt class="docutils literal"><span class="pre">n_likes</span></tt>
4180
4183
  # ]
4181
4184
  </pre></div>
4182
4185
  </div>
4183
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command specifies multiple calculation types separated
4184
- by &quot;<tt class="docutils literal"><span class="pre">,</span></tt>&quot; like <tt class="docutils literal"><span class="pre">MAX,MIN,SUM,AVG</span></tt>. You can use <tt class="docutils literal"><span class="pre">_nsubrecs</span></tt>
4186
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command specifies multiple calculation types separated
4187
+ by &quot;<code class="docutils literal"><span class="pre">,</span></code>&quot; like <code class="docutils literal"><span class="pre">MAX,MIN,SUM,AVG</span></code>. You can use <code class="docutils literal"><span class="pre">_nsubrecs</span></code>
4185
4188
  <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> in
4186
- <a class="reference internal" href="#select-drilldown-output-columns"><em>drilldown_output_columns</em></a> without specifying <tt class="docutils literal"><span class="pre">COUNT</span></tt> in
4187
- <tt class="docutils literal"><span class="pre">drilldown_calc_types</span></tt>. Because <tt class="docutils literal"><span class="pre">COUNT</span></tt> is always enabled.</p>
4188
- <p>The default value of <tt class="docutils literal"><span class="pre">drilldown_calc_types</span></tt> is <tt class="docutils literal"><span class="pre">NONE</span></tt>. It means
4189
- that only <tt class="docutils literal"><span class="pre">COUNT</span></tt> is enabled. Because <tt class="docutils literal"><span class="pre">NONE</span></tt> is just ignored and
4190
- <tt class="docutils literal"><span class="pre">COUNT</span></tt> is always enabled.</p>
4189
+ <a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a> without specifying <code class="docutils literal"><span class="pre">COUNT</span></code> in
4190
+ <code class="docutils literal"><span class="pre">drilldown_calc_types</span></code>. Because <code class="docutils literal"><span class="pre">COUNT</span></code> is always enabled.</p>
4191
+ <p>The default value of <code class="docutils literal"><span class="pre">drilldown_calc_types</span></code> is <code class="docutils literal"><span class="pre">NONE</span></code>. It means
4192
+ that only <code class="docutils literal"><span class="pre">COUNT</span></code> is enabled. Because <code class="docutils literal"><span class="pre">NONE</span></code> is just ignored and
4193
+ <code class="docutils literal"><span class="pre">COUNT</span></code> is always enabled.</p>
4191
4194
  </div>
4192
4195
  <div class="section" id="drilldown-calc-target">
4193
- <span id="select-drilldown-calc-target"></span><h4>7.3.36.4.5.7. <tt class="docutils literal"><span class="pre">drilldown_calc_target</span></tt><a class="headerlink" href="#drilldown-calc-target" title="Permalink to this headline">¶</a></h4>
4194
- <p>Specifies the target column for <a class="reference internal" href="#select-drilldown-calc-types"><em>drilldown_calc_types</em></a>.</p>
4196
+ <span id="select-drilldown-calc-target"></span><h4>7.3.41.4.5.7. <code class="docutils literal"><span class="pre">drilldown_calc_target</span></code><a class="headerlink" href="#drilldown-calc-target" title="Permalink to this headline">¶</a></h4>
4197
+ <p>Specifies the target column for <a class="reference internal" href="#select-drilldown-calc-types"><span>drilldown_calc_types</span></a>.</p>
4195
4198
  <p>If you specify a calculation type that needs a target column such as
4196
- <tt class="docutils literal"><span class="pre">MAX</span></tt> in <a class="reference internal" href="#select-drilldown-calc-types"><em>drilldown_calc_types</em></a> but you omit
4197
- <tt class="docutils literal"><span class="pre">drilldown_calc_target</span></tt>, the calculation result is always <tt class="docutils literal"><span class="pre">0</span></tt>.</p>
4198
- <p>You can specify only one column name like <tt class="docutils literal"><span class="pre">--drilldown_calc_target</span>
4199
- <span class="pre">n_likes</span></tt>. You can't specify multiple column name like
4200
- <tt class="docutils literal"><span class="pre">--drilldown_calc_target</span> <span class="pre">_key,n_likes</span></tt>.</p>
4199
+ <code class="docutils literal"><span class="pre">MAX</span></code> in <a class="reference internal" href="#select-drilldown-calc-types"><span>drilldown_calc_types</span></a> but you omit
4200
+ <code class="docutils literal"><span class="pre">drilldown_calc_target</span></code>, the calculation result is always <code class="docutils literal"><span class="pre">0</span></code>.</p>
4201
+ <p>You can specify only one column name like <code class="docutils literal"><span class="pre">--drilldown_calc_target</span>
4202
+ <span class="pre">n_likes</span></code>. You can't specify multiple column name like
4203
+ <code class="docutils literal"><span class="pre">--drilldown_calc_target</span> <span class="pre">_key,n_likes</span></code>.</p>
4201
4204
  <p>You can use referenced value from the target record by combining
4202
- &quot;<tt class="docutils literal"><span class="pre">.</span></tt>&quot; like <tt class="docutils literal"><span class="pre">--drilldown_calc_target</span>
4203
- <span class="pre">reference_column.nested_reference_column.value</span></tt>.</p>
4204
- <p>See <a class="reference internal" href="#select-drilldown-calc-types"><em>drilldown_calc_types</em></a> to know how to use
4205
- <tt class="docutils literal"><span class="pre">drilldown_calc_target</span></tt>.</p>
4206
- <p>The default value of <tt class="docutils literal"><span class="pre">drilldown_calc_target</span></tt> is <tt class="docutils literal"><span class="pre">null</span></tt>. It means
4205
+ &quot;<code class="docutils literal"><span class="pre">.</span></code>&quot; like <code class="docutils literal"><span class="pre">--drilldown_calc_target</span>
4206
+ <span class="pre">reference_column.nested_reference_column.value</span></code>.</p>
4207
+ <p>See <a class="reference internal" href="#select-drilldown-calc-types"><span>drilldown_calc_types</span></a> to know how to use
4208
+ <code class="docutils literal"><span class="pre">drilldown_calc_target</span></code>.</p>
4209
+ <p>The default value of <code class="docutils literal"><span class="pre">drilldown_calc_target</span></code> is <code class="docutils literal"><span class="pre">null</span></code>. It means
4207
4210
  that no calculation target column is specified.</p>
4208
4211
  </div>
4209
4212
  </div>
4210
4213
  <div class="section" id="advanced-drilldown-related-parameters">
4211
- <span id="select-advanced-drilldown-related-parameters"></span><h3>7.3.36.4.6. Advanced drilldown related parameters<a class="headerlink" href="#advanced-drilldown-related-parameters" title="Permalink to this headline">¶</a></h3>
4214
+ <span id="select-advanced-drilldown-related-parameters"></span><h3>7.3.41.4.6. Advanced drilldown related parameters<a class="headerlink" href="#advanced-drilldown-related-parameters" title="Permalink to this headline">¶</a></h3>
4212
4215
  <p>You can get multiple drilldown results by specifying multiple group
4213
- keys by <a class="reference internal" href="#select-drilldown"><em>drilldown</em></a>. But you need to use the same
4216
+ keys by <a class="reference internal" href="#select-drilldown"><span>drilldown</span></a>. But you need to use the same
4214
4217
  configuration for all drilldowns. For example,
4215
- <a class="reference internal" href="#select-drilldown-output-columns"><em>drilldown_output_columns</em></a> is used by all drilldowns.</p>
4218
+ <a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a> is used by all drilldowns.</p>
4216
4219
  <p>You can use a configuration for each drilldown by the following
4217
4220
  parameters:</p>
4218
4221
  <blockquote>
4219
4222
  <div><ul class="simple">
4220
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></tt></li>
4221
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].sortby</span></tt></li>
4222
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></tt></li>
4223
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].offset</span></tt></li>
4224
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].limit</span></tt></li>
4225
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_types</span></tt></li>
4226
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_target</span></tt></li>
4223
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code></li>
4224
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].sortby</span></code></li>
4225
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code></li>
4226
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].offset</span></code></li>
4227
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].limit</span></code></li>
4228
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_types</span></code></li>
4229
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_target</span></code></li>
4227
4230
  </ul>
4228
4231
  </div></blockquote>
4229
- <p><tt class="docutils literal"><span class="pre">${LABEL}</span></tt> is a variable. You can use the following characters for
4230
- <tt class="docutils literal"><span class="pre">${LABEL}</span></tt>:</p>
4232
+ <p><code class="docutils literal"><span class="pre">${LABEL}</span></code> is a variable. You can use the following characters for
4233
+ <code class="docutils literal"><span class="pre">${LABEL}</span></code>:</p>
4231
4234
  <blockquote>
4232
4235
  <div><ul class="simple">
4233
4236
  <li>Alphabets</li>
4234
4237
  <li>Digits</li>
4235
- <li><tt class="docutils literal"><span class="pre">.</span></tt></li>
4236
- <li><tt class="docutils literal"><span class="pre">_</span></tt></li>
4238
+ <li><code class="docutils literal"><span class="pre">.</span></code></li>
4239
+ <li><code class="docutils literal"><span class="pre">_</span></code></li>
4237
4240
  </ul>
4238
4241
  </div></blockquote>
4239
- <p>Parameters that has the same <tt class="docutils literal"><span class="pre">${LABEL}</span></tt> value are grouped. Grouped
4242
+ <div class="admonition note">
4243
+ <p class="first admonition-title">Note</p>
4244
+ <p class="last">You can use more characters but it's better that you use only these
4245
+ characters.</p>
4246
+ </div>
4247
+ <p>Parameters that has the same <code class="docutils literal"><span class="pre">${LABEL}</span></code> value are grouped. Grouped
4240
4248
  parameters are used for one drilldown.</p>
4241
4249
  <p>For example, there are 2 groups for the following parameters:</p>
4242
4250
  <blockquote>
4243
4251
  <div><ul class="simple">
4244
- <li><tt class="docutils literal"><span class="pre">--drilldown[label1].keys</span> <span class="pre">_key</span></tt></li>
4245
- <li><tt class="docutils literal"><span class="pre">--drilldown[label1].output_columns</span> <span class="pre">_nsubrecs</span></tt></li>
4246
- <li><tt class="docutils literal"><span class="pre">--drilldown[label2].keys</span> <span class="pre">tag</span></tt></li>
4247
- <li><tt class="docutils literal"><span class="pre">--drilldown[label2].output_columns</span> <span class="pre">_key,_nsubrecs</span></tt></li>
4252
+ <li><code class="docutils literal"><span class="pre">--drilldown[label1].keys</span> <span class="pre">_key</span></code></li>
4253
+ <li><code class="docutils literal"><span class="pre">--drilldown[label1].output_columns</span> <span class="pre">_nsubrecs</span></code></li>
4254
+ <li><code class="docutils literal"><span class="pre">--drilldown[label2].keys</span> <span class="pre">tag</span></code></li>
4255
+ <li><code class="docutils literal"><span class="pre">--drilldown[label2].output_columns</span> <span class="pre">_key,_nsubrecs</span></code></li>
4248
4256
  </ul>
4249
4257
  </div></blockquote>
4250
- <p><tt class="docutils literal"><span class="pre">drilldown[label1].keys</span></tt> and <tt class="docutils literal"><span class="pre">drilldown[label1].output_columns</span></tt>
4251
- are grouped. <tt class="docutils literal"><span class="pre">drilldown[label2].keys</span></tt> and
4252
- <tt class="docutils literal"><span class="pre">drilldown[label2].output_columns</span></tt> are also grouped.</p>
4253
- <p>In <tt class="docutils literal"><span class="pre">label1</span></tt> group, <tt class="docutils literal"><span class="pre">_key</span></tt> is used for group key and <tt class="docutils literal"><span class="pre">_nsubrecs</span></tt>
4258
+ <p><code class="docutils literal"><span class="pre">drilldown[label1].keys</span></code> and <code class="docutils literal"><span class="pre">drilldown[label1].output_columns</span></code>
4259
+ are grouped. <code class="docutils literal"><span class="pre">drilldown[label2].keys</span></code> and
4260
+ <code class="docutils literal"><span class="pre">drilldown[label2].output_columns</span></code> are also grouped.</p>
4261
+ <p>In <code class="docutils literal"><span class="pre">label1</span></code> group, <code class="docutils literal"><span class="pre">_key</span></code> is used for group key and <code class="docutils literal"><span class="pre">_nsubrecs</span></code>
4254
4262
  is used for output columns.</p>
4255
- <p>In <tt class="docutils literal"><span class="pre">label2</span></tt> group, <tt class="docutils literal"><span class="pre">tag</span></tt> is used for group key and
4256
- <tt class="docutils literal"><span class="pre">_key,_nsubrecs</span></tt> is used for output columns.</p>
4257
- <p>See document for corresponding <tt class="docutils literal"><span class="pre">drilldown_XXX</span></tt> parameter to know how
4263
+ <p>In <code class="docutils literal"><span class="pre">label2</span></code> group, <code class="docutils literal"><span class="pre">tag</span></code> is used for group key and
4264
+ <code class="docutils literal"><span class="pre">_key,_nsubrecs</span></code> is used for output columns.</p>
4265
+ <p>See document for corresponding <code class="docutils literal"><span class="pre">drilldown_XXX</span></code> parameter to know how
4258
4266
  to use it for the following parameters:</p>
4259
4267
  <blockquote>
4260
4268
  <div><ul class="simple">
4261
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].sortby</span></tt>: <a class="reference internal" href="#select-drilldown-sortby"><em>drilldown_sortby</em></a></li>
4262
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].offset</span></tt>: <a class="reference internal" href="#select-drilldown-offset"><em>drilldown_offset</em></a></li>
4263
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].limit</span></tt>: <a class="reference internal" href="#select-drilldown-limit"><em>drilldown_limit</em></a></li>
4264
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_types</span></tt>: <a class="reference internal" href="#select-drilldown-calc-types"><em>drilldown_calc_types</em></a></li>
4265
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_target</span></tt>: <a class="reference internal" href="#select-drilldown-calc-target"><em>drilldown_calc_target</em></a></li>
4269
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].sortby</span></code>: <a class="reference internal" href="#select-drilldown-sortby"><span>drilldown_sortby</span></a></li>
4270
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].offset</span></code>: <a class="reference internal" href="#select-drilldown-offset"><span>drilldown_offset</span></a></li>
4271
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].limit</span></code>: <a class="reference internal" href="#select-drilldown-limit"><span>drilldown_limit</span></a></li>
4272
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_types</span></code>: <a class="reference internal" href="#select-drilldown-calc-types"><span>drilldown_calc_types</span></a></li>
4273
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_target</span></code>: <a class="reference internal" href="#select-drilldown-calc-target"><span>drilldown_calc_target</span></a></li>
4266
4274
  </ul>
4267
4275
  </div></blockquote>
4268
4276
  <p>The following parameters are needed more description:</p>
4269
4277
  <blockquote>
4270
4278
  <div><ul class="simple">
4271
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></tt></li>
4272
- <li><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></tt></li>
4279
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code></li>
4280
+ <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code></li>
4273
4281
  </ul>
4274
4282
  </div></blockquote>
4275
4283
  <p>Output format is different a bit. It's also needed more description.</p>
4276
4284
  <div class="section" id="drilldown-label-keys">
4277
- <span id="select-drilldown-label-keys"></span><h4>7.3.36.4.6.1. <tt class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></tt><a class="headerlink" href="#drilldown-label-keys" title="Permalink to this headline">¶</a></h4>
4278
- <p><a class="reference internal" href="#select-drilldown"><em>drilldown</em></a> can specify multiple keys for multiple
4285
+ <span id="select-drilldown-label-keys"></span><h4>7.3.41.4.6.1. <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code><a class="headerlink" href="#drilldown-label-keys" title="Permalink to this headline">¶</a></h4>
4286
+ <p><a class="reference internal" href="#select-drilldown"><span>drilldown</span></a> can specify multiple keys for multiple
4279
4287
  drilldowns. But it can't specify multiple keys for one drilldown.</p>
4280
- <p><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></tt> can't specify multiple keys for multiple
4288
+ <p><code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> can't specify multiple keys for multiple
4281
4289
  drilldowns. But it can specify multiple keys for one drilldown.</p>
4282
- <p>You can specify multiple keys separated by &quot;<tt class="docutils literal"><span class="pre">,</span></tt>&quot;.</p>
4283
- <p>Here is an example to group by multiple keys, <tt class="docutils literal"><span class="pre">tag</span></tt> and <tt class="docutils literal"><span class="pre">n_likes</span></tt>
4290
+ <p>You can specify multiple keys separated by &quot;<code class="docutils literal"><span class="pre">,</span></code>&quot;.</p>
4291
+ <p>Here is an example to group by multiple keys, <code class="docutils literal"><span class="pre">tag</span></code> and <code class="docutils literal"><span class="pre">n_likes</span></code>
4284
4292
  column values:</p>
4285
4293
  <p>Execution example:</p>
4286
4294
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
@@ -4402,27 +4410,27 @@ column values:</p>
4402
4410
  # ]
4403
4411
  </pre></div>
4404
4412
  </div>
4405
- <p><tt class="docutils literal"><span class="pre">tag.n_likes</span></tt> is used as the label for the drilldown parameters
4406
- group. You can refer grouped keys by <tt class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></tt> syntax in
4407
- <a class="reference internal" href="#select-drilldown-label-output-columns"><em>drilldown[${LABEL}].output_columns</em></a>. <tt class="docutils literal"><span class="pre">${KEY_NAME}</span></tt> is a
4408
- column name to be used by group key. <tt class="docutils literal"><span class="pre">tag</span></tt> and <tt class="docutils literal"><span class="pre">n_likes</span></tt> are
4409
- <tt class="docutils literal"><span class="pre">${KEY_NAME}</span></tt> in this case.</p>
4410
- <p>Note that you can't use <tt class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></tt> syntax when you just
4411
- specify one key as <tt class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></tt> like <tt class="docutils literal"><span class="pre">--drilldown[tag].keys</span>
4412
- <span class="pre">tag</span></tt>. You should use <tt class="docutils literal"><span class="pre">_key</span></tt> for the case. It's the same rule in
4413
- <a class="reference internal" href="#select-drilldown-output-columns"><em>drilldown_output_columns</em></a>.</p>
4413
+ <p><code class="docutils literal"><span class="pre">tag.n_likes</span></code> is used as the label for the drilldown parameters
4414
+ group. You can refer grouped keys by <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax in
4415
+ <a class="reference internal" href="#select-drilldown-label-output-columns"><span>drilldown[${LABEL}].output_columns</span></a>. <code class="docutils literal"><span class="pre">${KEY_NAME}</span></code> is a
4416
+ column name to be used by group key. <code class="docutils literal"><span class="pre">tag</span></code> and <code class="docutils literal"><span class="pre">n_likes</span></code> are
4417
+ <code class="docutils literal"><span class="pre">${KEY_NAME}</span></code> in this case.</p>
4418
+ <p>Note that you can't use <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax when you just
4419
+ specify one key as <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> like <code class="docutils literal"><span class="pre">--drilldown[tag].keys</span>
4420
+ <span class="pre">tag</span></code>. You should use <code class="docutils literal"><span class="pre">_key</span></code> for the case. It's the same rule in
4421
+ <a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a>.</p>
4414
4422
  </div>
4415
4423
  <div class="section" id="drilldown-label-output-columns">
4416
- <span id="select-drilldown-label-output-columns"></span><h4>7.3.36.4.6.2. <tt class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></tt><a class="headerlink" href="#drilldown-label-output-columns" title="Permalink to this headline">¶</a></h4>
4417
- <p>It's almost same as <a class="reference internal" href="#select-drilldown-output-columns"><em>drilldown_output_columns</em></a>. The
4418
- difference between <a class="reference internal" href="#select-drilldown-output-columns"><em>drilldown_output_columns</em></a> and
4419
- <tt class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></tt> is how to refer group keys.</p>
4420
- <p><a class="reference internal" href="#select-drilldown-output-columns"><em>drilldown_output_columns</em></a> uses <tt class="docutils literal"><span class="pre">_key</span></tt>
4424
+ <span id="select-drilldown-label-output-columns"></span><h4>7.3.41.4.6.2. <code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code><a class="headerlink" href="#drilldown-label-output-columns" title="Permalink to this headline">¶</a></h4>
4425
+ <p>It's almost same as <a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a>. The
4426
+ difference between <a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a> and
4427
+ <code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code> is how to refer group keys.</p>
4428
+ <p><a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a> uses <code class="docutils literal"><span class="pre">_key</span></code>
4421
4429
  <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to refer group
4422
- key. <tt class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></tt> also uses <tt class="docutils literal"><span class="pre">_key</span></tt>
4430
+ key. <code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code> also uses <code class="docutils literal"><span class="pre">_key</span></code>
4423
4431
  <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to refer group key when you specify
4424
- only one group key by <a class="reference internal" href="#select-drilldown-label-keys"><em>drilldown[${LABEL}].keys</em></a>.</p>
4425
- <p>Here is an example to refer single group key by <tt class="docutils literal"><span class="pre">_key</span></tt>
4432
+ only one group key by <a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a>.</p>
4433
+ <p>Here is an example to refer single group key by <code class="docutils literal"><span class="pre">_key</span></code>
4426
4434
  <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a>:</p>
4427
4435
  <p>Execution example:</p>
4428
4436
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
@@ -4501,13 +4509,13 @@ only one group key by <a class="reference internal" href="#select-drilldown-labe
4501
4509
  # ]
4502
4510
  </pre></div>
4503
4511
  </div>
4504
- <p>But you can't refer each group key by <tt class="docutils literal"><span class="pre">_key</span></tt>
4512
+ <p>But you can't refer each group key by <code class="docutils literal"><span class="pre">_key</span></code>
4505
4513
  <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> in
4506
- <tt class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></tt>. You need to use
4507
- <tt class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></tt> syntax. <tt class="docutils literal"><span class="pre">${KEY_NAME}</span></tt> is a column name that is
4508
- used for group key in <a class="reference internal" href="#select-drilldown-label-keys"><em>drilldown[${LABEL}].keys</em></a>.</p>
4514
+ <code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code>. You need to use
4515
+ <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax. <code class="docutils literal"><span class="pre">${KEY_NAME}</span></code> is a column name that is
4516
+ used for group key in <a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a>.</p>
4509
4517
  <p>Here is an example to refer each group key in multiple group keys by
4510
- <tt class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></tt> syntax:</p>
4518
+ <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax:</p>
4511
4519
  <p>Execution example:</p>
4512
4520
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
4513
4521
  --limit 0 \
@@ -4587,29 +4595,29 @@ used for group key in <a class="reference internal" href="#select-drilldown-labe
4587
4595
  </div>
4588
4596
  <div class="admonition tip">
4589
4597
  <p class="first admonition-title">Tip</p>
4590
- <p>Why <tt class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></tt> syntax?</p>
4598
+ <p>Why <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax?</p>
4591
4599
  <p>It's implementation specific information.</p>
4592
- <p><tt class="docutils literal"><span class="pre">_key</span></tt> is a vector value. The vector value is consists of all
4600
+ <p><code class="docutils literal"><span class="pre">_key</span></code> is a vector value. The vector value is consists of all
4593
4601
  group keys. You can see byte sequence of the vector value by
4594
- referring <tt class="docutils literal"><span class="pre">_key</span></tt> in <tt class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></tt>.</p>
4595
- <p>There is one grouped record in <tt class="docutils literal"><span class="pre">_value</span></tt> to refer each grouped
4602
+ referring <code class="docutils literal"><span class="pre">_key</span></code> in <code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code>.</p>
4603
+ <p>There is one grouped record in <code class="docutils literal"><span class="pre">_value</span></code> to refer each grouped
4596
4604
  values when you specify multiple group keys to
4597
- <a class="reference internal" href="#select-drilldown-label-keys"><em>drilldown[${LABEL}].keys</em></a>. So you can refer each group key
4598
- by <tt class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></tt> syntax.</p>
4599
- <p class="last">On the other hand, there is no grouped record in <tt class="docutils literal"><span class="pre">_value</span></tt> when
4605
+ <a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a>. So you can refer each group key
4606
+ by <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax.</p>
4607
+ <p class="last">On the other hand, there is no grouped record in <code class="docutils literal"><span class="pre">_value</span></code> when
4600
4608
  you specify only one group key to
4601
- <a class="reference internal" href="#select-drilldown-label-keys"><em>drilldown[${LABEL}].keys</em></a>. So you can't refer group key by
4602
- <tt class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></tt> syntax.</p>
4609
+ <a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a>. So you can't refer group key by
4610
+ <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax.</p>
4603
4611
  </div>
4604
4612
  </div>
4605
4613
  <div class="section" id="output-format-for-drilldown-label-style">
4606
- <span id="select-drilldown-label-output-format"></span><h4>7.3.36.4.6.3. Output format for <tt class="docutils literal"><span class="pre">drilldown[${LABEL}]</span></tt> style<a class="headerlink" href="#output-format-for-drilldown-label-style" title="Permalink to this headline">¶</a></h4>
4607
- <p>There is a difference in output format between <a class="reference internal" href="#select-drilldown"><em>drilldown</em></a>
4608
- and <a class="reference internal" href="#select-drilldown-label-keys"><em>drilldown[${LABEL}].keys</em></a>. <a class="reference internal" href="#select-drilldown"><em>drilldown</em></a> uses
4614
+ <span id="select-drilldown-label-output-format"></span><h4>7.3.41.4.6.3. Output format for <code class="docutils literal"><span class="pre">drilldown[${LABEL}]</span></code> style<a class="headerlink" href="#output-format-for-drilldown-label-style" title="Permalink to this headline">¶</a></h4>
4615
+ <p>There is a difference in output format between <a class="reference internal" href="#select-drilldown"><span>drilldown</span></a>
4616
+ and <a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a>. <a class="reference internal" href="#select-drilldown"><span>drilldown</span></a> uses
4609
4617
  array to output multiple drilldown results.
4610
- <a class="reference internal" href="#select-drilldown-label-keys"><em>drilldown[${LABEL}].keys</em></a> uses pairs of label and drilldown
4618
+ <a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a> uses pairs of label and drilldown
4611
4619
  result.</p>
4612
- <p><a class="reference internal" href="#select-drilldown"><em>drilldown</em></a> uses the following output format:</p>
4620
+ <p><a class="reference internal" href="#select-drilldown"><span>drilldown</span></a> uses the following output format:</p>
4613
4621
  <div class="highlight-none"><div class="highlight"><pre>[
4614
4622
  HEADER,
4615
4623
  [
@@ -4621,7 +4629,7 @@ result.</p>
4621
4629
  ]
4622
4630
  </pre></div>
4623
4631
  </div>
4624
- <p><a class="reference internal" href="#select-drilldown-label-keys"><em>drilldown[${LABEL}].keys</em></a> uses the following output format:</p>
4632
+ <p><a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a> uses the following output format:</p>
4625
4633
  <div class="highlight-none"><div class="highlight"><pre>[
4626
4634
  HEADER,
4627
4635
  [
@@ -4638,46 +4646,143 @@ result.</p>
4638
4646
  </div>
4639
4647
  </div>
4640
4648
  <div class="section" id="cache-related-parameter">
4641
- <h3>7.3.36.4.7. Cache related parameter<a class="headerlink" href="#cache-related-parameter" title="Permalink to this headline">¶</a></h3>
4649
+ <h3>7.3.41.4.7. Cache related parameter<a class="headerlink" href="#cache-related-parameter" title="Permalink to this headline">¶</a></h3>
4642
4650
  <div class="section" id="cache">
4643
- <h4>7.3.36.4.7.1. <tt class="docutils literal"><span class="pre">cache</span></tt><a class="headerlink" href="#cache" title="Permalink to this headline">¶</a></h4>
4644
- <p>TODO: write in English and add example.</p>
4645
- <p>クエリキャッシュに関する動作を設定します。</p>
4646
- <p><tt class="docutils literal"><span class="pre">no</span></tt></p>
4647
- <blockquote>
4648
- <div>検索結果をクエリキャッシュに残しません。キャッシュして再利用される可能性が低いクエリに対して用います。キャッシュ容量は有限です。有効なキャッシュが多くヒットするために、このパラメータは有効です。</div></blockquote>
4651
+ <span id="select-cache"></span><h4>7.3.41.4.7.1. <code class="docutils literal"><span class="pre">cache</span></code><a class="headerlink" href="#cache" title="Permalink to this headline">¶</a></h4>
4652
+ <p>Specifies whether caching the result of this query or not.</p>
4653
+ <p>If the result of this query is cached, the next same query returns
4654
+ response quickly by using the cache.</p>
4655
+ <p>It doesn't control whether existing cached result is used or not.</p>
4656
+ <p>Here are available values:</p>
4657
+ <table border="1" class="docutils">
4658
+ <colgroup>
4659
+ <col width="50%" />
4660
+ <col width="50%" />
4661
+ </colgroup>
4662
+ <thead valign="bottom">
4663
+ <tr class="row-odd"><th class="head">Value</th>
4664
+ <th class="head">Description</th>
4665
+ </tr>
4666
+ </thead>
4667
+ <tbody valign="top">
4668
+ <tr class="row-even"><td><code class="docutils literal"><span class="pre">no</span></code></td>
4669
+ <td>Don't cache the output of this query.</td>
4670
+ </tr>
4671
+ <tr class="row-odd"><td><code class="docutils literal"><span class="pre">yes</span></code></td>
4672
+ <td>Cache the output of this query.
4673
+ It's the default value.</td>
4674
+ </tr>
4675
+ </tbody>
4676
+ </table>
4677
+ <p>Here is an example to disable caching the result of this query:</p>
4678
+ <p>Execution example:</p>
4679
+ <div class="highlight-none"><div class="highlight"><pre>select Entries --cache no
4680
+ # [
4681
+ # [
4682
+ # 0,
4683
+ # 1337566253.89858,
4684
+ # 0.000355720520019531
4685
+ # ],
4686
+ # [
4687
+ # [
4688
+ # [
4689
+ # 5
4690
+ # ],
4691
+ # [
4692
+ # [
4693
+ # &quot;_id&quot;,
4694
+ # &quot;UInt32&quot;
4695
+ # ],
4696
+ # [
4697
+ # &quot;_key&quot;,
4698
+ # &quot;ShortText&quot;
4699
+ # ],
4700
+ # [
4701
+ # &quot;content&quot;,
4702
+ # &quot;Text&quot;
4703
+ # ],
4704
+ # [
4705
+ # &quot;n_likes&quot;,
4706
+ # &quot;UInt32&quot;
4707
+ # ],
4708
+ # [
4709
+ # &quot;tag&quot;,
4710
+ # &quot;ShortText&quot;
4711
+ # ]
4712
+ # ],
4713
+ # [
4714
+ # 1,
4715
+ # &quot;The first post!&quot;,
4716
+ # &quot;Welcome! This is my first post!&quot;,
4717
+ # 5,
4718
+ # &quot;Hello&quot;
4719
+ # ],
4720
+ # [
4721
+ # 2,
4722
+ # &quot;Groonga&quot;,
4723
+ # &quot;I started to use Groonga. It&#39;s very fast!&quot;,
4724
+ # 10,
4725
+ # &quot;Groonga&quot;
4726
+ # ],
4727
+ # [
4728
+ # 3,
4729
+ # &quot;Mroonga&quot;,
4730
+ # &quot;I also started to use Mroonga. It&#39;s also very fast! Really fast!&quot;,
4731
+ # 15,
4732
+ # &quot;Groonga&quot;
4733
+ # ],
4734
+ # [
4735
+ # 4,
4736
+ # &quot;Good-bye Senna&quot;,
4737
+ # &quot;I migrated all Senna system!&quot;,
4738
+ # 3,
4739
+ # &quot;Senna&quot;
4740
+ # ],
4741
+ # [
4742
+ # 5,
4743
+ # &quot;Good-bye Tritonn&quot;,
4744
+ # &quot;I also migrated all Tritonn system!&quot;,
4745
+ # 3,
4746
+ # &quot;Senna&quot;
4747
+ # ]
4748
+ # ]
4749
+ # ]
4750
+ # ]
4751
+ </pre></div>
4752
+ </div>
4753
+ <p>The default value is <code class="docutils literal"><span class="pre">yes</span></code>.</p>
4649
4754
  </div>
4650
4755
  </div>
4651
4756
  <div class="section" id="score-related-parameters">
4652
- <h3>7.3.36.4.8. Score related parameters<a class="headerlink" href="#score-related-parameters" title="Permalink to this headline">¶</a></h3>
4653
- <p>There is a score related parameter, <tt class="docutils literal"><span class="pre">adjuster</span></tt>.</p>
4757
+ <h3>7.3.41.4.8. Score related parameters<a class="headerlink" href="#score-related-parameters" title="Permalink to this headline">¶</a></h3>
4758
+ <p>There is a score related parameter, <code class="docutils literal"><span class="pre">adjuster</span></code>.</p>
4654
4759
  <div class="section" id="adjuster">
4655
- <span id="select-adjuster"></span><h4>7.3.36.4.8.1. <tt class="docutils literal"><span class="pre">adjuster</span></tt><a class="headerlink" href="#adjuster" title="Permalink to this headline">¶</a></h4>
4760
+ <span id="select-adjuster"></span><h4>7.3.41.4.8.1. <code class="docutils literal"><span class="pre">adjuster</span></code><a class="headerlink" href="#adjuster" title="Permalink to this headline">¶</a></h4>
4656
4761
  <p>Specifies one or more score adjust expressions. You need to use
4657
- <tt class="docutils literal"><span class="pre">adjuster</span></tt> with <tt class="docutils literal"><span class="pre">query</span></tt> or <tt class="docutils literal"><span class="pre">filter</span></tt>. <tt class="docutils literal"><span class="pre">adjuster</span></tt> doesn't work
4762
+ <code class="docutils literal"><span class="pre">adjuster</span></code> with <code class="docutils literal"><span class="pre">query</span></code> or <code class="docutils literal"><span class="pre">filter</span></code>. <code class="docutils literal"><span class="pre">adjuster</span></code> doesn't work
4658
4763
  with not searched request.</p>
4659
- <p>You can increase score of specific records by <tt class="docutils literal"><span class="pre">adjuster</span></tt>. You can
4660
- use <tt class="docutils literal"><span class="pre">adjuster</span></tt> to set high score for important records.</p>
4661
- <p>For example, you can use <tt class="docutils literal"><span class="pre">adjuster</span></tt> to increase score of records
4662
- that have <tt class="docutils literal"><span class="pre">groonga</span></tt> tag.</p>
4764
+ <p>You can increase score of specific records by <code class="docutils literal"><span class="pre">adjuster</span></code>. You can
4765
+ use <code class="docutils literal"><span class="pre">adjuster</span></code> to set high score for important records.</p>
4766
+ <p>For example, you can use <code class="docutils literal"><span class="pre">adjuster</span></code> to increase score of records
4767
+ that have <code class="docutils literal"><span class="pre">groonga</span></code> tag.</p>
4663
4768
  <p>Here is the syntax:</p>
4664
4769
  <div class="highlight-none"><div class="highlight"><pre>--adjuster &quot;SCORE_ADJUST_EXPRESSION1 + SCORE_ADJUST_EXPRESSION2 + ...&quot;
4665
4770
  </pre></div>
4666
4771
  </div>
4667
- <p>Here is the <tt class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></tt> syntax:</p>
4772
+ <p>Here is the <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> syntax:</p>
4668
4773
  <div class="highlight-none"><div class="highlight"><pre>COLUMN @ &quot;KEYWORD&quot; * FACTOR
4669
4774
  </pre></div>
4670
4775
  </div>
4671
4776
  <p>Note the following:</p>
4672
4777
  <blockquote>
4673
4778
  <div><ul class="simple">
4674
- <li><tt class="docutils literal"><span class="pre">COLUMN</span></tt> must be indexed.</li>
4675
- <li><tt class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</span></tt> must be a string.</li>
4676
- <li><tt class="docutils literal"><span class="pre">FACTOR</span></tt> must be a positive integer.</li>
4779
+ <li><code class="docutils literal"><span class="pre">COLUMN</span></code> must be indexed.</li>
4780
+ <li><code class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</span></code> must be a string.</li>
4781
+ <li><code class="docutils literal"><span class="pre">FACTOR</span></code> must be a positive integer.</li>
4677
4782
  </ul>
4678
4783
  </div></blockquote>
4679
- <p>Here is a sample <tt class="docutils literal"><span class="pre">adjuster</span></tt> usage example that uses just one
4680
- <tt class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></tt>:</p>
4784
+ <p>Here is a sample <code class="docutils literal"><span class="pre">adjuster</span></code> usage example that uses just one
4785
+ <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code>:</p>
4681
4786
  <p>Execution example:</p>
4682
4787
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
4683
4788
  --filter true \
@@ -4738,13 +4843,13 @@ that have <tt class="docutils literal"><span class="pre">groonga</span></tt> tag
4738
4843
  # ]
4739
4844
  </pre></div>
4740
4845
  </div>
4741
- <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command matches all records. Then it applies
4742
- <tt class="docutils literal"><span class="pre">adjuster</span></tt>. The adjuster increases score of records that have
4743
- <tt class="docutils literal"><span class="pre">&quot;groonga&quot;</span></tt> in <tt class="docutils literal"><span class="pre">Entries.content</span></tt> column by 5. There is only one
4744
- record that has <tt class="docutils literal"><span class="pre">&quot;groonga&quot;</span></tt> in <tt class="docutils literal"><span class="pre">Entries.content</span></tt> column. So the
4745
- record that its key is <tt class="docutils literal"><span class="pre">&quot;Groonga&quot;</span></tt> has score 6 (<tt class="docutils literal"><span class="pre">=</span> <span class="pre">1</span> <span class="pre">+</span> <span class="pre">5</span></tt>).</p>
4746
- <p>You can omit <tt class="docutils literal"><span class="pre">FACTOR</span></tt>. If you omit <tt class="docutils literal"><span class="pre">FACTOR</span></tt>, it is treated as 1.</p>
4747
- <p>Here is a sample <tt class="docutils literal"><span class="pre">adjuster</span></tt> usage example that omits <tt class="docutils literal"><span class="pre">FACTOR</span></tt>:</p>
4846
+ <p>The <code class="docutils literal"><span class="pre">select</span></code> command matches all records. Then it applies
4847
+ <code class="docutils literal"><span class="pre">adjuster</span></code>. The adjuster increases score of records that have
4848
+ <code class="docutils literal"><span class="pre">&quot;groonga&quot;</span></code> in <code class="docutils literal"><span class="pre">Entries.content</span></code> column by 5. There is only one
4849
+ record that has <code class="docutils literal"><span class="pre">&quot;groonga&quot;</span></code> in <code class="docutils literal"><span class="pre">Entries.content</span></code> column. So the
4850
+ record that its key is <code class="docutils literal"><span class="pre">&quot;Groonga&quot;</span></code> has score 6 (<code class="docutils literal"><span class="pre">=</span> <span class="pre">1</span> <span class="pre">+</span> <span class="pre">5</span></code>).</p>
4851
+ <p>You can omit <code class="docutils literal"><span class="pre">FACTOR</span></code>. If you omit <code class="docutils literal"><span class="pre">FACTOR</span></code>, it is treated as 1.</p>
4852
+ <p>Here is a sample <code class="docutils literal"><span class="pre">adjuster</span></code> usage example that omits <code class="docutils literal"><span class="pre">FACTOR</span></code>:</p>
4748
4853
  <p>Execution example:</p>
4749
4854
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
4750
4855
  --filter true \
@@ -4805,12 +4910,12 @@ record that its key is <tt class="docutils literal"><span class="pre">&quot;Groo
4805
4910
  # ]
4806
4911
  </pre></div>
4807
4912
  </div>
4808
- <p>The <tt class="docutils literal"><span class="pre">adjuster</span></tt> in the <tt class="docutils literal"><span class="pre">select</span></tt> command doesn't have <tt class="docutils literal"><span class="pre">FACTOR</span></tt>. So
4913
+ <p>The <code class="docutils literal"><span class="pre">adjuster</span></code> in the <code class="docutils literal"><span class="pre">select</span></code> command doesn't have <code class="docutils literal"><span class="pre">FACTOR</span></code>. So
4809
4914
  the factor is treated as 1. There is only one record that has
4810
- <tt class="docutils literal"><span class="pre">&quot;groonga&quot;</span></tt> in <tt class="docutils literal"><span class="pre">Entries.content</span></tt> column. So the record that its
4811
- key is <tt class="docutils literal"><span class="pre">&quot;Groonga&quot;</span></tt> has score 2 (<tt class="docutils literal"><span class="pre">=</span> <span class="pre">1</span> <span class="pre">+</span> <span class="pre">1</span></tt>).</p>
4812
- <p>Here is a sample <tt class="docutils literal"><span class="pre">adjuster</span></tt> usage example that uses multiple
4813
- <tt class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></tt>:</p>
4915
+ <code class="docutils literal"><span class="pre">&quot;groonga&quot;</span></code> in <code class="docutils literal"><span class="pre">Entries.content</span></code> column. So the record that its
4916
+ key is <code class="docutils literal"><span class="pre">&quot;Groonga&quot;</span></code> has score 2 (<code class="docutils literal"><span class="pre">=</span> <span class="pre">1</span> <span class="pre">+</span> <span class="pre">1</span></code>).</p>
4917
+ <p>Here is a sample <code class="docutils literal"><span class="pre">adjuster</span></code> usage example that uses multiple
4918
+ <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code>:</p>
4814
4919
  <p>Execution example:</p>
4815
4920
  <div class="highlight-none"><div class="highlight"><pre>select Entries \
4816
4921
  --filter true \
@@ -4871,83 +4976,227 @@ key is <tt class="docutils literal"><span class="pre">&quot;Groonga&quot;</span>
4871
4976
  # ]
4872
4977
  </pre></div>
4873
4978
  </div>
4874
- <p>The <tt class="docutils literal"><span class="pre">adjuster</span></tt> in the <tt class="docutils literal"><span class="pre">select</span></tt> command has two
4875
- <tt class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></tt> s. The final increased score is sum of
4876
- scores of these <tt class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></tt> s. All
4877
- <tt class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></tt> s in the <tt class="docutils literal"><span class="pre">select</span></tt> command are applied to
4878
- a record that its key is <tt class="docutils literal"><span class="pre">&quot;Groonga&quot;</span></tt>. So the final increased score
4879
- of the record is sum of scores of all <tt class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></tt> s.</p>
4880
- <p>The first <tt class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></tt> is <tt class="docutils literal"><span class="pre">content</span> <span class="pre">&#64;</span> <span class="pre">&quot;groonga&quot;</span> <span class="pre">*</span> <span class="pre">5</span></tt>.
4979
+ <p>The <code class="docutils literal"><span class="pre">adjuster</span></code> in the <code class="docutils literal"><span class="pre">select</span></code> command has two
4980
+ <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> s. The final increased score is sum of
4981
+ scores of these <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> s. All
4982
+ <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> s in the <code class="docutils literal"><span class="pre">select</span></code> command are applied to
4983
+ a record that its key is <code class="docutils literal"><span class="pre">&quot;Groonga&quot;</span></code>. So the final increased score
4984
+ of the record is sum of scores of all <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> s.</p>
4985
+ <p>The first <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> is <code class="docutils literal"><span class="pre">content</span> <span class="pre">&#64;</span> <span class="pre">&quot;groonga&quot;</span> <span class="pre">*</span> <span class="pre">5</span></code>.
4881
4986
  It increases score by 5.</p>
4882
- <p>The second <tt class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></tt> is <tt class="docutils literal"><span class="pre">content</span> <span class="pre">&#64;</span> <span class="pre">&quot;started&quot;</span> <span class="pre">*</span> <span class="pre">3</span></tt>.
4987
+ <p>The second <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> is <code class="docutils literal"><span class="pre">content</span> <span class="pre">&#64;</span> <span class="pre">&quot;started&quot;</span> <span class="pre">*</span> <span class="pre">3</span></code>.
4883
4988
  It increases score by 3.</p>
4884
- <p>The final increased score is 9 (<tt class="docutils literal"><span class="pre">=</span> <span class="pre">1</span> <span class="pre">+</span> <span class="pre">5</span> <span class="pre">+</span> <span class="pre">3</span></tt>).</p>
4885
- <p>A <tt class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></tt> has a factor for <tt class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</span></tt>. This
4886
- means that increased scores of all records that has <tt class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</span></tt> are
4989
+ <p>The final increased score is 9 (<code class="docutils literal"><span class="pre">=</span> <span class="pre">1</span> <span class="pre">+</span> <span class="pre">5</span> <span class="pre">+</span> <span class="pre">3</span></code>).</p>
4990
+ <p>A <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> has a factor for <code class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</span></code>. This
4991
+ means that increased scores of all records that has <code class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</span></code> are
4887
4992
  the same value. You can change increase score for each record that has
4888
- the same <tt class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</span></tt>. It is useful to tune search score. See
4889
- <a class="reference internal" href="../columns/vector.html#weight-vector-column"><em>Weight vector column</em></a> for details.</p>
4993
+ the same <code class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</span></code>. It is useful to tune search score. See
4994
+ <a class="reference internal" href="../columns/vector.html#weight-vector-column"><span>Weight vector column</span></a> for details.</p>
4890
4995
  </div>
4891
4996
  </div>
4892
4997
  </div>
4893
- <div class="section" id="id7">
4894
- <h2>7.3.36.5. 返値<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h2>
4895
- <p>TODO: write in English and add example.</p>
4896
- <p>以下のようなjson形式で値が返却されます。</p>
4897
- <div class="highlight-none"><div class="highlight"><pre>[[リターンコード, 処理開始時間, 処理時間], [検索結果, ドリルダウン結果]]
4998
+ <div class="section" id="return-value">
4999
+ <span id="select-return-value"></span><h2>7.3.41.5. Return value<a class="headerlink" href="#return-value" title="Permalink to this headline">¶</a></h2>
5000
+ <p><code class="docutils literal"><span class="pre">select</span></code> returns response with the following format:</p>
5001
+ <div class="highlight-none"><div class="highlight"><pre>[
5002
+ HEADER,
5003
+ [
5004
+ SEARCH_RESULT,
5005
+ DRILLDOWN_RESULT_1,
5006
+ DRILLDOWN_RESULT_2,
5007
+ ...,
5008
+ DRILLDOWN_RESULT_N
5009
+ ]
5010
+ ]
4898
5011
  </pre></div>
4899
5012
  </div>
4900
- <p><tt class="docutils literal"><span class="pre">リターンコード</span></tt></p>
4901
- <blockquote>
4902
- <div>grn_rcに対応する数値が返されます。0(GRN_SUCCESS)以外の場合は、続いてエラー内容を示す
4903
- 文字列が返されます。</div></blockquote>
4904
- <p><tt class="docutils literal"><span class="pre">処理開始時間</span></tt></p>
4905
- <blockquote>
4906
- <div>処理を開始した時間について、1970年1月1日0時0分0秒を起点とした秒数を小数で返します。</div></blockquote>
4907
- <p><tt class="docutils literal"><span class="pre">処理時間</span></tt></p>
4908
- <blockquote>
4909
- <div>処理にかかった秒数を返します。</div></blockquote>
4910
- <p><tt class="docutils literal"><span class="pre">検索結果</span></tt></p>
4911
- <blockquote>
4912
- <div><p>drilldown条件が実行される前の検索結果が以下のように出力されます。:</p>
4913
- <div class="highlight-none"><div class="highlight"><pre>[[ヒット数], [[カラム名1,カラム型1],..], 検索結果1,..]
5013
+ <p>If <code class="docutils literal"><span class="pre">select</span></code> fails, error details are in <code class="docutils literal"><span class="pre">HEADER</span></code>.</p>
5014
+ <p>See <a class="reference internal" href="../command/output_format.html"><em>Output format</em></a> for <code class="docutils literal"><span class="pre">HEADER</span></code>.</p>
5015
+ <p>There are zero or more <code class="docutils literal"><span class="pre">DRILLDOWN_RESULT</span></code>. If no <code class="docutils literal"><span class="pre">drilldown</span></code> and
5016
+ <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> are specified, they are omitted like the
5017
+ following:</p>
5018
+ <div class="highlight-none"><div class="highlight"><pre>[
5019
+ HEADER,
5020
+ [
5021
+ SEARCH_RESULT
5022
+ ]
5023
+ ]
4914
5024
  </pre></div>
4915
5025
  </div>
4916
- <p><tt class="docutils literal"><span class="pre">ヒット数</span></tt></p>
4917
- <blockquote>
4918
- <div>検索条件にヒットしたレコードの数が出力されます。 <tt class="docutils literal"><span class="pre">--limit</span></tt> オプションで出力件数を制限した場合は出力するレコード数と一致しません。 <tt class="docutils literal"><span class="pre">ヒット数</span></tt> は <tt class="docutils literal"><span class="pre">--limit</span></tt> オプションに関係なく常にヒットしたレコードの数になります。</div></blockquote>
4919
- <p><tt class="docutils literal"><span class="pre">カラム名n</span></tt></p>
4920
- <blockquote>
4921
- <div>output_columnsに指定された条件に従って、対象となるカラム名が出力されます。</div></blockquote>
4922
- <p><tt class="docutils literal"><span class="pre">カラム型n</span></tt></p>
4923
- <blockquote>
4924
- <div>output_columnsに指定された条件に従って、対象となるカラム型が出力されます。</div></blockquote>
4925
- <p><tt class="docutils literal"><span class="pre">検索結果n</span></tt></p>
4926
- <blockquote>
4927
- <div>output_columns, offset, limitによって指定された条件に従って各レコードの値が出力されます。</div></blockquote>
4928
- </div></blockquote>
4929
- <p><tt class="docutils literal"><span class="pre">drilldown結果</span></tt></p>
4930
- <blockquote>
4931
- <div><p>drilldown処理の結果が以下のように出力されます。:</p>
4932
- <div class="highlight-none"><div class="highlight"><pre>[[[件数], [[カラム名1,カラム型1],..], 検索結果1,..],..]
5026
+ <p>If <code class="docutils literal"><span class="pre">drilldown</span></code> has two or more keys like <code class="docutils literal"><span class="pre">--drilldown</span> <span class="pre">&quot;_key,</span>
5027
+ <span class="pre">column1,</span> <span class="pre">column2&quot;</span></code>, multiple <code class="docutils literal"><span class="pre">DRILLDOWN_RESULT</span></code> exist:</p>
5028
+ <div class="highlight-none"><div class="highlight"><pre>[
5029
+ HEADER,
5030
+ [
5031
+ SEARCH_RESULT,
5032
+ DRILLDOWN_RESULT_FOR_KEY,
5033
+ DRILLDOWN_RESULT_FOR_COLUMN1,
5034
+ DRILLDOWN_RESULT_FOR_COLUMN2
5035
+ ]
5036
+ ]
4933
5037
  </pre></div>
4934
5038
  </div>
4935
- <p><tt class="docutils literal"><span class="pre">件数</span></tt></p>
4936
- <blockquote>
4937
- <div>drilldownに指定されたカラムの値の異なり数が出力されます。</div></blockquote>
4938
- <p><tt class="docutils literal"><span class="pre">カラム名n</span></tt></p>
4939
- <blockquote>
4940
- <div>drilldown_output_columnsに指定された条件に従って、対象となるカラム名が出力されます。</div></blockquote>
4941
- <p><tt class="docutils literal"><span class="pre">カラム型n</span></tt></p>
4942
- <blockquote>
4943
- <div>drilldown_output_columnsに指定された条件に従って、対象となるカラム型が出力されます。</div></blockquote>
4944
- <p><tt class="docutils literal"><span class="pre">ドリルダウン結果n</span></tt></p>
5039
+ <p>If <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> is used, only one <code class="docutils literal"><span class="pre">DRILLDOWN_RESULT</span></code>
5040
+ exist:</p>
5041
+ <div class="highlight-none"><div class="highlight"><pre>[
5042
+ HEADER,
5043
+ [
5044
+ SEARCH_RESULT,
5045
+ DRILLDOWN_RESULT_FOR_LABELED_DRILLDOWN
5046
+ ]
5047
+ ]
5048
+ </pre></div>
5049
+ </div>
5050
+ <p><code class="docutils literal"><span class="pre">DRILLDOWN_RESULT</span></code> format is different between <code class="docutils literal"><span class="pre">drilldown</span></code> and
5051
+ <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code>. It's described later.</p>
5052
+ <p><code class="docutils literal"><span class="pre">SEARCH_RESULT</span></code> is the following format:</p>
5053
+ <div class="highlight-none"><div class="highlight"><pre>[
5054
+ [N_HITS],
5055
+ COLUMNS,
5056
+ RECORDS
5057
+ ]
5058
+ </pre></div>
5059
+ </div>
5060
+ <p>See <a class="reference internal" href="#select-simple-usage"><span>Simple usage</span></a> for concrete example of the format.</p>
5061
+ <p><code class="docutils literal"><span class="pre">N_HITS</span></code> is the number of matched records before <a class="reference internal" href="#select-limit"><span>limit</span></a>
5062
+ is applied.</p>
5063
+ <p><code class="docutils literal"><span class="pre">COLUMNS</span></code> describes about output columns specified by
5064
+ <a class="reference internal" href="#select-output-columns"><span>output_columns</span></a>. It uses the following format:</p>
5065
+ <div class="highlight-none"><div class="highlight"><pre>[
5066
+ [COLUMN_NAME_1, COLUMN_TYPE_1],
5067
+ [COLUMN_NAME_2, COLUMN_TYPE_2],
5068
+ ...,
5069
+ [COLUMN_NAME_N, COLUMN_TYPE_N]
5070
+ ]
5071
+ </pre></div>
5072
+ </div>
5073
+ <p><code class="docutils literal"><span class="pre">COLUMNS</span></code> includes one or more output column information. Each
5074
+ output column information includes the followings:</p>
4945
5075
  <blockquote>
4946
- <div>drilldown_output_columns, drilldown_offset, drilldown_limitによって指定された条件に従って各レコードの値が出力されます。</div></blockquote>
5076
+ <div><ul class="simple">
5077
+ <li>Column name as string</li>
5078
+ <li>Column type as string or <code class="docutils literal"><span class="pre">null</span></code></li>
5079
+ </ul>
4947
5080
  </div></blockquote>
5081
+ <p>Column name is extracted from value specified as
5082
+ <a class="reference internal" href="#select-output-columns"><span>output_columns</span></a>.</p>
5083
+ <p>Column type is Groonga's type name or <code class="docutils literal"><span class="pre">null</span></code>. It doesn't describe
5084
+ whether the column value is vector or scalar. You need to determine it
5085
+ by whether real column value is array or not.</p>
5086
+ <p>See <a class="reference internal" href="../types.html"><em>Data types</em></a> for type details.</p>
5087
+ <p><code class="docutils literal"><span class="pre">null</span></code> is used when column value type isn't determined. For example,
5088
+ function call in <a class="reference internal" href="#select-output-columns"><span>output_columns</span></a> such as
5089
+ <code class="docutils literal"><span class="pre">--output_columns</span> <span class="pre">&quot;snippet_html(content)&quot;</span></code> uses <code class="docutils literal"><span class="pre">null</span></code>.</p>
5090
+ <p>Here is an example of <code class="docutils literal"><span class="pre">COLUMNS</span></code>:</p>
5091
+ <div class="highlight-none"><div class="highlight"><pre>[
5092
+ [&quot;_id&quot;, &quot;UInt32&quot;],
5093
+ [&quot;_key&quot;, &quot;ShortText&quot;],
5094
+ [&quot;n_likes&quot;, &quot;UInt32&quot;],
5095
+ ]
5096
+ </pre></div>
5097
+ </div>
5098
+ <p><code class="docutils literal"><span class="pre">RECORDS</span></code> includes column values for each matched record. Included
5099
+ records are selected by <a class="reference internal" href="#select-offset"><span>offset</span></a> and
5100
+ <a class="reference internal" href="#select-limit"><span>limit</span></a>. It uses the following format:</p>
5101
+ <div class="highlight-none"><div class="highlight"><pre>[
5102
+ [
5103
+ RECORD_1_COLUMN_1,
5104
+ RECORD_1_COLUMN_2,
5105
+ ...,
5106
+ RECORD_1_COLUMN_N
5107
+ ],
5108
+ [
5109
+ RECORD_2_COLUMN_1,
5110
+ RECORD_2_COLUMN_2,
5111
+ ...,
5112
+ RECORD_2_COLUMN_N
5113
+ ],
5114
+ ...
5115
+ [
5116
+ RECORD_N_COLUMN_1,
5117
+ RECORD_N_COLUMN_2,
5118
+ ...,
5119
+ RECORD_N_COLUMN_N
5120
+ ]
5121
+ ]
5122
+ </pre></div>
5123
+ </div>
5124
+ <p>Here is an example <code class="docutils literal"><span class="pre">RECORDS</span></code>:</p>
5125
+ <div class="highlight-none"><div class="highlight"><pre>[
5126
+ [
5127
+ 1,
5128
+ &quot;The first post!&quot;,
5129
+ 5
5130
+ ],
5131
+ [
5132
+ 2,
5133
+ &quot;Groonga&quot;,
5134
+ 10
5135
+ ],
5136
+ [
5137
+ 3,
5138
+ &quot;Mroonga&quot;,
5139
+ 15
5140
+ ]
5141
+ ]
5142
+ </pre></div>
5143
+ </div>
5144
+ <p><code class="docutils literal"><span class="pre">DRILLDOWN_RESULT</span></code> format is different between <code class="docutils literal"><span class="pre">drilldown</span></code> and
5145
+ <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code>.</p>
5146
+ <p><code class="docutils literal"><span class="pre">drilldown</span></code> uses the same format as <code class="docutils literal"><span class="pre">SEARCH_RESULT</span></code>:</p>
5147
+ <div class="highlight-none"><div class="highlight"><pre>[
5148
+ [N_HITS],
5149
+ COLUMNS,
5150
+ RECORDS
5151
+ ]
5152
+ </pre></div>
5153
+ </div>
5154
+ <p>And <code class="docutils literal"><span class="pre">drilldown</span></code> generates one or more <code class="docutils literal"><span class="pre">DRILLDOWN_RESULT</span></code> when
5155
+ <a class="reference internal" href="#select-drilldown"><span>drilldown</span></a> has one ore more keys.</p>
5156
+ <p><code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> uses the following format. Multiple
5157
+ <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> are mapped to one object (key-value
5158
+ pairs):</p>
5159
+ <div class="highlight-none"><div class="highlight"><pre>{
5160
+ &quot;LABEL_1&quot;: [
5161
+ [N_HITS],
5162
+ COLUMNS,
5163
+ RECORDS
5164
+ ],
5165
+ &quot;LABEL_2&quot;: [
5166
+ [N_HITS],
5167
+ COLUMNS,
5168
+ RECORDS
5169
+ ],
5170
+ ...,
5171
+ &quot;LABEL_N&quot;: [
5172
+ [N_HITS],
5173
+ COLUMNS,
5174
+ RECORDS
5175
+ ]
5176
+ }
5177
+ </pre></div>
5178
+ </div>
5179
+ <p>Each <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> corresponds to the following:</p>
5180
+ <div class="highlight-none"><div class="highlight"><pre>&quot;LABEL&quot;: [
5181
+ [N_HITS],
5182
+ COLUMNS,
5183
+ RECORDS
5184
+ ]
5185
+ </pre></div>
5186
+ </div>
5187
+ <p>The following value part is the same format as <code class="docutils literal"><span class="pre">SEARCH_RESULT</span></code>:</p>
5188
+ <div class="highlight-none"><div class="highlight"><pre>[
5189
+ [N_HITS],
5190
+ COLUMNS,
5191
+ RECORDS
5192
+ ]
5193
+ </pre></div>
5194
+ </div>
5195
+ <p>See also <a class="reference internal" href="#select-drilldown-label-output-format"><span>Output format for drilldown[${LABEL}] style</span></a> for
5196
+ <code class="docutils literal"><span class="pre">drilldown[${LABEL}]</span></code> style drilldown output format.</p>
4948
5197
  </div>
4949
5198
  <div class="section" id="see-also">
4950
- <h2>7.3.36.6. See also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
5199
+ <h2>7.3.41.6. See also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
4951
5200
  <blockquote>
4952
5201
  <div><ul class="simple">
4953
5202
  <li><a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a></li>
@@ -4961,95 +5210,97 @@ the same <tt class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</spa
4961
5210
  </div>
4962
5211
  </div>
4963
5212
  </div>
4964
- <div class="sphinxsidebar">
5213
+ <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
4965
5214
  <div class="sphinxsidebarwrapper">
4966
5215
  <h3><a href="../../index.html">Table Of Contents</a></h3>
4967
5216
  <ul>
4968
- <li><a class="reference internal" href="#">7.3.36. <tt class="docutils literal"><span class="pre">select</span></tt></a><ul>
4969
- <li><a class="reference internal" href="#summary">7.3.36.1. Summary</a></li>
4970
- <li><a class="reference internal" href="#syntax">7.3.36.2. Syntax</a></li>
4971
- <li><a class="reference internal" href="#usage">7.3.36.3. Usage</a><ul>
4972
- <li><a class="reference internal" href="#simple-usage">7.3.36.3.1. Simple usage</a></li>
4973
- <li><a class="reference internal" href="#search-conditions">7.3.36.3.2. Search conditions</a><ul>
4974
- <li><a class="reference internal" href="#search-condition-query">7.3.36.3.2.1. Search condition: <tt class="docutils literal"><span class="pre">query</span></tt></a></li>
4975
- <li><a class="reference internal" href="#search-condition-filter">7.3.36.3.2.2. Search condition: <tt class="docutils literal"><span class="pre">filter</span></tt></a></li>
5217
+ <li><a class="reference internal" href="#">7.3.41. <code class="docutils literal"><span class="pre">select</span></code></a><ul>
5218
+ <li><a class="reference internal" href="#summary">7.3.41.1. Summary</a></li>
5219
+ <li><a class="reference internal" href="#syntax">7.3.41.2. Syntax</a></li>
5220
+ <li><a class="reference internal" href="#usage">7.3.41.3. Usage</a><ul>
5221
+ <li><a class="reference internal" href="#simple-usage">7.3.41.3.1. Simple usage</a></li>
5222
+ <li><a class="reference internal" href="#search-conditions">7.3.41.3.2. Search conditions</a><ul>
5223
+ <li><a class="reference internal" href="#search-condition-query">7.3.41.3.2.1. Search condition: <code class="docutils literal"><span class="pre">query</span></code></a></li>
5224
+ <li><a class="reference internal" href="#search-condition-filter">7.3.41.3.2.2. Search condition: <code class="docutils literal"><span class="pre">filter</span></code></a></li>
4976
5225
  </ul>
4977
5226
  </li>
4978
- <li><a class="reference internal" href="#paging">7.3.36.3.3. Paging</a></li>
4979
- <li><a class="reference internal" href="#the-total-number-of-records">7.3.36.3.4. The total number of records</a></li>
4980
- <li><a class="reference internal" href="#drilldown">7.3.36.3.5. Drilldown</a></li>
5227
+ <li><a class="reference internal" href="#paging">7.3.41.3.3. Paging</a></li>
5228
+ <li><a class="reference internal" href="#the-total-number-of-records">7.3.41.3.4. The total number of records</a></li>
5229
+ <li><a class="reference internal" href="#drilldown">7.3.41.3.5. Drilldown</a></li>
4981
5230
  </ul>
4982
5231
  </li>
4983
- <li><a class="reference internal" href="#parameters">7.3.36.4. Parameters</a><ul>
4984
- <li><a class="reference internal" href="#required-parameter">7.3.36.4.1. Required parameter</a><ul>
4985
- <li><a class="reference internal" href="#table">7.3.36.4.1.1. <tt class="docutils literal"><span class="pre">table</span></tt></a></li>
5232
+ <li><a class="reference internal" href="#parameters">7.3.41.4. Parameters</a><ul>
5233
+ <li><a class="reference internal" href="#required-parameter">7.3.41.4.1. Required parameter</a><ul>
5234
+ <li><a class="reference internal" href="#table">7.3.41.4.1.1. <code class="docutils literal"><span class="pre">table</span></code></a></li>
4986
5235
  </ul>
4987
5236
  </li>
4988
- <li><a class="reference internal" href="#search-related-parameters">7.3.36.4.2. Search related parameters</a><ul>
4989
- <li><a class="reference internal" href="#match-columns">7.3.36.4.2.1. <tt class="docutils literal"><span class="pre">match_columns</span></tt></a></li>
4990
- <li><a class="reference internal" href="#query">7.3.36.4.2.2. <tt class="docutils literal"><span class="pre">query</span></tt></a></li>
4991
- <li><a class="reference internal" href="#filter">7.3.36.4.2.3. <tt class="docutils literal"><span class="pre">filter</span></tt></a></li>
5237
+ <li><a class="reference internal" href="#search-related-parameters">7.3.41.4.2. Search related parameters</a><ul>
5238
+ <li><a class="reference internal" href="#match-columns">7.3.41.4.2.1. <code class="docutils literal"><span class="pre">match_columns</span></code></a></li>
5239
+ <li><a class="reference internal" href="#query">7.3.41.4.2.2. <code class="docutils literal"><span class="pre">query</span></code></a></li>
5240
+ <li><a class="reference internal" href="#filter">7.3.41.4.2.3. <code class="docutils literal"><span class="pre">filter</span></code></a></li>
4992
5241
  </ul>
4993
5242
  </li>
4994
- <li><a class="reference internal" href="#advanced-search-parameters">7.3.36.4.3. Advanced search parameters</a><ul>
4995
- <li><a class="reference internal" href="#match-escalation-threshold">7.3.36.4.3.1. <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt></a></li>
4996
- <li><a class="reference internal" href="#query-expansion">7.3.36.4.3.2. <tt class="docutils literal"><span class="pre">query_expansion</span></tt></a></li>
4997
- <li><a class="reference internal" href="#query-flags">7.3.36.4.3.3. <tt class="docutils literal"><span class="pre">query_flags</span></tt></a></li>
4998
- <li><a class="reference internal" href="#query-expander">7.3.36.4.3.4. <tt class="docutils literal"><span class="pre">query_expander</span></tt></a></li>
5243
+ <li><a class="reference internal" href="#advanced-search-parameters">7.3.41.4.3. Advanced search parameters</a><ul>
5244
+ <li><a class="reference internal" href="#match-escalation-threshold">7.3.41.4.3.1. <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code></a></li>
5245
+ <li><a class="reference internal" href="#query-expansion">7.3.41.4.3.2. <code class="docutils literal"><span class="pre">query_expansion</span></code></a></li>
5246
+ <li><a class="reference internal" href="#query-flags">7.3.41.4.3.3. <code class="docutils literal"><span class="pre">query_flags</span></code></a></li>
5247
+ <li><a class="reference internal" href="#query-expander">7.3.41.4.3.4. <code class="docutils literal"><span class="pre">query_expander</span></code></a></li>
4999
5248
  </ul>
5000
5249
  </li>
5001
- <li><a class="reference internal" href="#output-related-parameters">7.3.36.4.4. Output related parameters</a><ul>
5002
- <li><a class="reference internal" href="#output-columns">7.3.36.4.4.1. <tt class="docutils literal"><span class="pre">output_columns</span></tt></a></li>
5003
- <li><a class="reference internal" href="#sortby">7.3.36.4.4.2. <tt class="docutils literal"><span class="pre">sortby</span></tt></a></li>
5004
- <li><a class="reference internal" href="#offset">7.3.36.4.4.3. <tt class="docutils literal"><span class="pre">offset</span></tt></a></li>
5005
- <li><a class="reference internal" href="#limit">7.3.36.4.4.4. <tt class="docutils literal"><span class="pre">limit</span></tt></a></li>
5006
- <li><a class="reference internal" href="#scorer">7.3.36.4.4.5. <tt class="docutils literal"><span class="pre">scorer</span></tt></a></li>
5250
+ <li><a class="reference internal" href="#output-related-parameters">7.3.41.4.4. Output related parameters</a><ul>
5251
+ <li><a class="reference internal" href="#output-columns">7.3.41.4.4.1. <code class="docutils literal"><span class="pre">output_columns</span></code></a></li>
5252
+ <li><a class="reference internal" href="#sortby">7.3.41.4.4.2. <code class="docutils literal"><span class="pre">sortby</span></code></a></li>
5253
+ <li><a class="reference internal" href="#offset">7.3.41.4.4.3. <code class="docutils literal"><span class="pre">offset</span></code></a></li>
5254
+ <li><a class="reference internal" href="#limit">7.3.41.4.4.4. <code class="docutils literal"><span class="pre">limit</span></code></a></li>
5255
+ <li><a class="reference internal" href="#scorer">7.3.41.4.4.5. <code class="docutils literal"><span class="pre">scorer</span></code></a></li>
5007
5256
  </ul>
5008
5257
  </li>
5009
- <li><a class="reference internal" href="#drilldown-related-parameters">7.3.36.4.5. Drilldown related parameters</a><ul>
5010
- <li><a class="reference internal" href="#select-drilldown">7.3.36.4.5.1. <tt class="docutils literal"><span class="pre">drilldown</span></tt></a></li>
5011
- <li><a class="reference internal" href="#drilldown-sortby">7.3.36.4.5.2. <tt class="docutils literal"><span class="pre">drilldown_sortby</span></tt></a></li>
5012
- <li><a class="reference internal" href="#drilldown-output-columns">7.3.36.4.5.3. <tt class="docutils literal"><span class="pre">drilldown_output_columns</span></tt></a></li>
5013
- <li><a class="reference internal" href="#drilldown-offset">7.3.36.4.5.4. <tt class="docutils literal"><span class="pre">drilldown_offset</span></tt></a></li>
5014
- <li><a class="reference internal" href="#drilldown-limit">7.3.36.4.5.5. <tt class="docutils literal"><span class="pre">drilldown_limit</span></tt></a></li>
5015
- <li><a class="reference internal" href="#drilldown-calc-types">7.3.36.4.5.6. <tt class="docutils literal"><span class="pre">drilldown_calc_types</span></tt></a></li>
5016
- <li><a class="reference internal" href="#drilldown-calc-target">7.3.36.4.5.7. <tt class="docutils literal"><span class="pre">drilldown_calc_target</span></tt></a></li>
5258
+ <li><a class="reference internal" href="#drilldown-related-parameters">7.3.41.4.5. Drilldown related parameters</a><ul>
5259
+ <li><a class="reference internal" href="#select-drilldown">7.3.41.4.5.1. <code class="docutils literal"><span class="pre">drilldown</span></code></a></li>
5260
+ <li><a class="reference internal" href="#drilldown-sortby">7.3.41.4.5.2. <code class="docutils literal"><span class="pre">drilldown_sortby</span></code></a></li>
5261
+ <li><a class="reference internal" href="#drilldown-output-columns">7.3.41.4.5.3. <code class="docutils literal"><span class="pre">drilldown_output_columns</span></code></a></li>
5262
+ <li><a class="reference internal" href="#drilldown-offset">7.3.41.4.5.4. <code class="docutils literal"><span class="pre">drilldown_offset</span></code></a></li>
5263
+ <li><a class="reference internal" href="#drilldown-limit">7.3.41.4.5.5. <code class="docutils literal"><span class="pre">drilldown_limit</span></code></a></li>
5264
+ <li><a class="reference internal" href="#drilldown-calc-types">7.3.41.4.5.6. <code class="docutils literal"><span class="pre">drilldown_calc_types</span></code></a></li>
5265
+ <li><a class="reference internal" href="#drilldown-calc-target">7.3.41.4.5.7. <code class="docutils literal"><span class="pre">drilldown_calc_target</span></code></a></li>
5017
5266
  </ul>
5018
5267
  </li>
5019
- <li><a class="reference internal" href="#advanced-drilldown-related-parameters">7.3.36.4.6. Advanced drilldown related parameters</a><ul>
5020
- <li><a class="reference internal" href="#drilldown-label-keys">7.3.36.4.6.1. <tt class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></tt></a></li>
5021
- <li><a class="reference internal" href="#drilldown-label-output-columns">7.3.36.4.6.2. <tt class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></tt></a></li>
5022
- <li><a class="reference internal" href="#output-format-for-drilldown-label-style">7.3.36.4.6.3. Output format for <tt class="docutils literal"><span class="pre">drilldown[${LABEL}]</span></tt> style</a></li>
5268
+ <li><a class="reference internal" href="#advanced-drilldown-related-parameters">7.3.41.4.6. Advanced drilldown related parameters</a><ul>
5269
+ <li><a class="reference internal" href="#drilldown-label-keys">7.3.41.4.6.1. <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code></a></li>
5270
+ <li><a class="reference internal" href="#drilldown-label-output-columns">7.3.41.4.6.2. <code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code></a></li>
5271
+ <li><a class="reference internal" href="#output-format-for-drilldown-label-style">7.3.41.4.6.3. Output format for <code class="docutils literal"><span class="pre">drilldown[${LABEL}]</span></code> style</a></li>
5023
5272
  </ul>
5024
5273
  </li>
5025
- <li><a class="reference internal" href="#cache-related-parameter">7.3.36.4.7. Cache related parameter</a><ul>
5026
- <li><a class="reference internal" href="#cache">7.3.36.4.7.1. <tt class="docutils literal"><span class="pre">cache</span></tt></a></li>
5274
+ <li><a class="reference internal" href="#cache-related-parameter">7.3.41.4.7. Cache related parameter</a><ul>
5275
+ <li><a class="reference internal" href="#cache">7.3.41.4.7.1. <code class="docutils literal"><span class="pre">cache</span></code></a></li>
5027
5276
  </ul>
5028
5277
  </li>
5029
- <li><a class="reference internal" href="#score-related-parameters">7.3.36.4.8. Score related parameters</a><ul>
5030
- <li><a class="reference internal" href="#adjuster">7.3.36.4.8.1. <tt class="docutils literal"><span class="pre">adjuster</span></tt></a></li>
5278
+ <li><a class="reference internal" href="#score-related-parameters">7.3.41.4.8. Score related parameters</a><ul>
5279
+ <li><a class="reference internal" href="#adjuster">7.3.41.4.8.1. <code class="docutils literal"><span class="pre">adjuster</span></code></a></li>
5031
5280
  </ul>
5032
5281
  </li>
5033
5282
  </ul>
5034
5283
  </li>
5035
- <li><a class="reference internal" href="#id7">7.3.36.5. 返値</a></li>
5036
- <li><a class="reference internal" href="#see-also">7.3.36.6. See also</a></li>
5284
+ <li><a class="reference internal" href="#return-value">7.3.41.5. Return value</a></li>
5285
+ <li><a class="reference internal" href="#see-also">7.3.41.6. See also</a></li>
5037
5286
  </ul>
5038
5287
  </li>
5039
5288
  </ul>
5040
5289
 
5041
5290
  <h4>Previous topic</h4>
5042
5291
  <p class="topless"><a href="ruby_load.html"
5043
- title="previous chapter">7.3.35. <tt class="docutils literal"><span class="pre">ruby_load</span></tt></a></p>
5292
+ title="previous chapter">7.3.40. <code class="docutils literal"><span class="pre">ruby_load</span></code></a></p>
5044
5293
  <h4>Next topic</h4>
5045
5294
  <p class="topless"><a href="shutdown.html"
5046
- title="next chapter">7.3.37. <tt class="docutils literal"><span class="pre">shutdown</span></tt></a></p>
5047
- <h3>This Page</h3>
5048
- <ul class="this-page-menu">
5049
- <li><a href="../../_sources/reference/commands/select.txt"
5050
- rel="nofollow">Show Source</a></li>
5051
- </ul>
5052
- <div id="searchbox" style="display: none">
5295
+ title="next chapter">7.3.42. <code class="docutils literal"><span class="pre">shutdown</span></code></a></p>
5296
+ <div role="note" aria-label="source link">
5297
+ <h3>This Page</h3>
5298
+ <ul class="this-page-menu">
5299
+ <li><a href="../../_sources/reference/commands/select.txt"
5300
+ rel="nofollow">Show Source</a></li>
5301
+ </ul>
5302
+ </div>
5303
+ <div id="searchbox" style="display: none" role="search">
5053
5304
  <h3>Quick search</h3>
5054
5305
  <form class="search" action="../../search.html" method="get">
5055
5306
  <input type="text" name="q" />
@@ -5066,24 +5317,24 @@ the same <tt class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</spa
5066
5317
  </div>
5067
5318
  <div class="clearer"></div>
5068
5319
  </div>
5069
- <div class="related">
5320
+ <div class="related" role="navigation" aria-label="related navigation">
5070
5321
  <h3>Navigation</h3>
5071
5322
  <ul>
5072
5323
  <li class="right" style="margin-right: 10px">
5073
5324
  <a href="../../genindex.html" title="General Index"
5074
5325
  >index</a></li>
5075
5326
  <li class="right" >
5076
- <a href="shutdown.html" title="7.3.37. shutdown"
5327
+ <a href="shutdown.html" title="7.3.42. shutdown"
5077
5328
  >next</a> |</li>
5078
5329
  <li class="right" >
5079
- <a href="ruby_load.html" title="7.3.35. ruby_load"
5330
+ <a href="ruby_load.html" title="7.3.40. ruby_load"
5080
5331
  >previous</a> |</li>
5081
- <li><a href="../../index.html">Groonga v5.0.4-139-g6629adb documentation</a> &raquo;</li>
5082
- <li><a href="../../reference.html" >7. Reference manual</a> &raquo;</li>
5083
- <li><a href="../command.html" >7.3. Command</a> &raquo;</li>
5332
+ <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.6-226-gd7da7e7 documentation</a> &raquo;</li>
5333
+ <li class="nav-item nav-item-1"><a href="../../reference.html" >7. Reference manual</a> &raquo;</li>
5334
+ <li class="nav-item nav-item-2"><a href="../command.html" >7.3. Command</a> &raquo;</li>
5084
5335
  </ul>
5085
5336
  </div>
5086
- <div class="footer">
5337
+ <div class="footer" role="contentinfo">
5087
5338
  &copy; Copyright 2009-2015, Brazil, Inc.
5088
5339
  </div>
5089
5340
  </body>