rroonga 5.0.0-x86-mingw32 → 5.0.1-x86-mingw32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +8 -8
 - data/.yardopts +1 -0
 - data/Rakefile +1 -16
 - data/example/bookmark.rb +1 -6
 - data/example/index-html.rb +0 -1
 - data/ext/groonga/extconf.rb +4 -7
 - data/ext/groonga/rb-grn-array.c +1 -1
 - data/ext/groonga/rb-grn-column.c +33 -67
 - data/ext/groonga/rb-grn-context.c +5 -5
 - data/ext/groonga/rb-grn-database.c +2 -2
 - data/ext/groonga/rb-grn-double-array-trie.c +4 -2
 - data/ext/groonga/rb-grn-encoding-support.c +7 -1
 - data/ext/groonga/rb-grn-equal-operator.c +85 -0
 - data/ext/groonga/rb-grn-exception.c +17 -0
 - data/ext/groonga/rb-grn-expression.c +85 -43
 - data/ext/groonga/rb-grn-greater-equal-operator.c +88 -0
 - data/ext/groonga/rb-grn-greater-operator.c +85 -0
 - data/ext/groonga/rb-grn-hash.c +1 -1
 - data/ext/groonga/rb-grn-index-column.c +150 -11
 - data/ext/groonga/rb-grn-less-equal-operator.c +88 -0
 - data/ext/groonga/rb-grn-less-operator.c +85 -0
 - data/ext/groonga/rb-grn-logger.c +5 -5
 - data/ext/groonga/rb-grn-match-operator.c +86 -0
 - data/ext/groonga/rb-grn-normalizer.c +8 -1
 - data/ext/groonga/rb-grn-not-equal-operator.c +85 -0
 - data/ext/groonga/rb-grn-object.c +170 -36
 - data/ext/groonga/rb-grn-operator.c +395 -172
 - data/ext/groonga/rb-grn-patricia-trie.c +10 -8
 - data/ext/groonga/rb-grn-plugin.c +51 -3
 - data/ext/groonga/rb-grn-prefix-operator.c +86 -0
 - data/ext/groonga/rb-grn-procedure-type.c +4 -0
 - data/ext/groonga/rb-grn-query-logger.c +4 -4
 - data/ext/groonga/rb-grn-regexp-operator.c +85 -0
 - data/ext/groonga/rb-grn-snippet.c +1 -1
 - data/ext/groonga/rb-grn-table-key-support.c +9 -5
 - data/ext/groonga/rb-grn-table.c +52 -66
 - data/ext/groonga/rb-grn-type.c +1 -1
 - data/ext/groonga/rb-grn-utils.c +22 -3
 - data/ext/groonga/rb-grn.h +31 -4
 - data/ext/groonga/rb-groonga.c +9 -9
 - data/lib/1.9/groonga.so +0 -0
 - data/lib/2.0/groonga.so +0 -0
 - data/lib/2.1/groonga.so +0 -0
 - data/lib/2.2/groonga.so +0 -0
 - data/lib/groonga/context.rb +31 -0
 - data/lib/groonga/expression-builder.rb +14 -1
 - data/lib/groonga/record.rb +10 -8
 - data/lib/groonga/schema.rb +3 -1
 - data/rroonga-build.rb +2 -2
 - data/rroonga.gemspec +3 -3
 - data/test/groonga-test-utils.rb +4 -0
 - data/test/test-column.rb +28 -26
 - data/test/test-exception.rb +1 -0
 - data/test/test-expression-builder.rb +83 -1
 - data/test/test-expression.rb +80 -48
 - data/test/test-index-column.rb +102 -29
 - data/test/test-normalizer.rb +35 -29
 - data/test/test-operator.rb +214 -0
 - data/test/test-plugin.rb +24 -6
 - data/test/test-procedure.rb +29 -0
 - data/test/test-schema-type.rb +14 -0
 - data/test/test-table-select-mecab.rb +1 -4
 - data/test/test-table.rb +7 -0
 - data/test/test-token-regexp.rb +30 -0
 - data/test/test-type.rb +24 -0
 - data/vendor/local/bin/grndb.exe +0 -0
 - data/vendor/local/bin/groonga-benchmark.exe +0 -0
 - data/vendor/local/bin/groonga.exe +0 -0
 - data/vendor/local/bin/libgcc_s_sjlj-1.dll +0 -0
 - data/vendor/local/bin/libgroonga-0.dll +0 -0
 - data/vendor/local/bin/libmecab-1.dll +0 -0
 - data/vendor/local/bin/libmsgpack-3.dll +0 -0
 - data/vendor/local/bin/libmsgpackc-2.dll +0 -0
 - data/vendor/local/bin/libonig-5.dll +0 -0
 - data/vendor/local/bin/libstdc++-6.dll +0 -0
 - data/vendor/local/bin/lz4.exe +0 -0
 - data/vendor/local/bin/lz4c.exe +0 -0
 - data/vendor/local/bin/lz4cat +0 -0
 - data/vendor/local/bin/mecab-config +2 -2
 - data/vendor/local/bin/mecab.exe +0 -0
 - data/vendor/local/bin/onig-config +1 -1
 - data/vendor/local/bin/zlib1.dll +0 -0
 - data/vendor/local/etc/groonga/groonga.conf +1 -1
 - data/vendor/local/etc/groonga/httpd/groonga-httpd.conf +2 -2
 - data/vendor/local/include/groonga/groonga.h +1 -0
 - data/vendor/local/include/groonga/groonga/expr.h +2 -0
 - data/vendor/local/include/groonga/groonga/groonga.h +32 -5
 - data/vendor/local/include/groonga/groonga/ii.h +7 -0
 - data/vendor/local/include/groonga/groonga/obj.h +37 -0
 - data/vendor/local/include/groonga/groonga/scorer.h +95 -0
 - data/vendor/local/lib/groonga/plugins/query_expanders/tsv.a +0 -0
 - data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll +0 -0
 - data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll.a +0 -0
 - data/vendor/local/lib/groonga/plugins/query_expanders/tsv.la +2 -2
 - data/vendor/local/lib/groonga/plugins/ruby/eval.a +0 -0
 - data/vendor/local/lib/groonga/plugins/ruby/eval.dll +0 -0
 - data/vendor/local/lib/groonga/plugins/ruby/eval.dll.a +0 -0
 - data/vendor/local/lib/groonga/plugins/ruby/eval.la +2 -2
 - data/vendor/local/lib/groonga/plugins/ruby/load.a +0 -0
 - data/vendor/local/lib/groonga/plugins/ruby/load.dll +0 -0
 - data/vendor/local/lib/groonga/plugins/ruby/load.dll.a +0 -0
 - data/vendor/local/lib/groonga/plugins/ruby/load.la +2 -2
 - data/vendor/local/lib/groonga/plugins/sharding/logical_count.rb +6 -3
 - data/vendor/local/lib/groonga/plugins/sharding/logical_enumerator.rb +6 -5
 - data/vendor/local/lib/groonga/plugins/sharding/logical_range_filter.rb +421 -17
 - data/vendor/local/lib/groonga/plugins/suggest/suggest.a +0 -0
 - data/vendor/local/lib/groonga/plugins/suggest/suggest.dll +0 -0
 - data/vendor/local/lib/groonga/plugins/suggest/suggest.dll.a +0 -0
 - data/vendor/local/lib/groonga/plugins/suggest/suggest.la +2 -2
 - data/vendor/local/lib/groonga/plugins/table/table.a +0 -0
 - data/vendor/local/lib/groonga/plugins/table/table.dll +0 -0
 - data/vendor/local/lib/groonga/plugins/table/table.dll.a +0 -0
 - data/vendor/local/lib/groonga/plugins/table/table.la +2 -2
 - data/vendor/local/lib/groonga/plugins/token_filters/stop_word.a +0 -0
 - data/vendor/local/lib/groonga/plugins/token_filters/stop_word.dll +0 -0
 - data/vendor/local/lib/groonga/plugins/token_filters/stop_word.dll.a +0 -0
 - data/vendor/local/lib/groonga/plugins/token_filters/stop_word.la +2 -2
 - data/vendor/local/lib/groonga/plugins/tokenizers/mecab.a +0 -0
 - data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll +0 -0
 - data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll.a +0 -0
 - data/vendor/local/lib/groonga/plugins/tokenizers/mecab.la +2 -2
 - data/vendor/local/lib/groonga/scripts/ruby/backtrace_entry.rb +12 -4
 - data/vendor/local/lib/groonga/scripts/ruby/database.rb +11 -3
 - data/vendor/local/lib/groonga/scripts/ruby/expression.rb +23 -0
 - data/vendor/local/lib/groonga/scripts/ruby/expression_size_estimator.rb +158 -0
 - data/vendor/local/lib/groonga/scripts/ruby/index_column.rb +39 -0
 - data/vendor/local/lib/groonga/scripts/ruby/initialize/post.rb +4 -0
 - data/vendor/local/lib/groonga/scripts/ruby/initialize/pre.rb +2 -0
 - data/vendor/local/lib/groonga/scripts/ruby/logger.rb +11 -7
 - data/vendor/local/lib/groonga/scripts/ruby/object.rb +11 -0
 - data/vendor/local/lib/groonga/scripts/ruby/operator.rb +22 -0
 - data/vendor/local/lib/groonga/scripts/ruby/scan_info.rb +7 -2
 - data/vendor/local/lib/groonga/scripts/ruby/scan_info_builder.rb +7 -11
 - data/vendor/local/lib/groonga/scripts/ruby/scan_info_data.rb +137 -34
 - data/vendor/local/lib/groonga/scripts/ruby/scan_info_search_index.rb +9 -0
 - data/vendor/local/lib/libgroonga.a +0 -0
 - data/vendor/local/lib/libgroonga.dll.a +0 -0
 - data/vendor/local/lib/libgroonga.la +2 -2
 - data/vendor/local/lib/liblz4.a +0 -0
 - data/vendor/local/lib/liblz4.dll +0 -0
 - data/vendor/local/lib/liblz4.dll.1 +0 -0
 - data/vendor/local/lib/liblz4.dll.1.5.0 +0 -0
 - data/vendor/local/lib/libmecab.a +0 -0
 - data/vendor/local/lib/libmecab.dll.a +0 -0
 - data/vendor/local/lib/libmecab.la +2 -2
 - data/vendor/local/lib/libmsgpack.a +0 -0
 - data/vendor/local/lib/libmsgpack.dll.a +0 -0
 - data/vendor/local/lib/libmsgpack.la +2 -2
 - data/vendor/local/lib/libmsgpackc.a +0 -0
 - data/vendor/local/lib/libmsgpackc.dll.a +0 -0
 - data/vendor/local/lib/libmsgpackc.la +2 -2
 - data/vendor/local/lib/libonig.a +0 -0
 - data/vendor/local/lib/libonig.dll.a +0 -0
 - data/vendor/local/lib/libonig.la +2 -2
 - data/vendor/local/lib/libz.a +0 -0
 - data/vendor/local/lib/libz.dll.a +0 -0
 - data/vendor/local/lib/pkgconfig/groonga.pc +3 -3
 - data/vendor/local/lib/pkgconfig/liblz4.pc +5 -5
 - data/vendor/local/lib/pkgconfig/msgpack.pc +1 -1
 - data/vendor/local/lib/pkgconfig/oniguruma.pc +6 -6
 - data/vendor/local/lib/pkgconfig/zlib.pc +3 -3
 - data/vendor/local/libexec/mecab/mecab-cost-train.exe +0 -0
 - data/vendor/local/libexec/mecab/mecab-dict-gen.exe +0 -0
 - data/vendor/local/libexec/mecab/mecab-dict-index.exe +0 -0
 - data/vendor/local/libexec/mecab/mecab-system-eval.exe +0 -0
 - data/vendor/local/libexec/mecab/mecab-test-gen.exe +0 -0
 - data/vendor/local/sbin/groonga-httpd-restart +1 -1
 - data/vendor/local/sbin/groonga-httpd.exe +0 -0
 - data/vendor/local/share/doc/groonga/en/html/.buildinfo +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_images/used-when-indexing.png +0 -0
 - data/vendor/local/share/doc/groonga/en/html/_images/used-when-searching.png +0 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/characteristic.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/release.txt +32 -17
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/centos.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/debian.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/fedora.txt +4 -4
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/mac_os_x.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/others.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/solaris.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/ubuntu.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/windows.txt +9 -9
 - data/vendor/local/share/doc/groonga/en/html/_sources/news.txt +194 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/news/1.0.x.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/news/3.x.txt +2 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/news/4.x.txt +2 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference.txt +2 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/api.txt +3 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/api/grn_ctx.txt +42 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/api/overview.txt +54 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/cache_limit.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/column_create.txt +2 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/column_list.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/column_rename.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/delete.txt +4 -4
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/load.txt +5 -5
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/lock_clear.txt +4 -4
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_count.txt +173 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_range_filter.txt +112 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/normalize.txt +7 -6
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/plugin_register.txt +64 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/plugin_unregister.txt +63 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/register.txt +11 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/request_cancel.txt +3 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/ruby_eval.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/ruby_load.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/select.txt +17 -17
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/suggest.txt +12 -12
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_create.txt +7 -7
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_tokenize.txt +4 -4
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/tokenize.txt +6 -6
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/truncate.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/executables/groonga.txt +47 -26
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/between.txt +5 -5
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/geo_distance.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/highlight_full.txt +6 -6
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/highlight_html.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/html_untag.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/in_values.txt +54 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/query.txt +4 -4
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/sub_filter.txt +4 -4
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/grn_expr/query_syntax.txt +44 -18
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/grn_expr/script_syntax.txt +41 -11
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/indexing.txt +2 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/normalizers.txt +4 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/operations.txt +2 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/regular_expression.txt +403 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/scorer.txt +217 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/scorers/scorer_tf_at_most.txt +22 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/scorers/scorer_tf_idf.txt +110 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/scoring_note.txt +13 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/tables.txt +8 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/tokenizers.txt +530 -16
 - data/vendor/local/share/doc/groonga/en/html/_sources/server.txt +2 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/server/memcached.txt +15 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/spec/gqtp.txt +66 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/troubleshooting/different_results_with_the_same_keyword.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/network.txt +0 -81
 - data/vendor/local/share/doc/groonga/en/html/_static/basic.css +6 -68
 - data/vendor/local/share/doc/groonga/en/html/_static/doctools.js +1 -26
 - data/vendor/local/share/doc/groonga/en/html/_static/down-pressed.png +0 -0
 - data/vendor/local/share/doc/groonga/en/html/_static/down.png +0 -0
 - data/vendor/local/share/doc/groonga/en/html/_static/file.png +0 -0
 - data/vendor/local/share/doc/groonga/en/html/_static/jquery.js +9404 -4
 - data/vendor/local/share/doc/groonga/en/html/_static/minus.png +0 -0
 - data/vendor/local/share/doc/groonga/en/html/_static/plus.png +0 -0
 - data/vendor/local/share/doc/groonga/en/html/_static/searchtools.js +2 -2
 - data/vendor/local/share/doc/groonga/en/html/_static/underscore.js +1415 -31
 - data/vendor/local/share/doc/groonga/en/html/_static/up-pressed.png +0 -0
 - data/vendor/local/share/doc/groonga/en/html/_static/up.png +0 -0
 - data/vendor/local/share/doc/groonga/en/html/_static/websupport.js +15 -15
 - data/vendor/local/share/doc/groonga/en/html/characteristic.html +18 -20
 - data/vendor/local/share/doc/groonga/en/html/client.html +22 -24
 - data/vendor/local/share/doc/groonga/en/html/community.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/contribution.html +18 -20
 - data/vendor/local/share/doc/groonga/en/html/contribution/development.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/com.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/cooperation.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/query.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/release.html +51 -38
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/repository.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/test.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/contribution/documentation.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/contribution/documentation/c-api.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/contribution/documentation/i18n.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/contribution/documentation/introduction.html +24 -26
 - data/vendor/local/share/doc/groonga/en/html/contribution/report.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/development.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/development/travis-ci.html +24 -26
 - data/vendor/local/share/doc/groonga/en/html/genindex.html +26 -14
 - data/vendor/local/share/doc/groonga/en/html/index.html +150 -130
 - data/vendor/local/share/doc/groonga/en/html/install.html +32 -34
 - data/vendor/local/share/doc/groonga/en/html/install/centos.html +28 -30
 - data/vendor/local/share/doc/groonga/en/html/install/debian.html +24 -26
 - data/vendor/local/share/doc/groonga/en/html/install/fedora.html +28 -30
 - data/vendor/local/share/doc/groonga/en/html/install/mac_os_x.html +22 -24
 - data/vendor/local/share/doc/groonga/en/html/install/others.html +87 -89
 - data/vendor/local/share/doc/groonga/en/html/install/solaris.html +22 -24
 - data/vendor/local/share/doc/groonga/en/html/install/ubuntu.html +25 -27
 - data/vendor/local/share/doc/groonga/en/html/install/windows.html +30 -32
 - data/vendor/local/share/doc/groonga/en/html/limitations.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/news.html +256 -27
 - data/vendor/local/share/doc/groonga/en/html/news/0.x.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/news/1.0.x.html +19 -21
 - data/vendor/local/share/doc/groonga/en/html/news/1.1.x.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/news/1.2.x.html +32 -34
 - data/vendor/local/share/doc/groonga/en/html/news/1.3.x.html +27 -29
 - data/vendor/local/share/doc/groonga/en/html/news/2.x.html +98 -100
 - data/vendor/local/share/doc/groonga/en/html/news/3.x.html +68 -70
 - data/vendor/local/share/doc/groonga/en/html/news/4.x.html +102 -104
 - data/vendor/local/share/doc/groonga/en/html/news/senna.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/objects.inv +0 -0
 - data/vendor/local/share/doc/groonga/en/html/reference.html +139 -118
 - data/vendor/local/share/doc/groonga/en/html/reference/api.html +51 -52
 - data/vendor/local/share/doc/groonga/en/html/reference/api/global_configurations.html +49 -51
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_cache.html +60 -62
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_column.html +80 -82
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_command_version.html +42 -44
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_content_type.html +37 -39
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ctx.html +130 -80
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_db.html +48 -50
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_encoding.html +44 -46
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_expr.html +79 -81
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_geo.html +42 -44
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_hook.html +44 -46
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ii.html +42 -44
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_index_cursor.html +41 -43
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_info.html +41 -43
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_match_escalation.html +40 -42
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_obj.html +89 -91
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_proc.html +44 -46
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_search.html +39 -41
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table.html +75 -77
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table_cursor.html +64 -66
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_type.html +40 -42
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_user_data.html +39 -41
 - data/vendor/local/share/doc/groonga/en/html/reference/api/overview.html +202 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/api/plugin.html +58 -60
 - data/vendor/local/share/doc/groonga/en/html/reference/cast.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/reference/column.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/reference/columns/index.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/reference/columns/pseudo.html +22 -24
 - data/vendor/local/share/doc/groonga/en/html/reference/columns/scalar.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/reference/columns/vector.html +58 -60
 - data/vendor/local/share/doc/groonga/en/html/reference/command.html +56 -54
 - data/vendor/local/share/doc/groonga/en/html/reference/command/command_version.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/reference/command/output_format.html +53 -55
 - data/vendor/local/share/doc/groonga/en/html/reference/command/request_id.html +22 -24
 - data/vendor/local/share/doc/groonga/en/html/reference/command/return_code.html +94 -96
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/cache_limit.html +39 -41
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/check.html +43 -45
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/clearlock.html +23 -25
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/column_create.html +39 -41
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/column_list.html +71 -73
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/column_remove.html +24 -26
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/column_rename.html +44 -46
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/define_selector.html +37 -39
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/defrag.html +24 -26
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/delete.html +35 -37
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/dump.html +22 -24
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/load.html +43 -45
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/lock_clear.html +49 -47
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/log_level.html +23 -25
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/log_put.html +24 -26
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/log_reopen.html +26 -28
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_count.html +314 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_range_filter.html +252 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/normalize.html +87 -89
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/normalizer_list.html +46 -48
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/plugin_register.html +195 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/plugin_unregister.html +193 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/quit.html +38 -40
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/range_filter.html +37 -39
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/register.html +61 -51
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/request_cancel.html +72 -74
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_eval.html +54 -56
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_load.html +54 -56
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/select.html +590 -592
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/shutdown.html +37 -39
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/status.html +40 -42
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/suggest.html +92 -94
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/table_create.html +152 -154
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/table_list.html +49 -51
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/table_remove.html +39 -41
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/table_tokenize.html +68 -70
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenize.html +103 -105
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenizer_list.html +45 -47
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/truncate.html +52 -54
 - data/vendor/local/share/doc/groonga/en/html/reference/executables.html +19 -21
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/grndb.html +35 -37
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/grnslap.html +21 -23
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-benchmark.html +26 -28
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-httpd.html +73 -75
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-server-http.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-create-dataset.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-httpd.html +42 -44
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-learner.html +34 -36
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga.html +124 -90
 - data/vendor/local/share/doc/groonga/en/html/reference/function.html +42 -44
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/between.html +66 -68
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/edit_distance.html +44 -46
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_distance.html +113 -115
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_circle.html +55 -57
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_rectangle.html +45 -47
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/highlight_full.html +81 -83
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/highlight_html.html +65 -67
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/html_untag.html +54 -56
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/in_values.html +135 -44
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/now.html +40 -42
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/query.html +81 -83
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/rand.html +43 -45
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/snippet_html.html +67 -69
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/sub_filter.html +66 -70
 - data/vendor/local/share/doc/groonga/en/html/reference/grn_expr.html +39 -41
 - data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/query_syntax.html +349 -286
 - data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/script_syntax.html +483 -417
 - data/vendor/local/share/doc/groonga/en/html/reference/indexing.html +35 -37
 - data/vendor/local/share/doc/groonga/en/html/reference/log.html +38 -40
 - data/vendor/local/share/doc/groonga/en/html/reference/normalizers.html +44 -46
 - data/vendor/local/share/doc/groonga/en/html/reference/operations.html +30 -31
 - data/vendor/local/share/doc/groonga/en/html/reference/operations/geolocation_search.html +32 -34
 - data/vendor/local/share/doc/groonga/en/html/reference/output.html +32 -34
 - data/vendor/local/share/doc/groonga/en/html/reference/query_expanders.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/reference/query_expanders/tsv.html +60 -62
 - data/vendor/local/share/doc/groonga/en/html/reference/regular_expression.html +931 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/scorer.html +442 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/scorers/scorer_tf_at_most.html +153 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/scorers/scorer_tf_idf.html +287 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/scoring_note.html +114 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/suggest.html +45 -47
 - data/vendor/local/share/doc/groonga/en/html/reference/suggest/completion.html +51 -53
 - data/vendor/local/share/doc/groonga/en/html/reference/suggest/correction.html +40 -42
 - data/vendor/local/share/doc/groonga/en/html/reference/suggest/introduction.html +38 -40
 - data/vendor/local/share/doc/groonga/en/html/reference/suggest/suggestion.html +40 -42
 - data/vendor/local/share/doc/groonga/en/html/reference/tables.html +52 -54
 - data/vendor/local/share/doc/groonga/en/html/reference/token_filters.html +36 -38
 - data/vendor/local/share/doc/groonga/en/html/reference/tokenizers.html +1394 -34
 - data/vendor/local/share/doc/groonga/en/html/reference/tuning.html +57 -59
 - data/vendor/local/share/doc/groonga/en/html/reference/types.html +38 -40
 - data/vendor/local/share/doc/groonga/en/html/search.html +11 -11
 - data/vendor/local/share/doc/groonga/en/html/searchindex.js +1 -1
 - data/vendor/local/share/doc/groonga/en/html/server.html +23 -24
 - data/vendor/local/share/doc/groonga/en/html/server/gqtp.html +28 -30
 - data/vendor/local/share/doc/groonga/en/html/server/http.html +42 -44
 - data/vendor/local/share/doc/groonga/en/html/server/http/comparison.html +68 -70
 - data/vendor/local/share/doc/groonga/en/html/server/http/groonga-httpd.html +30 -32
 - data/vendor/local/share/doc/groonga/en/html/server/http/groonga.html +29 -31
 - data/vendor/local/share/doc/groonga/en/html/server/memcached.html +137 -0
 - data/vendor/local/share/doc/groonga/en/html/server/package.html +36 -38
 - data/vendor/local/share/doc/groonga/en/html/spec.html +22 -24
 - data/vendor/local/share/doc/groonga/en/html/spec/gqtp.html +208 -129
 - data/vendor/local/share/doc/groonga/en/html/spec/search.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/troubleshooting.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/troubleshooting/different_results_with_the_same_keyword.html +18 -20
 - data/vendor/local/share/doc/groonga/en/html/troubleshooting/mmap_cannot_allocate_memory.html +18 -20
 - data/vendor/local/share/doc/groonga/en/html/tutorial.html +21 -25
 - data/vendor/local/share/doc/groonga/en/html/tutorial/data.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/tutorial/drilldown.html +31 -33
 - data/vendor/local/share/doc/groonga/en/html/tutorial/index.html +20 -22
 - data/vendor/local/share/doc/groonga/en/html/tutorial/introduction.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/tutorial/lexicon.html +17 -19
 - data/vendor/local/share/doc/groonga/en/html/tutorial/match_columns.html +21 -23
 - data/vendor/local/share/doc/groonga/en/html/tutorial/micro_blog.html +50 -52
 - data/vendor/local/share/doc/groonga/en/html/tutorial/network.html +27 -125
 - data/vendor/local/share/doc/groonga/en/html/tutorial/patricia_trie.html +18 -20
 - data/vendor/local/share/doc/groonga/en/html/tutorial/query_expansion.html +20 -22
 - data/vendor/local/share/doc/groonga/en/html/tutorial/search.html +33 -35
 - data/vendor/local/share/doc/groonga/ja/html/.buildinfo +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_images/used-when-indexing.png +0 -0
 - data/vendor/local/share/doc/groonga/ja/html/_images/used-when-searching.png +0 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/characteristic.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/release.txt +32 -17
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/centos.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/debian.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/fedora.txt +4 -4
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/mac_os_x.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/others.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/solaris.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/ubuntu.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/windows.txt +9 -9
 - data/vendor/local/share/doc/groonga/ja/html/_sources/news.txt +194 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/news/1.0.x.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/news/3.x.txt +2 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/news/4.x.txt +2 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference.txt +2 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api.txt +3 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/grn_ctx.txt +42 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/overview.txt +54 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/cache_limit.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/column_create.txt +2 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/column_list.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/column_rename.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/delete.txt +4 -4
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/load.txt +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/lock_clear.txt +4 -4
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_count.txt +173 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_range_filter.txt +112 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/normalize.txt +7 -6
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/plugin_register.txt +64 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/plugin_unregister.txt +63 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/register.txt +11 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/request_cancel.txt +3 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/ruby_eval.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/ruby_load.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/select.txt +17 -17
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/suggest.txt +12 -12
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_create.txt +7 -7
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_tokenize.txt +4 -4
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/tokenize.txt +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/truncate.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/groonga.txt +47 -26
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/between.txt +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/geo_distance.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/highlight_full.txt +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/highlight_html.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/html_untag.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/in_values.txt +54 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/query.txt +4 -4
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/sub_filter.txt +4 -4
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/grn_expr/query_syntax.txt +44 -18
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/grn_expr/script_syntax.txt +41 -11
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/indexing.txt +2 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/normalizers.txt +4 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/operations.txt +2 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/regular_expression.txt +403 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/scorer.txt +217 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/scorers/scorer_tf_at_most.txt +22 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/scorers/scorer_tf_idf.txt +110 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/scoring_note.txt +13 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/tables.txt +8 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/tokenizers.txt +530 -16
 - data/vendor/local/share/doc/groonga/ja/html/_sources/server.txt +2 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/server/memcached.txt +15 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/spec/gqtp.txt +66 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/troubleshooting/different_results_with_the_same_keyword.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/network.txt +0 -81
 - data/vendor/local/share/doc/groonga/ja/html/_static/basic.css +6 -68
 - data/vendor/local/share/doc/groonga/ja/html/_static/doctools.js +1 -26
 - data/vendor/local/share/doc/groonga/ja/html/_static/down-pressed.png +0 -0
 - data/vendor/local/share/doc/groonga/ja/html/_static/down.png +0 -0
 - data/vendor/local/share/doc/groonga/ja/html/_static/file.png +0 -0
 - data/vendor/local/share/doc/groonga/ja/html/_static/jquery.js +9404 -4
 - data/vendor/local/share/doc/groonga/ja/html/_static/minus.png +0 -0
 - data/vendor/local/share/doc/groonga/ja/html/_static/plus.png +0 -0
 - data/vendor/local/share/doc/groonga/ja/html/_static/searchtools.js +2 -2
 - data/vendor/local/share/doc/groonga/ja/html/_static/underscore.js +1415 -31
 - data/vendor/local/share/doc/groonga/ja/html/_static/up-pressed.png +0 -0
 - data/vendor/local/share/doc/groonga/ja/html/_static/up.png +0 -0
 - data/vendor/local/share/doc/groonga/ja/html/_static/websupport.js +15 -15
 - data/vendor/local/share/doc/groonga/ja/html/characteristic.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/client.html +22 -24
 - data/vendor/local/share/doc/groonga/ja/html/community.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/contribution.html +18 -20
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/com.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/cooperation.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/query.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/release.html +51 -38
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/repository.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/test.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/contribution/documentation.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/c-api.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/i18n.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/introduction.html +24 -26
 - data/vendor/local/share/doc/groonga/ja/html/contribution/report.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/development.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/development/travis-ci.html +20 -22
 - data/vendor/local/share/doc/groonga/ja/html/genindex.html +26 -14
 - data/vendor/local/share/doc/groonga/ja/html/index.html +150 -130
 - data/vendor/local/share/doc/groonga/ja/html/install.html +32 -34
 - data/vendor/local/share/doc/groonga/ja/html/install/centos.html +31 -33
 - data/vendor/local/share/doc/groonga/ja/html/install/debian.html +25 -27
 - data/vendor/local/share/doc/groonga/ja/html/install/fedora.html +29 -31
 - data/vendor/local/share/doc/groonga/ja/html/install/mac_os_x.html +22 -24
 - data/vendor/local/share/doc/groonga/ja/html/install/others.html +78 -80
 - data/vendor/local/share/doc/groonga/ja/html/install/solaris.html +21 -23
 - data/vendor/local/share/doc/groonga/ja/html/install/ubuntu.html +26 -28
 - data/vendor/local/share/doc/groonga/ja/html/install/windows.html +29 -31
 - data/vendor/local/share/doc/groonga/ja/html/limitations.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/news.html +210 -27
 - data/vendor/local/share/doc/groonga/ja/html/news/0.x.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/news/1.0.x.html +19 -21
 - data/vendor/local/share/doc/groonga/ja/html/news/1.1.x.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/news/1.2.x.html +32 -34
 - data/vendor/local/share/doc/groonga/ja/html/news/1.3.x.html +27 -29
 - data/vendor/local/share/doc/groonga/ja/html/news/2.x.html +91 -93
 - data/vendor/local/share/doc/groonga/ja/html/news/3.x.html +59 -61
 - data/vendor/local/share/doc/groonga/ja/html/news/4.x.html +89 -91
 - data/vendor/local/share/doc/groonga/ja/html/news/senna.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/objects.inv +0 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference.html +139 -118
 - data/vendor/local/share/doc/groonga/ja/html/reference/api.html +51 -52
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/global_configurations.html +49 -51
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_cache.html +55 -57
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_column.html +80 -82
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_command_version.html +42 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_content_type.html +37 -39
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ctx.html +126 -76
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_db.html +48 -50
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_encoding.html +44 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_expr.html +74 -76
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_geo.html +42 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_hook.html +44 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ii.html +42 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_index_cursor.html +41 -43
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_info.html +41 -43
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_match_escalation.html +40 -42
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_obj.html +89 -91
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_proc.html +44 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_search.html +39 -41
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table.html +75 -77
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table_cursor.html +64 -66
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_type.html +40 -42
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_user_data.html +39 -41
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/overview.html +197 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/plugin.html +58 -60
 - data/vendor/local/share/doc/groonga/ja/html/reference/cast.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/reference/column.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/reference/columns/index.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/reference/columns/pseudo.html +22 -24
 - data/vendor/local/share/doc/groonga/ja/html/reference/columns/scalar.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/reference/columns/vector.html +48 -50
 - data/vendor/local/share/doc/groonga/ja/html/reference/command.html +56 -54
 - data/vendor/local/share/doc/groonga/ja/html/reference/command/command_version.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/reference/command/output_format.html +43 -45
 - data/vendor/local/share/doc/groonga/ja/html/reference/command/request_id.html +22 -24
 - data/vendor/local/share/doc/groonga/ja/html/reference/command/return_code.html +93 -95
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/cache_limit.html +35 -37
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/check.html +43 -45
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/clearlock.html +23 -25
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_create.html +39 -41
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_list.html +62 -64
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_remove.html +24 -26
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_rename.html +38 -40
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/define_selector.html +37 -39
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/defrag.html +24 -26
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/delete.html +32 -34
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/dump.html +22 -24
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/load.html +33 -35
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/lock_clear.html +48 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_level.html +23 -25
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_put.html +24 -26
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_reopen.html +26 -28
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_count.html +314 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_range_filter.html +250 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalize.html +80 -81
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalizer_list.html +46 -48
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/plugin_register.html +188 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/plugin_unregister.html +190 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/quit.html +38 -40
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/range_filter.html +37 -39
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/register.html +57 -47
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/request_cancel.html +71 -73
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_eval.html +53 -55
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_load.html +53 -55
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/select.html +394 -396
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/shutdown.html +37 -39
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/status.html +38 -40
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/suggest.html +78 -80
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_create.html +123 -125
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_list.html +49 -51
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_remove.html +39 -41
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_tokenize.html +61 -63
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenize.html +89 -91
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenizer_list.html +46 -48
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/truncate.html +51 -53
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables.html +19 -21
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/grndb.html +35 -37
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/grnslap.html +21 -23
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-benchmark.html +26 -28
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-httpd.html +61 -63
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-server-http.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-create-dataset.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-httpd.html +42 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-learner.html +34 -36
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga.html +126 -90
 - data/vendor/local/share/doc/groonga/ja/html/reference/function.html +42 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/between.html +63 -65
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/edit_distance.html +44 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_distance.html +94 -96
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_circle.html +55 -57
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_rectangle.html +45 -47
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/highlight_full.html +66 -68
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/highlight_html.html +55 -57
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/html_untag.html +53 -55
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/in_values.html +135 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/now.html +40 -42
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/query.html +70 -72
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/rand.html +43 -45
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/snippet_html.html +53 -55
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/sub_filter.html +56 -62
 - data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr.html +36 -38
 - data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/query_syntax.html +229 -171
 - data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/script_syntax.html +381 -322
 - data/vendor/local/share/doc/groonga/ja/html/reference/indexing.html +34 -36
 - data/vendor/local/share/doc/groonga/ja/html/reference/log.html +38 -40
 - data/vendor/local/share/doc/groonga/ja/html/reference/normalizers.html +38 -40
 - data/vendor/local/share/doc/groonga/ja/html/reference/operations.html +28 -30
 - data/vendor/local/share/doc/groonga/ja/html/reference/operations/geolocation_search.html +32 -34
 - data/vendor/local/share/doc/groonga/ja/html/reference/output.html +28 -30
 - data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders/tsv.html +39 -41
 - data/vendor/local/share/doc/groonga/ja/html/reference/regular_expression.html +878 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/scorer.html +442 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/scorers/scorer_tf_at_most.html +154 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/scorers/scorer_tf_idf.html +287 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/scoring_note.html +115 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/suggest.html +45 -47
 - data/vendor/local/share/doc/groonga/ja/html/reference/suggest/completion.html +48 -50
 - data/vendor/local/share/doc/groonga/ja/html/reference/suggest/correction.html +40 -42
 - data/vendor/local/share/doc/groonga/ja/html/reference/suggest/introduction.html +38 -40
 - data/vendor/local/share/doc/groonga/ja/html/reference/suggest/suggestion.html +40 -42
 - data/vendor/local/share/doc/groonga/ja/html/reference/tables.html +42 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/token_filters.html +37 -39
 - data/vendor/local/share/doc/groonga/ja/html/reference/tokenizers.html +1300 -34
 - data/vendor/local/share/doc/groonga/ja/html/reference/tuning.html +57 -59
 - data/vendor/local/share/doc/groonga/ja/html/reference/types.html +38 -40
 - data/vendor/local/share/doc/groonga/ja/html/search.html +11 -11
 - data/vendor/local/share/doc/groonga/ja/html/searchindex.js +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/server.html +23 -24
 - data/vendor/local/share/doc/groonga/ja/html/server/gqtp.html +28 -30
 - data/vendor/local/share/doc/groonga/ja/html/server/http.html +42 -44
 - data/vendor/local/share/doc/groonga/ja/html/server/http/comparison.html +62 -64
 - data/vendor/local/share/doc/groonga/ja/html/server/http/groonga-httpd.html +30 -32
 - data/vendor/local/share/doc/groonga/ja/html/server/http/groonga.html +29 -31
 - data/vendor/local/share/doc/groonga/ja/html/server/memcached.html +138 -0
 - data/vendor/local/share/doc/groonga/ja/html/server/package.html +35 -37
 - data/vendor/local/share/doc/groonga/ja/html/spec.html +22 -24
 - data/vendor/local/share/doc/groonga/ja/html/spec/gqtp.html +207 -128
 - data/vendor/local/share/doc/groonga/ja/html/spec/search.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/troubleshooting.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/troubleshooting/different_results_with_the_same_keyword.html +18 -20
 - data/vendor/local/share/doc/groonga/ja/html/troubleshooting/mmap_cannot_allocate_memory.html +18 -20
 - data/vendor/local/share/doc/groonga/ja/html/tutorial.html +21 -25
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/data.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/drilldown.html +30 -32
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/index.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/introduction.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/lexicon.html +17 -19
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/match_columns.html +23 -25
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/micro_blog.html +47 -49
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/network.html +27 -125
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/patricia_trie.html +18 -20
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/query_expansion.html +20 -22
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/search.html +31 -33
 - data/vendor/local/share/license/mruby/README.md +2 -2
 - data/vendor/local/share/man/ja/man1/groonga.1 +6205 -2251
 - data/vendor/local/share/man/man1/groonga.1 +7210 -3029
 - metadata +75 -11
 - data/doc/text/news.textile +0 -1217
 - data/vendor/local/share/doc/groonga/en/html/_static/jquery-1.11.1.js +0 -10308
 - data/vendor/local/share/doc/groonga/en/html/_static/underscore-1.3.1.js +0 -999
 - data/vendor/local/share/doc/groonga/ja/html/_static/jquery-1.11.1.js +0 -10308
 - data/vendor/local/share/doc/groonga/ja/html/_static/underscore-1.3.1.js +0 -999
 
| 
         @@ -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. 
     | 
| 
      
 10 
     | 
    
         
            +
                <title>7.3.32. ruby_load — Groonga v5.0.1-42-g4d10df1 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. 
     | 
| 
      
 18 
     | 
    
         
            +
                    VERSION:     '5.0.1-42-g4d10df1',
         
     | 
| 
       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. 
     | 
| 
      
 28 
     | 
    
         
            +
                <link rel="top" title="Groonga v5.0.1-42-g4d10df1 documentation" href="../../index.html" />
         
     | 
| 
       29 
29 
     | 
    
         
             
                <link rel="up" title="7.3. Command" href="../command.html" />
         
     | 
| 
       30 
     | 
    
         
            -
                <link rel="next" title="7.3. 
     | 
| 
       31 
     | 
    
         
            -
                <link rel="prev" title="7.3. 
     | 
| 
      
 30 
     | 
    
         
            +
                <link rel="next" title="7.3.33. select" href="select.html" />
         
     | 
| 
      
 31 
     | 
    
         
            +
                <link rel="prev" title="7.3.31. ruby_eval" href="ruby_eval.html" /> 
         
     | 
| 
       32 
32 
     | 
    
         
             
              </head>
         
     | 
| 
       33 
     | 
    
         
            -
              <body 
     | 
| 
      
 33 
     | 
    
         
            +
              <body>
         
     | 
| 
       34 
34 
     | 
    
         
             
            <div class="header">
         
     | 
| 
       35 
35 
     | 
    
         
             
              <h1 class="title">
         
     | 
| 
       36 
36 
     | 
    
         
             
                <a id="top-link" href="../../index.html">
         
     | 
| 
         @@ -48,19 +48,19 @@ 
     | 
|
| 
       48 
48 
     | 
    
         
             
            </div>
         
     | 
| 
       49 
49 
     | 
    
         | 
| 
       50 
50 
     | 
    
         | 
| 
       51 
     | 
    
         
            -
                <div class="related" 
     | 
| 
      
 51 
     | 
    
         
            +
                <div class="related">
         
     | 
| 
       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. 
     | 
| 
      
 58 
     | 
    
         
            +
                      <a href="select.html" title="7.3.33. select"
         
     | 
| 
       59 
59 
     | 
    
         
             
                         accesskey="N">next</a> |</li>
         
     | 
| 
       60 
60 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       61 
     | 
    
         
            -
                      <a href="ruby_eval.html" title="7.3. 
     | 
| 
      
 61 
     | 
    
         
            +
                      <a href="ruby_eval.html" title="7.3.31. ruby_eval"
         
     | 
| 
       62 
62 
     | 
    
         
             
                         accesskey="P">previous</a> |</li>
         
     | 
| 
       63 
     | 
    
         
            -
                    <li><a href="../../index.html">Groonga v5.0. 
     | 
| 
      
 63 
     | 
    
         
            +
                    <li><a href="../../index.html">Groonga v5.0.1-42-g4d10df1 documentation</a> »</li>
         
     | 
| 
       64 
64 
     | 
    
         
             
                      <li><a href="../../reference.html" >7. Reference manual</a> »</li>
         
     | 
| 
       65 
65 
     | 
    
         
             
                      <li><a href="../command.html" accesskey="U">7.3. Command</a> »</li> 
         
     | 
| 
       66 
66 
     | 
    
         
             
                  </ul>
         
     | 
| 
         @@ -69,25 +69,25 @@ 
     | 
|
| 
       69 
69 
     | 
    
         
             
                <div class="document">
         
     | 
| 
       70 
70 
     | 
    
         
             
                  <div class="documentwrapper">
         
     | 
| 
       71 
71 
     | 
    
         
             
                    <div class="bodywrapper">
         
     | 
| 
       72 
     | 
    
         
            -
                      <div class="body" 
     | 
| 
      
 72 
     | 
    
         
            +
                      <div class="body">
         
     | 
| 
       73 
73 
     | 
    
         | 
| 
       74 
74 
     | 
    
         
             
              <div class="section" id="ruby-load">
         
     | 
| 
       75 
     | 
    
         
            -
            <h1>7.3. 
     | 
| 
      
 75 
     | 
    
         
            +
            <h1>7.3.32. <tt class="docutils literal"><span class="pre">ruby_load</span></tt><a class="headerlink" href="#ruby-load" title="Permalink to this headline">¶</a></h1>
         
     | 
| 
       76 
76 
     | 
    
         
             
            <div class="section" id="summary">
         
     | 
| 
       77 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
       78 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 77 
     | 
    
         
            +
            <h2>7.3.32.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>
         
     | 
| 
       79 
79 
     | 
    
         
             
            </div>
         
     | 
| 
       80 
80 
     | 
    
         
             
            <div class="section" id="syntax">
         
     | 
| 
       81 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
       82 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 81 
     | 
    
         
            +
            <h2>7.3.32.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>
         
     | 
| 
       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. 
     | 
| 
       89 
     | 
    
         
            -
            <p>You can load any script file which mruby supports by calling < 
     | 
| 
       90 
     | 
    
         
            -
            <p>Here is an example that just load < 
     | 
| 
      
 88 
     | 
    
         
            +
            <h2>7.3.32.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>
         
     | 
| 
       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 "expression.rb" 
     | 
|
| 
       95 
95 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], {"value": null}]
         
     | 
| 
       96 
96 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       97 
97 
     | 
    
         
             
            </div>
         
     | 
| 
       98 
     | 
    
         
            -
            <p>Register < 
     | 
| 
       99 
     | 
    
         
            -
            <p>Note that < 
     | 
| 
      
 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,
         
     | 
| 
       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. 
     | 
| 
      
 103 
     | 
    
         
            +
            <h2>7.3.32.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. 
     | 
| 
       107 
     | 
    
         
            -
            <p> 
     | 
| 
      
 106 
     | 
    
         
            +
            <h3>7.3.32.4.1. <tt class="docutils literal"><span class="pre">path</span></tt><a class="headerlink" href="#path" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
      
 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. 
     | 
| 
       112 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 111 
     | 
    
         
            +
            <h2>7.3.32.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
         
     | 
| 
       113 
113 
     | 
    
         
             
            exception information (Including metadata isn't implemented yet):</p>
         
     | 
| 
       114 
114 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>[HEADER, {"value": LOADED_VALUE}]
         
     | 
| 
       115 
115 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       116 
116 
     | 
    
         
             
            </div>
         
     | 
| 
       117 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 117 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">HEADER</span></tt></p>
         
     | 
| 
       118 
118 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       119 
     | 
    
         
            -
            <div>See <a class="reference internal" href="../command/output_format.html"><em>Output format</em></a> about < 
     | 
| 
       120 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 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>
         
     | 
| 
       121 
121 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       122 
     | 
    
         
            -
            <div><p>< 
     | 
| 
       123 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 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>
         
     | 
| 
       124 
124 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       125 
125 
     | 
    
         
             
            </div>
         
     | 
| 
       126 
126 
     | 
    
         
             
            <div class="section" id="see-also">
         
     | 
| 
       127 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
      
 127 
     | 
    
         
            +
            <h2>7.3.32.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,38 +133,36 @@ 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">
         
     | 
| 
       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. 
     | 
| 
       141 
     | 
    
         
            -
            <li><a class="reference internal" href="#summary">7.3. 
     | 
| 
       142 
     | 
    
         
            -
            <li><a class="reference internal" href="#syntax">7.3. 
     | 
| 
       143 
     | 
    
         
            -
            <li><a class="reference internal" href="#usage">7.3. 
     | 
| 
       144 
     | 
    
         
            -
            <li><a class="reference internal" href="#parameters">7.3. 
     | 
| 
       145 
     | 
    
         
            -
            <li><a class="reference internal" href="#path">7.3. 
     | 
| 
      
 140 
     | 
    
         
            +
            <li><a class="reference internal" href="#">7.3.32. <tt class="docutils literal"><span class="pre">ruby_load</span></tt></a><ul>
         
     | 
| 
      
 141 
     | 
    
         
            +
            <li><a class="reference internal" href="#summary">7.3.32.1. Summary</a></li>
         
     | 
| 
      
 142 
     | 
    
         
            +
            <li><a class="reference internal" href="#syntax">7.3.32.2. Syntax</a></li>
         
     | 
| 
      
 143 
     | 
    
         
            +
            <li><a class="reference internal" href="#usage">7.3.32.3. Usage</a></li>
         
     | 
| 
      
 144 
     | 
    
         
            +
            <li><a class="reference internal" href="#parameters">7.3.32.4. Parameters</a><ul>
         
     | 
| 
      
 145 
     | 
    
         
            +
            <li><a class="reference internal" href="#path">7.3.32.4.1. <tt class="docutils literal"><span class="pre">path</span></tt></a></li>
         
     | 
| 
       146 
146 
     | 
    
         
             
            </ul>
         
     | 
| 
       147 
147 
     | 
    
         
             
            </li>
         
     | 
| 
       148 
     | 
    
         
            -
            <li><a class="reference internal" href="#return-value">7.3. 
     | 
| 
       149 
     | 
    
         
            -
            <li><a class="reference internal" href="#see-also">7.3. 
     | 
| 
      
 148 
     | 
    
         
            +
            <li><a class="reference internal" href="#return-value">7.3.32.5. Return value</a></li>
         
     | 
| 
      
 149 
     | 
    
         
            +
            <li><a class="reference internal" href="#see-also">7.3.32.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. 
     | 
| 
      
 156 
     | 
    
         
            +
                                    title="previous chapter">7.3.31. <tt class="docutils literal"><span class="pre">ruby_eval</span></tt></a></p>
         
     | 
| 
       157 
157 
     | 
    
         
             
              <h4>Next topic</h4>
         
     | 
| 
       158 
158 
     | 
    
         
             
              <p class="topless"><a href="select.html"
         
     | 
| 
       159 
     | 
    
         
            -
                                    title="next chapter">7.3. 
     | 
| 
       160 
     | 
    
         
            -
              < 
     | 
| 
       161 
     | 
    
         
            -
             
     | 
| 
       162 
     | 
    
         
            -
                < 
     | 
| 
       163 
     | 
    
         
            -
             
     | 
| 
       164 
     | 
    
         
            -
             
     | 
| 
       165 
     | 
    
         
            -
             
     | 
| 
       166 
     | 
    
         
            -
               </div>
         
     | 
| 
       167 
     | 
    
         
            -
            <div id="searchbox" style="display: none" role="search">
         
     | 
| 
      
 159 
     | 
    
         
            +
                                    title="next chapter">7.3.33. <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">
         
     | 
| 
       168 
166 
     | 
    
         
             
              <h3>Quick search</h3>
         
     | 
| 
       169 
167 
     | 
    
         
             
                <form class="search" action="../../search.html" method="get">
         
     | 
| 
       170 
168 
     | 
    
         
             
                  <input type="text" name="q" />
         
     | 
| 
         @@ -181,24 +179,24 @@ exception information (Including metadata isn't implemented yet):</p> 
     | 
|
| 
       181 
179 
     | 
    
         
             
                  </div>
         
     | 
| 
       182 
180 
     | 
    
         
             
                  <div class="clearer"></div>
         
     | 
| 
       183 
181 
     | 
    
         
             
                </div>
         
     | 
| 
       184 
     | 
    
         
            -
                <div class="related" 
     | 
| 
      
 182 
     | 
    
         
            +
                <div class="related">
         
     | 
| 
       185 
183 
     | 
    
         
             
                  <h3>Navigation</h3>
         
     | 
| 
       186 
184 
     | 
    
         
             
                  <ul>
         
     | 
| 
       187 
185 
     | 
    
         
             
                    <li class="right" style="margin-right: 10px">
         
     | 
| 
       188 
186 
     | 
    
         
             
                      <a href="../../genindex.html" title="General Index"
         
     | 
| 
       189 
187 
     | 
    
         
             
                         >index</a></li>
         
     | 
| 
       190 
188 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       191 
     | 
    
         
            -
                      <a href="select.html" title="7.3. 
     | 
| 
      
 189 
     | 
    
         
            +
                      <a href="select.html" title="7.3.33. select"
         
     | 
| 
       192 
190 
     | 
    
         
             
                         >next</a> |</li>
         
     | 
| 
       193 
191 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       194 
     | 
    
         
            -
                      <a href="ruby_eval.html" title="7.3. 
     | 
| 
      
 192 
     | 
    
         
            +
                      <a href="ruby_eval.html" title="7.3.31. ruby_eval"
         
     | 
| 
       195 
193 
     | 
    
         
             
                         >previous</a> |</li>
         
     | 
| 
       196 
     | 
    
         
            -
                    <li><a href="../../index.html">Groonga v5.0. 
     | 
| 
      
 194 
     | 
    
         
            +
                    <li><a href="../../index.html">Groonga v5.0.1-42-g4d10df1 documentation</a> »</li>
         
     | 
| 
       197 
195 
     | 
    
         
             
                      <li><a href="../../reference.html" >7. Reference manual</a> »</li>
         
     | 
| 
       198 
196 
     | 
    
         
             
                      <li><a href="../command.html" >7.3. Command</a> »</li> 
         
     | 
| 
       199 
197 
     | 
    
         
             
                  </ul>
         
     | 
| 
       200 
198 
     | 
    
         
             
                </div>
         
     | 
| 
       201 
     | 
    
         
            -
                <div class="footer" 
     | 
| 
      
 199 
     | 
    
         
            +
                <div class="footer">
         
     | 
| 
       202 
200 
     | 
    
         
             
                    © Copyright 2009-2015, Brazil, Inc.
         
     | 
| 
       203 
201 
     | 
    
         
             
                </div>
         
     | 
| 
       204 
202 
     | 
    
         
             
              </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. 
     | 
| 
      
 10 
     | 
    
         
            +
                <title>7.3.33. select — Groonga v5.0.1-42-g4d10df1 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. 
     | 
| 
      
 18 
     | 
    
         
            +
                    VERSION:     '5.0.1-42-g4d10df1',
         
     | 
| 
       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. 
     | 
| 
      
 28 
     | 
    
         
            +
                <link rel="top" title="Groonga v5.0.1-42-g4d10df1 documentation" href="../../index.html" />
         
     | 
| 
       29 
29 
     | 
    
         
             
                <link rel="up" title="7.3. Command" href="../command.html" />
         
     | 
| 
       30 
     | 
    
         
            -
                <link rel="next" title="7.3. 
     | 
| 
       31 
     | 
    
         
            -
                <link rel="prev" title="7.3. 
     | 
| 
      
 30 
     | 
    
         
            +
                <link rel="next" title="7.3.34. shutdown" href="shutdown.html" />
         
     | 
| 
      
 31 
     | 
    
         
            +
                <link rel="prev" title="7.3.32. ruby_load" href="ruby_load.html" /> 
         
     | 
| 
       32 
32 
     | 
    
         
             
              </head>
         
     | 
| 
       33 
     | 
    
         
            -
              <body 
     | 
| 
      
 33 
     | 
    
         
            +
              <body>
         
     | 
| 
       34 
34 
     | 
    
         
             
            <div class="header">
         
     | 
| 
       35 
35 
     | 
    
         
             
              <h1 class="title">
         
     | 
| 
       36 
36 
     | 
    
         
             
                <a id="top-link" href="../../index.html">
         
     | 
| 
         @@ -48,19 +48,19 @@ 
     | 
|
| 
       48 
48 
     | 
    
         
             
            </div>
         
     | 
| 
       49 
49 
     | 
    
         | 
| 
       50 
50 
     | 
    
         | 
| 
       51 
     | 
    
         
            -
                <div class="related" 
     | 
| 
      
 51 
     | 
    
         
            +
                <div class="related">
         
     | 
| 
       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. 
     | 
| 
      
 58 
     | 
    
         
            +
                      <a href="shutdown.html" title="7.3.34. shutdown"
         
     | 
| 
       59 
59 
     | 
    
         
             
                         accesskey="N">next</a> |</li>
         
     | 
| 
       60 
60 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       61 
     | 
    
         
            -
                      <a href="ruby_load.html" title="7.3. 
     | 
| 
      
 61 
     | 
    
         
            +
                      <a href="ruby_load.html" title="7.3.32. ruby_load"
         
     | 
| 
       62 
62 
     | 
    
         
             
                         accesskey="P">previous</a> |</li>
         
     | 
| 
       63 
     | 
    
         
            -
                    <li><a href="../../index.html">Groonga v5.0. 
     | 
| 
      
 63 
     | 
    
         
            +
                    <li><a href="../../index.html">Groonga v5.0.1-42-g4d10df1 documentation</a> »</li>
         
     | 
| 
       64 
64 
     | 
    
         
             
                      <li><a href="../../reference.html" >7. Reference manual</a> »</li>
         
     | 
| 
       65 
65 
     | 
    
         
             
                      <li><a href="../command.html" accesskey="U">7.3. Command</a> »</li> 
         
     | 
| 
       66 
66 
     | 
    
         
             
                  </ul>
         
     | 
| 
         @@ -69,21 +69,21 @@ 
     | 
|
| 
       69 
69 
     | 
    
         
             
                <div class="document">
         
     | 
| 
       70 
70 
     | 
    
         
             
                  <div class="documentwrapper">
         
     | 
| 
       71 
71 
     | 
    
         
             
                    <div class="bodywrapper">
         
     | 
| 
       72 
     | 
    
         
            -
                      <div class="body" 
     | 
| 
      
 72 
     | 
    
         
            +
                      <div class="body">
         
     | 
| 
       73 
73 
     | 
    
         | 
| 
       74 
74 
     | 
    
         
             
              <div class="section" id="select">
         
     | 
| 
       75 
     | 
    
         
            -
            <h1>7.3. 
     | 
| 
      
 75 
     | 
    
         
            +
            <h1>7.3.33. <tt class="docutils literal"><span class="pre">select</span></tt><a class="headerlink" href="#select" title="Permalink to this headline">¶</a></h1>
         
     | 
| 
       76 
76 
     | 
    
         
             
            <div class="section" id="summary">
         
     | 
| 
       77 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
       78 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 77 
     | 
    
         
            +
            <h2>7.3.33.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
         
     | 
| 
       79 
79 
     | 
    
         
             
            from a table and then outputs them.</p>
         
     | 
| 
       80 
     | 
    
         
            -
            <p>< 
     | 
| 
       81 
     | 
    
         
            -
            understand < 
     | 
| 
      
 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>
         
     | 
| 
       82 
82 
     | 
    
         
             
            </div>
         
     | 
| 
       83 
83 
     | 
    
         
             
            <div class="section" id="syntax">
         
     | 
| 
       84 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
       85 
     | 
    
         
            -
            <p>< 
     | 
| 
       86 
     | 
    
         
            -
            < 
     | 
| 
      
 84 
     | 
    
         
            +
            <h2>7.3.33.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>
         
     | 
| 
       87 
87 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select table
         
     | 
| 
       88 
88 
     | 
    
         
             
                   [match_columns=null]
         
     | 
| 
       89 
89 
     | 
    
         
             
                   [query=null]
         
     | 
| 
         @@ -108,41 +108,41 @@ understand <code class="docutils literal"><span class="pre">select</span></code> 
     | 
|
| 
       108 
108 
     | 
    
         
             
                   [drilldown_calc_target=null]
         
     | 
| 
       109 
109 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       110 
110 
     | 
    
         
             
            </div>
         
     | 
| 
       111 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 111 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">select</span></tt> has the following named parameters for advanced drilldown:</p>
         
     | 
| 
       112 
112 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       113 
113 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       114 
     | 
    
         
            -
            <li>< 
     | 
| 
       115 
     | 
    
         
            -
            <li>< 
     | 
| 
       116 
     | 
    
         
            -
            <li>< 
     | 
| 
       117 
     | 
    
         
            -
            <li>< 
     | 
| 
       118 
     | 
    
         
            -
            <li>< 
     | 
| 
       119 
     | 
    
         
            -
            <li>< 
     | 
| 
       120 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 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="_key,</span> <span class="pre">_nsubrecs"</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>
         
     | 
| 
       121 
121 
     | 
    
         
             
            </ul>
         
     | 
| 
       122 
122 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       123 
     | 
    
         
            -
            <p>You can use one or more alphabets, digits, < 
     | 
| 
       124 
     | 
    
         
            -
            < 
     | 
| 
       125 
     | 
    
         
            -
            <p>Parameters that have the same < 
     | 
| 
      
 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>
         
     | 
| 
       126 
126 
     | 
    
         
             
            <p>For example, the following parameters specify one drilldown:</p>
         
     | 
| 
       127 
127 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       128 
128 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       129 
     | 
    
         
            -
            <li>< 
     | 
| 
       130 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 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>
         
     | 
| 
       131 
131 
     | 
    
         
             
            </ul>
         
     | 
| 
       132 
132 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       133 
133 
     | 
    
         
             
            <p>The following parameters specify two drilldowns:</p>
         
     | 
| 
       134 
134 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       135 
135 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       136 
     | 
    
         
            -
            <li>< 
     | 
| 
       137 
     | 
    
         
            -
            <li>< 
     | 
| 
       138 
     | 
    
         
            -
            <li>< 
     | 
| 
       139 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 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>
         
     | 
| 
       140 
140 
     | 
    
         
             
            </ul>
         
     | 
| 
       141 
141 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       142 
142 
     | 
    
         
             
            </div>
         
     | 
| 
       143 
143 
     | 
    
         
             
            <div class="section" id="usage">
         
     | 
| 
       144 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
       145 
     | 
    
         
            -
            <p>Let's learn about < 
     | 
| 
      
 144 
     | 
    
         
            +
            <h2>7.3.33.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
         
     | 
| 
       146 
146 
     | 
    
         
             
            many popular usages.</p>
         
     | 
| 
       147 
147 
     | 
    
         
             
            <p>Here are a schema definition and sample data to show usage.</p>
         
     | 
| 
       148 
148 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
         @@ -186,19 +186,19 @@ load --table Entries 
     | 
|
| 
       186 
186 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], 5]
         
     | 
| 
       187 
187 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       188 
188 
     | 
    
         
             
            </div>
         
     | 
| 
       189 
     | 
    
         
            -
            <p>There is a table, < 
     | 
| 
      
 189 
     | 
    
         
            +
            <p>There is a table, <tt class="docutils literal"><span class="pre">Entries</span></tt>, for blog entries. An entry has title,
         
     | 
| 
       190 
190 
     | 
    
         
             
            content, the number of likes for the entry and tag. Title is key of
         
     | 
| 
       191 
     | 
    
         
            -
            < 
     | 
| 
       192 
     | 
    
         
            -
            number of likes is value of < 
     | 
| 
       193 
     | 
    
         
            -
            of < 
     | 
| 
       194 
     | 
    
         
            -
            <p>< 
     | 
| 
       195 
     | 
    
         
            -
            using < 
     | 
| 
       196 
     | 
    
         
            -
            < 
     | 
| 
      
 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>
         
     | 
| 
       197 
197 
     | 
    
         
             
            <p>OK. The schema and data for examples are ready.</p>
         
     | 
| 
       198 
198 
     | 
    
         
             
            <div class="section" id="simple-usage">
         
     | 
| 
       199 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
      
 199 
     | 
    
         
            +
            <h3>7.3.33.3.1. Simple usage<a class="headerlink" href="#simple-usage" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       200 
200 
     | 
    
         
             
            <p>Here is the most simple usage with the above schema and data. It outputs
         
     | 
| 
       201 
     | 
    
         
            -
            all records in < 
     | 
| 
      
 201 
     | 
    
         
            +
            all records in <tt class="docutils literal"><span class="pre">Entries</span></tt> table.</p>
         
     | 
| 
       202 
202 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       203 
203 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries
         
     | 
| 
       204 
204 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -277,29 +277,29 @@ all records in <code class="docutils literal"><span class="pre">Entries</span></ 
     | 
|
| 
       277 
277 
     | 
    
         
             
            <p>Why does the command output all records? There are two reasons. The
         
     | 
| 
       278 
278 
     | 
    
         
             
            first reason is that the command doesn't specify any search
         
     | 
| 
       279 
279 
     | 
    
         
             
            conditions. No search condition means all records are matched. The
         
     | 
| 
       280 
     | 
    
         
            -
            second reason is that the number of all records is 5. < 
     | 
| 
      
 280 
     | 
    
         
            +
            second reason is that the number of all records is 5. <tt class="docutils literal"><span class="pre">select</span></tt>
         
     | 
| 
       281 
281 
     | 
    
         
             
            command outputs 10 records at a maximum by default. There are only 5
         
     | 
| 
       282 
282 
     | 
    
         
             
            records. It is less than 10. So the command outputs all records.</p>
         
     | 
| 
       283 
283 
     | 
    
         
             
            </div>
         
     | 
| 
       284 
284 
     | 
    
         
             
            <div class="section" id="search-conditions">
         
     | 
| 
       285 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
       286 
     | 
    
         
            -
            <p>Search conditions are specified by < 
     | 
| 
       287 
     | 
    
         
            -
            also specify both < 
     | 
| 
       288 
     | 
    
         
            -
            records must be matched against both < 
     | 
| 
      
 285 
     | 
    
         
            +
            <h3>7.3.33.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>
         
     | 
| 
       289 
289 
     | 
    
         
             
            <div class="section" id="search-condition-query">
         
     | 
| 
       290 
     | 
    
         
            -
            <h4>7.3. 
     | 
| 
       291 
     | 
    
         
            -
            <p>< 
     | 
| 
       292 
     | 
    
         
            -
            in google.com. You specify search conditions for < 
     | 
| 
       293 
     | 
    
         
            -
            separated keywords. For example, < 
     | 
| 
       294 
     | 
    
         
            -
            record should contain two words, < 
     | 
| 
       295 
     | 
    
         
            -
            <p>Normally, < 
     | 
| 
      
 290 
     | 
    
         
            +
            <h4>7.3.33.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
         
     | 
| 
       296 
296 
     | 
    
         
             
            conditions. It can be used for non fulltext search conditions but
         
     | 
| 
       297 
     | 
    
         
            -
            < 
     | 
| 
       298 
     | 
    
         
            -
            <p>< 
     | 
| 
       299 
     | 
    
         
            -
            < 
     | 
| 
       300 
     | 
    
         
            -
            conditions. < 
     | 
| 
       301 
     | 
    
         
            -
            matched against < 
     | 
| 
       302 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 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>
         
     | 
| 
       303 
303 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       304 
304 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query fast
         
     | 
| 
       305 
305 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -354,16 +354,16 @@ matched against <code class="docutils literal"><span class="pre">query</span></c 
     | 
|
| 
       354 
354 
     | 
    
         
             
            # ]
         
     | 
| 
       355 
355 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       356 
356 
     | 
    
         
             
            </div>
         
     | 
| 
       357 
     | 
    
         
            -
            <p>The < 
     | 
| 
       358 
     | 
    
         
            -
            in < 
     | 
| 
       359 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 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
         
     | 
| 
       360 
360 
     | 
    
         
             
            <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a> for datails.</p>
         
     | 
| 
       361 
361 
     | 
    
         
             
            </div>
         
     | 
| 
       362 
362 
     | 
    
         
             
            <div class="section" id="search-condition-filter">
         
     | 
| 
       363 
     | 
    
         
            -
            <h4>7.3. 
     | 
| 
       364 
     | 
    
         
            -
            <p>< 
     | 
| 
       365 
     | 
    
         
            -
            search conditions for < 
     | 
| 
       366 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 363 
     | 
    
         
            +
            <h4>7.3.33.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>
         
     | 
| 
       367 
367 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       368 
368 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --filter 'content @ "fast" && _key == "Groonga"'
         
     | 
| 
       369 
369 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -411,20 +411,20 @@ search conditions for <code class="docutils literal"><span class="pre">filter</s 
     | 
|
| 
       411 
411 
     | 
    
         
             
            # ]
         
     | 
| 
       412 
412 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       413 
413 
     | 
    
         
             
            </div>
         
     | 
| 
       414 
     | 
    
         
            -
            <p>The < 
     | 
| 
       415 
     | 
    
         
            -
            in < 
     | 
| 
       416 
     | 
    
         
            -
            < 
     | 
| 
       417 
     | 
    
         
            -
            < 
     | 
| 
       418 
     | 
    
         
            -
            < 
     | 
| 
       419 
     | 
    
         
            -
            < 
     | 
| 
       420 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 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">@</span></tt>,
         
     | 
| 
      
 417 
     | 
    
         
            +
            <tt class="docutils literal"><span class="pre">&&</span></tt> and <tt class="docutils literal"><span class="pre">==</span></tt>. <tt class="docutils literal"><span class="pre">@</span></tt> is fulltext search operator. <tt class="docutils literal"><span class="pre">&&</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">&&</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>
         
     | 
| 
       421 
421 
     | 
    
         
             
            its details aren't described here. See
         
     | 
| 
       422 
422 
     | 
    
         
             
            <a class="reference internal" href="../grn_expr/script_syntax.html"><em>Script syntax</em></a> for datails.</p>
         
     | 
| 
       423 
423 
     | 
    
         
             
            </div>
         
     | 
| 
       424 
424 
     | 
    
         
             
            </div>
         
     | 
| 
       425 
425 
     | 
    
         
             
            <div class="section" id="paging">
         
     | 
| 
       426 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
       427 
     | 
    
         
            -
            <p>You can specify range of outputted records by < 
     | 
| 
      
 426 
     | 
    
         
            +
            <h3>7.3.33.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>.
         
     | 
| 
       428 
428 
     | 
    
         
             
            Here is an example to output only the 2nd record.</p>
         
     | 
| 
       429 
429 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       430 
430 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --offset 1 --limit 1
         
     | 
| 
         @@ -473,15 +473,15 @@ Here is an example to output only the 2nd record.</p> 
     | 
|
| 
       473 
473 
     | 
    
         
             
            # ]
         
     | 
| 
       474 
474 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       475 
475 
     | 
    
         
             
            </div>
         
     | 
| 
       476 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 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 
477 
     | 
    
         
             
            started from the 2nd record.</p>
         
     | 
| 
       478 
     | 
    
         
            -
            <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 
479 
     | 
    
         
             
            means the number of output records is 1 at a maximium. If no records
         
     | 
| 
       480 
     | 
    
         
            -
            are matched, < 
     | 
| 
      
 480 
     | 
    
         
            +
            are matched, <tt class="docutils literal"><span class="pre">select</span></tt> command outputs no records.</p>
         
     | 
| 
       481 
481 
     | 
    
         
             
            </div>
         
     | 
| 
       482 
482 
     | 
    
         
             
            <div class="section" id="the-total-number-of-records">
         
     | 
| 
       483 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
       484 
     | 
    
         
            -
            <p>You can use < 
     | 
| 
      
 483 
     | 
    
         
            +
            <h3>7.3.33.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
         
     | 
| 
       485 
485 
     | 
    
         
             
            without any contents of records.</p>
         
     | 
| 
       486 
486 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       487 
487 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --limit 0
         
     | 
| 
         @@ -523,19 +523,19 @@ without any contents of records.</p> 
     | 
|
| 
       523 
523 
     | 
    
         
             
            # ]
         
     | 
| 
       524 
524 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       525 
525 
     | 
    
         
             
            </div>
         
     | 
| 
       526 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 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 
527 
     | 
    
         
             
            records.</p>
         
     | 
| 
       528 
528 
     | 
    
         
             
            </div>
         
     | 
| 
       529 
529 
     | 
    
         
             
            <div class="section" id="drilldown">
         
     | 
| 
       530 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
      
 530 
     | 
    
         
            +
            <h3>7.3.33.3.5. Drilldown<a class="headerlink" href="#drilldown" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       531 
531 
     | 
    
         
             
            <p>You can get additional grouped results against the search result in
         
     | 
| 
       532 
     | 
    
         
            -
            one < 
     | 
| 
       533 
     | 
    
         
            -
            <span class="pre">``select</span></ 
     | 
| 
      
 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>
         
     | 
| 
       534 
534 
     | 
    
         
             
            <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 
535 
     | 
    
         
             
            called as <a class="reference external" href="http://en.wikipedia.org/wiki/Faceted_search">faceted search</a> in other search
         
     | 
| 
       536 
536 
     | 
    
         
             
            engine.</p>
         
     | 
| 
       537 
537 
     | 
    
         
             
            <p>For example, think about the following situation.</p>
         
     | 
| 
       538 
     | 
    
         
            -
            <p>You search entries that has < 
     | 
| 
      
 538 
     | 
    
         
            +
            <p>You search entries that has <tt class="docutils literal"><span class="pre">fast</span></tt> word:</p>
         
     | 
| 
       539 
539 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       540 
540 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --filter 'content @ "fast"'
         
     | 
| 
       541 
541 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -590,9 +590,9 @@ engine.</p> 
     | 
|
| 
       590 
590 
     | 
    
         
             
            # ]
         
     | 
| 
       591 
591 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       592 
592 
     | 
    
         
             
            </div>
         
     | 
| 
       593 
     | 
    
         
            -
            <p>You want to use < 
     | 
| 
       594 
     | 
    
         
            -
            < 
     | 
| 
       595 
     | 
    
         
            -
            suitable tag until you see the result of < 
     | 
| 
      
 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">@</span> <span class="pre">"fast"</span> <span class="pre">&&</span> <span class="pre">tag</span> <span class="pre">==</span> <span class="pre">"???"</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">@</span> <span class="pre">"fast"</span></tt>.</p>
         
     | 
| 
       596 
596 
     | 
    
         
             
            <p>If you know the number of matched records of each available tag, you
         
     | 
| 
       597 
597 
     | 
    
         
             
            can choose suitable tag. You can use drilldown for the case:</p>
         
     | 
| 
       598 
598 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
         @@ -668,7 +668,7 @@ can choose suitable tag. You can use drilldown for the case:</p> 
     | 
|
| 
       668 
668 
     | 
    
         
             
            # ]
         
     | 
| 
       669 
669 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       670 
670 
     | 
    
         
             
            </div>
         
     | 
| 
       671 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 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 
672 
     | 
    
         
             
            number of matched records. You can avoid "no hit search" case by
         
     | 
| 
       673 
673 
     | 
    
         
             
            choosing a tag from the list. You can also avoid "too many search
         
     | 
| 
       674 
674 
     | 
    
         
             
            results" case by choosing a tag that the number of matched records is
         
     | 
| 
         @@ -688,14 +688,14 @@ in grouped records and so on. See 
     | 
|
| 
       688 
688 
     | 
    
         
             
            </div>
         
     | 
| 
       689 
689 
     | 
    
         
             
            </div>
         
     | 
| 
       690 
690 
     | 
    
         
             
            <div class="section" id="parameters">
         
     | 
| 
       691 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
      
 691 
     | 
    
         
            +
            <h2>7.3.33.4. Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
       692 
692 
     | 
    
         
             
            <p>This section describes all parameters. Parameters are categorized.</p>
         
     | 
| 
       693 
693 
     | 
    
         
             
            <div class="section" id="required-parameter">
         
     | 
| 
       694 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
       695 
     | 
    
         
            -
            <p>There is a required parameter, < 
     | 
| 
      
 694 
     | 
    
         
            +
            <h3>7.3.33.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>
         
     | 
| 
       696 
696 
     | 
    
         
             
            <div class="section" id="table">
         
     | 
| 
       697 
     | 
    
         
            -
            <span id="select-table"></span><h4>7.3. 
     | 
| 
       698 
     | 
    
         
            -
            <p> 
     | 
| 
      
 697 
     | 
    
         
            +
            <span id="select-table"></span><h4>7.3.33.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>
         
     | 
| 
       699 
699 
     | 
    
         
             
            <p>If nonexistent table is specified, an error is returned.</p>
         
     | 
| 
       700 
700 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       701 
701 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Nonexistent
         
     | 
| 
         @@ -719,25 +719,25 @@ in grouped records and so on. See 
     | 
|
| 
       719 
719 
     | 
    
         
             
            </div>
         
     | 
| 
       720 
720 
     | 
    
         
             
            </div>
         
     | 
| 
       721 
721 
     | 
    
         
             
            <div class="section" id="search-related-parameters">
         
     | 
| 
       722 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
       723 
     | 
    
         
            -
            <p>There are search related parameters. Typically, < 
     | 
| 
       724 
     | 
    
         
            -
            < 
     | 
| 
       725 
     | 
    
         
            -
            box. < 
     | 
| 
      
 722 
     | 
    
         
            +
            <h3>7.3.33.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
         
     | 
| 
       726 
726 
     | 
    
         
             
            feature.</p>
         
     | 
| 
       727 
     | 
    
         
            -
            <p>If both < 
     | 
| 
       728 
     | 
    
         
            -
            be matched against both < 
     | 
| 
       729 
     | 
    
         
            -
            and < 
     | 
| 
      
 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>
         
     | 
| 
       730 
730 
     | 
    
         
             
            <div class="section" id="match-columns">
         
     | 
| 
       731 
     | 
    
         
            -
            <span id="select-match-columns"></span><h4>7.3. 
     | 
| 
       732 
     | 
    
         
            -
            <p> 
     | 
| 
       733 
     | 
    
         
            -
            < 
     | 
| 
       734 
     | 
    
         
            -
            specified in < 
     | 
| 
       735 
     | 
    
         
            -
            < 
     | 
| 
       736 
     | 
    
         
            -
            not. < 
     | 
| 
      
 731 
     | 
    
         
            +
            <span id="select-match-columns"></span><h4>7.3.33.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 
     | 
    
         
            +
            <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>
         
     | 
| 
       737 
737 
     | 
    
         
             
            <p>Weight is relative importance of target column. A higher weight target
         
     | 
| 
       738 
738 
     | 
    
         
             
            column gets more hit score rather than a lower weight target column
         
     | 
| 
       739 
739 
     | 
    
         
             
            when a record is matched by fulltext search. The default weight is 1.</p>
         
     | 
| 
       740 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 740 
     | 
    
         
            +
            <p>Here is a simple <tt class="docutils literal"><span class="pre">match_columns</span></tt> usage example.</p>
         
     | 
| 
       741 
741 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       742 
742 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query fast --output_columns '_key, _score'
         
     | 
| 
       743 
743 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -774,18 +774,18 @@ when a record is matched by fulltext search. The default weight is 1.</p> 
     | 
|
| 
       774 
774 
     | 
    
         
             
            # ]
         
     | 
| 
       775 
775 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       776 
776 
     | 
    
         
             
            </div>
         
     | 
| 
       777 
     | 
    
         
            -
            <p>< 
     | 
| 
       778 
     | 
    
         
            -
            fulltext search is < 
     | 
| 
       779 
     | 
    
         
            -
            is 1. < 
     | 
| 
       780 
     | 
    
         
            -
            command outputs < 
     | 
| 
      
 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
         
     | 
| 
       781 
781 
     | 
    
         
             
            records.</p>
         
     | 
| 
       782 
     | 
    
         
            -
            <p>Pay attention to < 
     | 
| 
       783 
     | 
    
         
            -
            matched counts against < 
     | 
| 
       784 
     | 
    
         
            -
            < 
     | 
| 
       785 
     | 
    
         
            -
            is 1 means that < 
     | 
| 
       786 
     | 
    
         
            -
            fact that < 
     | 
| 
       787 
     | 
    
         
            -
            < 
     | 
| 
       788 
     | 
    
         
            -
            <p>To specify weight, < 
     | 
| 
      
 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
         
     | 
| 
       789 
789 
     | 
    
         
             
            weight usage example.</p>
         
     | 
| 
       790 
790 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       791 
791 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns 'content * 2' --query fast --output_columns '_key, _score'
         
     | 
| 
         @@ -823,17 +823,17 @@ weight usage example.</p> 
     | 
|
| 
       823 
823 
     | 
    
         
             
            # ]
         
     | 
| 
       824 
824 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       825 
825 
     | 
    
         
             
            </div>
         
     | 
| 
       826 
     | 
    
         
            -
            <p>< 
     | 
| 
       827 
     | 
    
         
            -
            fulltext search is < 
     | 
| 
       828 
     | 
    
         
            -
            <p>Pay attention to < 
     | 
| 
      
 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
         
     | 
| 
       829 
829 
     | 
    
         
             
            weight is 2.</p>
         
     | 
| 
       830 
830 
     | 
    
         
             
            <p>You can specify one or more columns as the default target columns for
         
     | 
| 
       831 
831 
     | 
    
         
             
            fulltext search. If one or more columns are specified, fulltext search
         
     | 
| 
       832 
832 
     | 
    
         
             
            is done for all columns and scores are accumulated. If one of the
         
     | 
| 
       833 
     | 
    
         
            -
            columns is matched against < 
     | 
| 
      
 833 
     | 
    
         
            +
            columns is matched against <tt class="docutils literal"><span class="pre">query</span></tt> parameter value, the record is
         
     | 
| 
       834 
834 
     | 
    
         
             
            treated as matched.</p>
         
     | 
| 
       835 
     | 
    
         
            -
            <p>To specify one or more columns, < 
     | 
| 
       836 
     | 
    
         
            -
            <span class="pre">weight2</span> <span class="pre">||</span> <span class="pre">...</span></ 
     | 
| 
      
 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
         
     | 
| 
       837 
837 
     | 
    
         
             
            omitted, 1 is used for weight. Here is a one or more columns usage
         
     | 
| 
       838 
838 
     | 
    
         
             
            example.</p>
         
     | 
| 
       839 
839 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
         @@ -868,23 +868,23 @@ example.</p> 
     | 
|
| 
       868 
868 
     | 
    
         
             
            # ]
         
     | 
| 
       869 
869 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       870 
870 
     | 
    
         
             
            </div>
         
     | 
| 
       871 
     | 
    
         
            -
            <p>< 
     | 
| 
       872 
     | 
    
         
            -
            columns for fulltext search are < 
     | 
| 
       873 
     | 
    
         
            -
            < 
     | 
| 
       874 
     | 
    
         
            -
            is 1. This weight allocation means < 
     | 
| 
       875 
     | 
    
         
            -
            important rather than < 
     | 
| 
      
 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
         
     | 
| 
       876 
876 
     | 
    
         
             
            of blog entry is more important rather thatn content of blog entry.</p>
         
     | 
| 
       877 
877 
     | 
    
         
             
            </div>
         
     | 
| 
       878 
878 
     | 
    
         
             
            <div class="section" id="query">
         
     | 
| 
       879 
     | 
    
         
            -
            <span id="select-query"></span><h4>7.3. 
     | 
| 
       880 
     | 
    
         
            -
            <p> 
     | 
| 
       881 
     | 
    
         
            -
            with < 
     | 
| 
      
 879 
     | 
    
         
            +
            <span id="select-query"></span><h4>7.3.33.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 
     | 
    
         
            +
            <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 
882 
     | 
    
         
             
            a fulltext search form in a Web page. A query text should be formatted
         
     | 
| 
       883 
883 
     | 
    
         
             
            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, < 
     | 
| 
       885 
     | 
    
         
            -
            that groonga searches records that contain both < 
     | 
| 
       886 
     | 
    
         
            -
            < 
     | 
| 
       887 
     | 
    
         
            -
            contain either < 
     | 
| 
      
 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>
         
     | 
| 
       888 
888 
     | 
    
         
             
            <p>Here is a simple logical and search example.</p>
         
     | 
| 
       889 
889 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       890 
890 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query "fast groonga"
         
     | 
| 
         @@ -933,8 +933,8 @@ contain either <code class="docutils literal"><span class="pre">word1</span></co 
     | 
|
| 
       933 
933 
     | 
    
         
             
            # ]
         
     | 
| 
       934 
934 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       935 
935 
     | 
    
         
             
            </div>
         
     | 
| 
       936 
     | 
    
         
            -
            <p>The < 
     | 
| 
       937 
     | 
    
         
            -
            < 
     | 
| 
      
 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>
         
     | 
| 
       938 
938 
     | 
    
         
             
            table.</p>
         
     | 
| 
       939 
939 
     | 
    
         
             
            <p>Here is a simple logical or search example.</p>
         
     | 
| 
       940 
940 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
         @@ -991,14 +991,14 @@ table.</p> 
     | 
|
| 
       991 
991 
     | 
    
         
             
            # ]
         
     | 
| 
       992 
992 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       993 
993 
     | 
    
         
             
            </div>
         
     | 
| 
       994 
     | 
    
         
            -
            <p>The < 
     | 
| 
       995 
     | 
    
         
            -
            < 
     | 
| 
       996 
     | 
    
         
            -
            < 
     | 
| 
      
 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>
         
     | 
| 
       997 
997 
     | 
    
         
             
            <p>See <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a> for other syntax.</p>
         
     | 
| 
       998 
998 
     | 
    
         
             
            <p>It can be used for not only fulltext search but also other
         
     | 
| 
       999 
     | 
    
         
            -
            conditions. For example, < 
     | 
| 
       1000 
     | 
    
         
            -
            < 
     | 
| 
       1001 
     | 
    
         
            -
            value of < 
     | 
| 
      
 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:<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>
         
     | 
| 
       1002 
1002 
     | 
    
         
             
            <p>Here is a simple equality operator search example.</p>
         
     | 
| 
       1003 
1003 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1004 
1004 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --query _key:Groonga
         
     | 
| 
         @@ -1047,8 +1047,8 @@ value of <code class="docutils literal"><span class="pre">column</span></code> c 
     | 
|
| 
       1047 
1047 
     | 
    
         
             
            # ]
         
     | 
| 
       1048 
1048 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1049 
1049 
     | 
    
         
             
            </div>
         
     | 
| 
       1050 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1051 
     | 
    
         
            -
            < 
     | 
| 
      
 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>
         
     | 
| 
       1052 
1052 
     | 
    
         
             
            <p>Here is a simple less than operator search example.</p>
         
     | 
| 
       1053 
1053 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1054 
1054 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --query n_likes:<11
         
     | 
| 
         @@ -1118,23 +1118,23 @@ value of <code class="docutils literal"><span class="pre">column</span></code> c 
     | 
|
| 
       1118 
1118 
     | 
    
         
             
            # ]
         
     | 
| 
       1119 
1119 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1120 
1120 
     | 
    
         
             
            </div>
         
     | 
| 
       1121 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1122 
     | 
    
         
            -
            is less than < 
     | 
| 
      
 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>
         
     | 
| 
       1123 
1123 
     | 
    
         
             
            <p>See <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a> for other operations.</p>
         
     | 
| 
       1124 
1124 
     | 
    
         
             
            </div>
         
     | 
| 
       1125 
1125 
     | 
    
         
             
            <div class="section" id="filter">
         
     | 
| 
       1126 
     | 
    
         
            -
            <span id="select-filter"></span><h4>7.3. 
     | 
| 
       1127 
     | 
    
         
            -
            <p> 
     | 
| 
       1128 
     | 
    
         
            -
            conditions. < 
     | 
| 
       1129 
     | 
    
         
            -
            < 
     | 
| 
      
 1126 
     | 
    
         
            +
            <span id="select-filter"></span><h4>7.3.33.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 
     | 
    
         
            +
            <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
         
     | 
| 
       1130 
1130 
     | 
    
         
             
            logical and. It means that matched records should be matched against
         
     | 
| 
       1131 
     | 
    
         
            -
            both < 
     | 
| 
       1132 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 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
         
     | 
| 
       1133 
1133 
     | 
    
         
             
            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, < 
     | 
| 
       1135 
     | 
    
         
            -
            the value of < 
     | 
| 
       1136 
     | 
    
         
            -
            <span class="pre">value</span></ 
     | 
| 
       1137 
     | 
    
         
            -
            < 
     | 
| 
      
 1134 
     | 
    
         
            +
            similar to ECMAScript. For example, <tt class="docutils literal"><span class="pre">column</span> <span class="pre">==</span> <span class="pre">"value"</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">"value"</span></tt>. <tt class="docutils literal"><span class="pre">column</span> <span class="pre"><</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>
         
     | 
| 
       1138 
1138 
     | 
    
         
             
            <p>Here is a simple equality operator search example.</p>
         
     | 
| 
       1139 
1139 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1140 
1140 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --filter '_key == "Groonga"'
         
     | 
| 
         @@ -1183,8 +1183,8 @@ the value of <code class="docutils literal"><span class="pre">column</span></cod 
     | 
|
| 
       1183 
1183 
     | 
    
         
             
            # ]
         
     | 
| 
       1184 
1184 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1185 
1185 
     | 
    
         
             
            </div>
         
     | 
| 
       1186 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1187 
     | 
    
         
            -
            < 
     | 
| 
      
 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>
         
     | 
| 
       1188 
1188 
     | 
    
         
             
            <p>Here is a simple less than operator search example.</p>
         
     | 
| 
       1189 
1189 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1190 
1190 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --filter 'n_likes < 11'
         
     | 
| 
         @@ -1254,16 +1254,16 @@ the value of <code class="docutils literal"><span class="pre">column</span></cod 
     | 
|
| 
       1254 
1254 
     | 
    
         
             
            # ]
         
     | 
| 
       1255 
1255 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1256 
1256 
     | 
    
         
             
            </div>
         
     | 
| 
       1257 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1258 
     | 
    
         
            -
            is less than < 
     | 
| 
      
 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>
         
     | 
| 
       1259 
1259 
     | 
    
         
             
            <p>See <a class="reference internal" href="../grn_expr/script_syntax.html"><em>Script syntax</em></a> for other operators.</p>
         
     | 
| 
       1260 
1260 
     | 
    
         
             
            </div>
         
     | 
| 
       1261 
1261 
     | 
    
         
             
            </div>
         
     | 
| 
       1262 
1262 
     | 
    
         
             
            <div class="section" id="advanced-search-parameters">
         
     | 
| 
       1263 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
      
 1263 
     | 
    
         
            +
            <h3>7.3.33.4.3. Advanced search parameters<a class="headerlink" href="#advanced-search-parameters" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       1264 
1264 
     | 
    
         
             
            <div class="section" id="match-escalation-threshold">
         
     | 
| 
       1265 
     | 
    
         
            -
            <span id="id2"></span><h4>7.3. 
     | 
| 
       1266 
     | 
    
         
            -
            <p> 
     | 
| 
      
 1265 
     | 
    
         
            +
            <span id="id2"></span><h4>7.3.33.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 
     | 
    
         
            +
            <p>Specifies threshold to determine whether search storategy
         
     | 
| 
       1267 
1267 
     | 
    
         
             
            escalation is used or not. The threshold is compared against the
         
     | 
| 
       1268 
1268 
     | 
    
         
             
            number of matched records. If the number of matched records is equal
         
     | 
| 
       1269 
1269 
     | 
    
         
             
            to or less than the threshold, the search storategy escalation is
         
     | 
| 
         @@ -1273,15 +1273,15 @@ is used only when no records are matched.</p> 
     | 
|
| 
       1273 
1273 
     | 
    
         
             
            <p>The default threshold can be customized by one of the followings.</p>
         
     | 
| 
       1274 
1274 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       1275 
1275 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       1276 
     | 
    
         
            -
            <li>< 
     | 
| 
       1277 
     | 
    
         
            -
            <li>< 
     | 
| 
       1278 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 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
         
     | 
| 
       1279 
1279 
     | 
    
         
             
            file</li>
         
     | 
| 
       1280 
1280 
     | 
    
         
             
            </ul>
         
     | 
| 
       1281 
1281 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       1282 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
       1283 
     | 
    
         
            -
            first < 
     | 
| 
       1284 
     | 
    
         
            -
            parameter. The second < 
     | 
| 
      
 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>
         
     | 
| 
       1285 
1285 
     | 
    
         
             
            parameter.</p>
         
     | 
| 
       1286 
1286 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1287 
1287 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query groo
         
     | 
| 
         @@ -1367,60 +1367,60 @@ select Entries --match_columns content --query groo --match_escalation_threshold 
     | 
|
| 
       1367 
1367 
     | 
    
         
             
            # ]
         
     | 
| 
       1368 
1368 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1369 
1369 
     | 
    
         
             
            </div>
         
     | 
| 
       1370 
     | 
    
         
            -
            <p>The first < 
     | 
| 
       1371 
     | 
    
         
            -
            < 
     | 
| 
       1372 
     | 
    
         
            -
            records are matched because the < 
     | 
| 
       1373 
     | 
    
         
            -
            < 
     | 
| 
       1374 
     | 
    
         
            -
            < 
     | 
| 
       1375 
     | 
    
         
            -
            < 
     | 
| 
       1376 
     | 
    
         
            -
            It means that < 
     | 
| 
       1377 
     | 
    
         
            -
            records are matched against < 
     | 
| 
      
 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
         
     | 
| 
       1378 
1378 
     | 
    
         
             
            search storategy escalation is used because the number of matched
         
     | 
| 
       1379 
     | 
    
         
            -
            records (0) is equal to < 
     | 
| 
       1380 
     | 
    
         
            -
            is matched against < 
     | 
| 
       1381 
     | 
    
         
            -
            <p>The second < 
     | 
| 
       1382 
     | 
    
         
            -
            word < 
     | 
| 
      
 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
         
     | 
| 
       1383 
1383 
     | 
    
         
             
            it also doesn't found matched records. In this case, the search
         
     | 
| 
       1384 
1384 
     | 
    
         
             
            storategy escalation is not used because the number of matched
         
     | 
| 
       1385 
     | 
    
         
            -
            records (0) is larger than < 
     | 
| 
      
 1385 
     | 
    
         
            +
            records (0) is larger than <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt> (-1). So no
         
     | 
| 
       1386 
1386 
     | 
    
         
             
            more searches aren't executed. And no records are matched.</p>
         
     | 
| 
       1387 
1387 
     | 
    
         
             
            </div>
         
     | 
| 
       1388 
1388 
     | 
    
         
             
            <div class="section" id="query-expansion">
         
     | 
| 
       1389 
     | 
    
         
            -
            <span id="id3"></span><h4>7.3. 
     | 
| 
      
 1389 
     | 
    
         
            +
            <span id="id3"></span><h4>7.3.33.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 
1390 
     | 
    
         
             
            <p>Deprecated. Use <a class="reference internal" href="#query-expander"><em>query_expander</em></a> instead.</p>
         
     | 
| 
       1391 
1391 
     | 
    
         
             
            </div>
         
     | 
| 
       1392 
1392 
     | 
    
         
             
            <div class="section" id="query-flags">
         
     | 
| 
       1393 
     | 
    
         
            -
            <span id="id4"></span><h4>7.3. 
     | 
| 
       1394 
     | 
    
         
            -
            <p>It customs < 
     | 
| 
       1395 
     | 
    
         
            -
            by < 
     | 
| 
       1396 
     | 
    
         
            -
            < 
     | 
| 
       1397 
     | 
    
         
            -
            column value by < 
     | 
| 
      
 1393 
     | 
    
         
            +
            <span id="id4"></span><h4>7.3.33.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>
         
     | 
| 
       1398 
1398 
     | 
    
         
             
            <p>Here are available values:</p>
         
     | 
| 
       1399 
1399 
     | 
    
         
             
            <ul class="simple">
         
     | 
| 
       1400 
     | 
    
         
            -
            <li>< 
     | 
| 
       1401 
     | 
    
         
            -
            <li>< 
     | 
| 
       1402 
     | 
    
         
            -
            <li>< 
     | 
| 
       1403 
     | 
    
         
            -
            <li>< 
     | 
| 
       1404 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 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>
         
     | 
| 
       1405 
1405 
     | 
    
         
             
            </ul>
         
     | 
| 
       1406 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 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 
1407 
     | 
    
         
             
            implemented yet.</p>
         
     | 
| 
       1408 
     | 
    
         
            -
            <p>< 
     | 
| 
       1409 
     | 
    
         
            -
            in < 
     | 
| 
      
 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>
         
     | 
| 
       1410 
1410 
     | 
    
         
             
            syntaxes.</p>
         
     | 
| 
       1411 
     | 
    
         
            -
            <p>< 
     | 
| 
       1412 
     | 
    
         
            -
            < 
     | 
| 
      
 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
         
     | 
| 
       1413 
1413 
     | 
    
         
             
            update column because the column update syntax specifies column.</p>
         
     | 
| 
       1414 
     | 
    
         
            -
            <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 
1415 
     | 
    
         
             
            syntax. The query searches records that doesn't match
         
     | 
| 
       1416 
     | 
    
         
            -
            < 
     | 
| 
      
 1416 
     | 
    
         
            +
            <tt class="docutils literal"><span class="pre">WORD</span></tt>. Leading NOT condition query is heavy query in many cases
         
     | 
| 
       1417 
1417 
     | 
    
         
             
            because it matches many records. So this flag is disabled by
         
     | 
| 
       1418 
1418 
     | 
    
         
             
            default. Be careful about it when you use the flag.</p>
         
     | 
| 
       1419 
     | 
    
         
            -
            <p>< 
     | 
| 
       1420 
     | 
    
         
            -
            <p>They can be combined by separated < 
     | 
| 
       1421 
     | 
    
         
            -
            < 
     | 
| 
       1422 
     | 
    
         
            -
            <p>The default value is < 
     | 
| 
       1423 
     | 
    
         
            -
            <p>Here is a usage example of < 
     | 
| 
      
 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>
         
     | 
| 
       1424 
1424 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1425 
1425 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --query content:@mroonga --query_flags ALLOW_COLUMN
         
     | 
| 
       1426 
1426 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -1468,9 +1468,9 @@ default. Be careful about it when you use the flag.</p> 
     | 
|
| 
       1468 
1468 
     | 
    
         
             
            # ]
         
     | 
| 
       1469 
1469 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1470 
1470 
     | 
    
         
             
            </div>
         
     | 
| 
       1471 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1472 
     | 
    
         
            -
            < 
     | 
| 
       1473 
     | 
    
         
            -
            <p>Here is a usage example of < 
     | 
| 
      
 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>
         
     | 
| 
       1474 
1474 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1475 
1475 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>table_create Users TABLE_HASH_KEY ShortText
         
     | 
| 
       1476 
1476 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], true]
         
     | 
| 
         @@ -1562,10 +1562,10 @@ select Users 
     | 
|
| 
       1562 
1562 
     | 
    
         
             
            # ]
         
     | 
| 
       1563 
1563 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1564 
1564 
     | 
    
         
             
            </div>
         
     | 
| 
       1565 
     | 
    
         
            -
            <p>The first < 
     | 
| 
       1566 
     | 
    
         
            -
            to < 
     | 
| 
      
 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>
         
     | 
| 
       1567 
1567 
     | 
    
         
             
            column values.</p>
         
     | 
| 
       1568 
     | 
    
         
            -
            <p>Here is a usage example of < 
     | 
| 
      
 1568 
     | 
    
         
            +
            <p>Here is a usage example of <tt class="docutils literal"><span class="pre">ALLOW_LEADING_NOT</span></tt>.</p>
         
     | 
| 
       1569 
1569 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1570 
1570 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query -mroonga --query_flags ALLOW_LEADING_NOT
         
     | 
| 
       1571 
1571 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -1634,9 +1634,9 @@ column values.</p> 
     | 
|
| 
       1634 
1634 
     | 
    
         
             
            # ]
         
     | 
| 
       1635 
1635 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1636 
1636 
     | 
    
         
             
            </div>
         
     | 
| 
       1637 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1638 
     | 
    
         
            -
            in < 
     | 
| 
       1639 
     | 
    
         
            -
            <p>Here is a usage example of < 
     | 
| 
      
 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>
         
     | 
| 
       1640 
1640 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1641 
1641 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query 'mroonga OR _key:Groonga' --query_flags NONE
         
     | 
| 
       1642 
1642 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -1684,36 +1684,36 @@ in <code class="docutils literal"><span class="pre">content</span></code> column 
     | 
|
| 
       1684 
1684 
     | 
    
         
             
            # ]
         
     | 
| 
       1685 
1685 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1686 
1686 
     | 
    
         
             
            </div>
         
     | 
| 
       1687 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1688 
     | 
    
         
            -
            < 
     | 
| 
       1689 
     | 
    
         
            -
            Note that < 
     | 
| 
       1690 
     | 
    
         
            -
            column is equal to < 
     | 
| 
      
 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
         
     | 
| 
       1691 
1691 
     | 
    
         
             
            specified.</p>
         
     | 
| 
       1692 
1692 
     | 
    
         
             
            <p>See also <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a>.</p>
         
     | 
| 
       1693 
1693 
     | 
    
         
             
            </div>
         
     | 
| 
       1694 
1694 
     | 
    
         
             
            <div class="section" id="query-expander">
         
     | 
| 
       1695 
     | 
    
         
            -
            <span id="id5"></span><h4>7.3. 
     | 
| 
      
 1695 
     | 
    
         
            +
            <span id="id5"></span><h4>7.3.33.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 
1696 
     | 
    
         
             
            <p>It's for query expansion. Query expansion substitutes specific words
         
     | 
| 
       1697 
1697 
     | 
    
         
             
            to another words in query. Nomally, it's used for synonym search.</p>
         
     | 
| 
       1698 
     | 
    
         
            -
            <p>It specifies a column that is used to substitute < 
     | 
| 
      
 1698 
     | 
    
         
            +
            <p>It specifies a column that is used to substitute <tt class="docutils literal"><span class="pre">query</span></tt> parameter
         
     | 
| 
       1699 
1699 
     | 
    
         
             
            value. The format of this parameter value is
         
     | 
| 
       1700 
     | 
    
         
            -
            "< 
     | 
| 
       1701 
     | 
    
         
            -
            < 
     | 
| 
      
 1700 
     | 
    
         
            +
            "<tt class="docutils literal"><span class="pre">${TABLE}.${COLUMN}</span></tt>". For example, "<tt class="docutils literal"><span class="pre">Terms.synonym</span></tt>" 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>
         
     | 
| 
       1702 
1702 
     | 
    
         
             
            <p>Table for query expansion is called "substitution table". Substitution
         
     | 
| 
       1703 
     | 
    
         
            -
            table's key must be < 
     | 
| 
      
 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 
1704 
     | 
    
         
             
            can't be used for query expansion. Because array table doesn't have
         
     | 
| 
       1705 
1705 
     | 
    
         
             
            key.</p>
         
     | 
| 
       1706 
1706 
     | 
    
         
             
            <p>Column for query expansion is called "substitution
         
     | 
| 
       1707 
1707 
     | 
    
         
             
            column". Substitution column's value type must be
         
     | 
| 
       1708 
     | 
    
         
            -
            < 
     | 
| 
      
 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 
1709 
     | 
    
         
             
            <p>Query expansion substitutes key of substitution table in query with
         
     | 
| 
       1710 
     | 
    
         
            -
            values in substitution column. If a word in < 
     | 
| 
      
 1710 
     | 
    
         
            +
            values in substitution column. If a word in <tt class="docutils literal"><span class="pre">query</span></tt> is a key of
         
     | 
| 
       1711 
1711 
     | 
    
         
             
            substitution table, the word is substituted with substitution column
         
     | 
| 
       1712 
1712 
     | 
    
         
             
            value that is associated with the key. Substition isn't performed
         
     | 
| 
       1713 
1713 
     | 
    
         
             
            recursively. It means that substitution target words in substituted
         
     | 
| 
       1714 
1714 
     | 
    
         
             
            query aren't substituted.</p>
         
     | 
| 
       1715 
1715 
     | 
    
         
             
            <p>Here is a sample substitution table to show a simple
         
     | 
| 
       1716 
     | 
    
         
            -
            < 
     | 
| 
      
 1716 
     | 
    
         
            +
            <tt class="docutils literal"><span class="pre">query_expander</span></tt> usage example.</p>
         
     | 
| 
       1717 
1717 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1718 
1718 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>table_create Thesaurus TABLE_PAT_KEY|KEY_NORMALIZE ShortText
         
     | 
| 
       1719 
1719 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], true]
         
     | 
| 
         @@ -1727,22 +1727,22 @@ load --table Thesaurus 
     | 
|
| 
       1727 
1727 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], 2]
         
     | 
| 
       1728 
1728 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1729 
1729 
     | 
    
         
             
            </div>
         
     | 
| 
       1730 
     | 
    
         
            -
            <p>< 
     | 
| 
       1731 
     | 
    
         
            -
            < 
     | 
| 
       1732 
     | 
    
         
            -
            searches with < 
     | 
| 
       1733 
     | 
    
         
            -
            user searches with < 
     | 
| 
       1734 
     | 
    
         
            -
            <span class="pre">OR</span> <span class="pre">(senna))"</span></ 
     | 
| 
       1735 
     | 
    
         
            -
            < 
     | 
| 
      
 1730 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">Thesaurus</span></tt> substitution table has two synonyms, <tt class="docutils literal"><span class="pre">"mroonga"</span></tt> and
         
     | 
| 
      
 1731 
     | 
    
         
            +
            <tt class="docutils literal"><span class="pre">"groonga"</span></tt>. If an user searches with <tt class="docutils literal"><span class="pre">"mroonga"</span></tt>, groonga
         
     | 
| 
      
 1732 
     | 
    
         
            +
            searches with <tt class="docutils literal"><span class="pre">"((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))"</span></tt>. If an
         
     | 
| 
      
 1733 
     | 
    
         
            +
            user searches with <tt class="docutils literal"><span class="pre">"groonga"</span></tt>, groonga searches with <tt class="docutils literal"><span class="pre">"((groonga)</span>
         
     | 
| 
      
 1734 
     | 
    
         
            +
            <span class="pre">OR</span> <span class="pre">(senna))"</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 
1736 
     | 
    
         
             
            matched in case insensitive manner.</p>
         
     | 
| 
       1737 
1737 
     | 
    
         
             
            <p>Note that those synonym values include the key value such as
         
     | 
| 
       1738 
     | 
    
         
            -
            < 
     | 
| 
      
 1738 
     | 
    
         
            +
            <tt class="docutils literal"><span class="pre">"mroonga"</span></tt> and <tt class="docutils literal"><span class="pre">"groonga"</span></tt>. It's recommended that you include the
         
     | 
| 
       1739 
1739 
     | 
    
         
             
            key value. If you don't include key value, substituted value doesn't
         
     | 
| 
       1740 
1740 
     | 
    
         
             
            include the original substitute target value. Normally, including the
         
     | 
| 
       1741 
1741 
     | 
    
         
             
            original value is better search result. If you have a word that you
         
     | 
| 
       1742 
1742 
     | 
    
         
             
            don't want to be searched, you should not include the original
         
     | 
| 
       1743 
1743 
     | 
    
         
             
            word. For example, you can implement "stop words" by an empty vector
         
     | 
| 
       1744 
1744 
     | 
    
         
             
            value.</p>
         
     | 
| 
       1745 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 1745 
     | 
    
         
            +
            <p>Here is a simple <tt class="docutils literal"><span class="pre">query_expander</span></tt> usage example.</p>
         
     | 
| 
       1746 
1746 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1747 
1747 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query "mroonga"
         
     | 
| 
       1748 
1748 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -1892,13 +1892,13 @@ select Entries --match_columns content --query "((mroonga) OR (tritonn) OR 
     | 
|
| 
       1892 
1892 
     | 
    
         
             
            # ]
         
     | 
| 
       1893 
1893 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1894 
1894 
     | 
    
         
             
            </div>
         
     | 
| 
       1895 
     | 
    
         
            -
            <p>The first < 
     | 
| 
       1896 
     | 
    
         
            -
            that has < 
     | 
| 
       1897 
     | 
    
         
            -
            query expansion. So a record that has < 
     | 
| 
       1898 
     | 
    
         
            -
            third < 
     | 
| 
       1899 
     | 
    
         
            -
            the second < 
     | 
| 
      
 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">"tritonn"</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">"tritonn"</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>
         
     | 
| 
       1900 
1900 
     | 
    
         
             
            <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 < 
     | 
| 
      
 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
         
     | 
| 
       1902 
1902 
     | 
    
         
             
            using those syntax.</p>
         
     | 
| 
       1903 
1903 
     | 
    
         
             
            <p>Here is a complex substitution usage example that uses query syntax.</p>
         
     | 
| 
       1904 
1904 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
         @@ -1960,20 +1960,20 @@ select Entries --match_columns content --query "popular" --query_expan 
     | 
|
| 
       1960 
1960 
     | 
    
         
             
            # ]
         
     | 
| 
       1961 
1961 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1962 
1962 
     | 
    
         
             
            </div>
         
     | 
| 
       1963 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1964 
     | 
    
         
            -
            substituted with < 
     | 
| 
      
 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">"popular"</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:>=10))</span></tt>. The substituted
         
     | 
| 
       1965 
1965 
     | 
    
         
             
            query means that "popular" is containing the word "popular" or 10 or
         
     | 
| 
       1966 
1966 
     | 
    
         
             
            more liked entries.</p>
         
     | 
| 
       1967 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1968 
     | 
    
         
            -
            is equal to or more than < 
     | 
| 
      
 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>
         
     | 
| 
       1969 
1969 
     | 
    
         
             
            </div>
         
     | 
| 
       1970 
1970 
     | 
    
         
             
            </div>
         
     | 
| 
       1971 
1971 
     | 
    
         
             
            <div class="section" id="output-related-parameters">
         
     | 
| 
       1972 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
      
 1972 
     | 
    
         
            +
            <h3>7.3.33.4.4. Output related parameters<a class="headerlink" href="#output-related-parameters" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       1973 
1973 
     | 
    
         
             
            <div class="section" id="output-columns">
         
     | 
| 
       1974 
     | 
    
         
            -
            <span id="select-output-columns"></span><h4>7.3. 
     | 
| 
       1975 
     | 
    
         
            -
            <p> 
     | 
| 
       1976 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 1974 
     | 
    
         
            +
            <span id="select-output-columns"></span><h4>7.3.33.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 
1977 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1978 
1978 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --output_columns '_id, _key' --limit 1
         
     | 
| 
       1979 
1979 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2006,11 +2006,11 @@ is equal to or more than <code class="docutils literal"><span class="pre">10</sp 
     | 
|
| 
       2006 
2006 
     | 
    
         
             
            # ]
         
     | 
| 
       2007 
2007 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2008 
2008 
     | 
    
         
             
            </div>
         
     | 
| 
       2009 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 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
         
     | 
| 
       2010 
2010 
     | 
    
         
             
            values.</p>
         
     | 
| 
       2011 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 2011 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">*</span></tt> is a special value. It means that all columns that are not
         
     | 
| 
       2012 
2012 
     | 
    
         
             
            <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a>.</p>
         
     | 
| 
       2013 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 2013 
     | 
    
         
            +
            <p>Here is a <tt class="docutils literal"><span class="pre">*</span></tt> usage example.</p>
         
     | 
| 
       2014 
2014 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2015 
2015 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --output_columns '_key, *' --limit 1
         
     | 
| 
       2016 
2016 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2053,17 +2053,17 @@ values.</p> 
     | 
|
| 
       2053 
2053 
     | 
    
         
             
            # ]
         
     | 
| 
       2054 
2054 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2055 
2055 
     | 
    
         
             
            </div>
         
     | 
| 
       2056 
     | 
    
         
            -
            <p>The < 
     | 
| 
       2057 
     | 
    
         
            -
            column and < 
     | 
| 
      
 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
         
     | 
| 
       2058 
2058 
     | 
    
         
             
            column value.</p>
         
     | 
| 
       2059 
     | 
    
         
            -
            <p>The default value is < 
     | 
| 
       2060 
     | 
    
         
            -
            values except < 
     | 
| 
      
 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>
         
     | 
| 
       2061 
2061 
     | 
    
         
             
            </div>
         
     | 
| 
       2062 
2062 
     | 
    
         
             
            <div class="section" id="sortby">
         
     | 
| 
       2063 
     | 
    
         
            -
            <span id="select-sortby"></span><h4>7.3. 
     | 
| 
       2064 
     | 
    
         
            -
            <p> 
     | 
| 
      
 2063 
     | 
    
         
            +
            <span id="select-sortby"></span><h4>7.3.33.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
         
     | 
| 
       2065 
2065 
     | 
    
         
             
            name.</p>
         
     | 
| 
       2066 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 2066 
     | 
    
         
            +
            <p>Here is a simple <tt class="docutils literal"><span class="pre">sortby</span></tt> usage example.</p>
         
     | 
| 
       2067 
2067 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2068 
2068 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --sortby 'n_likes, _id'
         
     | 
| 
       2069 
2069 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2139,12 +2139,12 @@ name.</p> 
     | 
|
| 
       2139 
2139 
     | 
    
         
             
            # ]
         
     | 
| 
       2140 
2140 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2141 
2141 
     | 
    
         
             
            </div>
         
     | 
| 
       2142 
     | 
    
         
            -
            <p>The < 
     | 
| 
       2143 
     | 
    
         
            -
            order. For records that has the same < 
     | 
| 
       2144 
     | 
    
         
            -
            in ascending order. < 
     | 
| 
      
 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">"Good-bye</span> <span class="pre">Senna"</span></tt> and <tt class="docutils literal"><span class="pre">"Good-bye</span> <span class="pre">Tritonn"</span></tt>
         
     | 
| 
       2145 
2145 
     | 
    
         
             
            are the case.</p>
         
     | 
| 
       2146 
     | 
    
         
            -
            <p>If you want to sort in descending order, add < 
     | 
| 
       2147 
     | 
    
         
            -
            <p>Here is a descending order < 
     | 
| 
      
 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>
         
     | 
| 
       2148 
2148 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2149 
2149 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --sortby '-n_likes, _id'
         
     | 
| 
       2150 
2150 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2220,10 +2220,10 @@ are the case.</p> 
     | 
|
| 
       2220 
2220 
     | 
    
         
             
            # ]
         
     | 
| 
       2221 
2221 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2222 
2222 
     | 
    
         
             
            </div>
         
     | 
| 
       2223 
     | 
    
         
            -
            <p>The < 
     | 
| 
       2224 
     | 
    
         
            -
            order. But ascending order is used for sorting by < 
     | 
| 
       2225 
     | 
    
         
            -
            <p>You can use < 
     | 
| 
       2226 
     | 
    
         
            -
            < 
     | 
| 
      
 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>
         
     | 
| 
       2227 
2227 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2228 
2228 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query fast --sortby -_score --output_columns '_key, _score'
         
     | 
| 
       2229 
2229 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2260,15 +2260,15 @@ order. But ascending order is used for sorting by <code class="docutils literal" 
     | 
|
| 
       2260 
2260 
     | 
    
         
             
            # ]
         
     | 
| 
       2261 
2261 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2262 
2262 
     | 
    
         
             
            </div>
         
     | 
| 
       2263 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 2263 
     | 
    
         
            +
            <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command sorts matched records by hit score in
         
     | 
| 
       2264 
2264 
     | 
    
         
             
            descending order and outputs record key and hit score.</p>
         
     | 
| 
       2265 
     | 
    
         
            -
            <p>If you use < 
     | 
| 
      
 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,
         
     | 
| 
       2266 
2266 
     | 
    
         
             
            it's just ignored but get a warning in log file.</p>
         
     | 
| 
       2267 
2267 
     | 
    
         
             
            </div>
         
     | 
| 
       2268 
2268 
     | 
    
         
             
            <div class="section" id="offset">
         
     | 
| 
       2269 
     | 
    
         
            -
            <span id="select-offset"></span><h4>7.3. 
     | 
| 
       2270 
     | 
    
         
            -
            <p> 
     | 
| 
       2271 
     | 
    
         
            -
            zero-based. < 
     | 
| 
      
 2269 
     | 
    
         
            +
            <span id="select-offset"></span><h4>7.3.33.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>
         
     | 
| 
      
 2270 
     | 
    
         
            +
            <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
         
     | 
| 
       2272 
2272 
     | 
    
         
             
            record.</p>
         
     | 
| 
       2273 
2273 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2274 
2274 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --sortby _id --offset 3 --output_columns _key
         
     | 
| 
         @@ -2300,10 +2300,10 @@ record.</p> 
     | 
|
| 
       2300 
2300 
     | 
    
         
             
            # ]
         
     | 
| 
       2301 
2301 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2302 
2302 
     | 
    
         
             
            </div>
         
     | 
| 
       2303 
     | 
    
         
            -
            <p>The < 
     | 
| 
       2304 
     | 
    
         
            -
            <p>You can specify negative value. It means that < 
     | 
| 
       2305 
     | 
    
         
            -
            <span class="pre">records</span> <span class="pre">+</span> <span class="pre">offset</span></ 
     | 
| 
       2306 
     | 
    
         
            -
            < 
     | 
| 
      
 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>
         
     | 
| 
       2307 
2307 
     | 
    
         
             
            means 2nd. Remember that offset is zero-based.) record to the 3rd
         
     | 
| 
       2308 
2308 
     | 
    
         
             
            record.</p>
         
     | 
| 
       2309 
2309 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
         @@ -2336,15 +2336,15 @@ record.</p> 
     | 
|
| 
       2336 
2336 
     | 
    
         
             
            # ]
         
     | 
| 
       2337 
2337 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2338 
2338 
     | 
    
         
             
            </div>
         
     | 
| 
       2339 
     | 
    
         
            -
            <p>The < 
     | 
| 
       2340 
     | 
    
         
            -
            number of records is < 
     | 
| 
       2341 
     | 
    
         
            -
            <p>The default value is < 
     | 
| 
      
 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 
2342 
     | 
    
         
             
            </div>
         
     | 
| 
       2343 
2343 
     | 
    
         
             
            <div class="section" id="limit">
         
     | 
| 
       2344 
     | 
    
         
            -
            <h4>7.3. 
     | 
| 
       2345 
     | 
    
         
            -
            <p> 
     | 
| 
       2346 
     | 
    
         
            -
            matched records is less than < 
     | 
| 
       2347 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 2344 
     | 
    
         
            +
            <h4>7.3.33.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>
         
     | 
| 
      
 2345 
     | 
    
         
            +
            <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>
         
     | 
| 
       2348 
2348 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2349 
2349 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --sortby _id --offset 2 --limit 3 --output_columns _key
         
     | 
| 
       2350 
2350 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2378,11 +2378,11 @@ matched records is less than <code class="docutils literal"><span class="pre">li 
     | 
|
| 
       2378 
2378 
     | 
    
         
             
            # ]
         
     | 
| 
       2379 
2379 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2380 
2380 
     | 
    
         
             
            </div>
         
     | 
| 
       2381 
     | 
    
         
            -
            <p>The < 
     | 
| 
       2382 
     | 
    
         
            -
            <p>You can specify negative value. It means that < 
     | 
| 
       2383 
     | 
    
         
            -
            <span class="pre">records</span> <span class="pre">+</span> <span class="pre">limit</span> <span class="pre">+</span> <span class="pre">1</span></ 
     | 
| 
      
 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 
2384 
     | 
    
         
             
            records. It's very useful value to show all records.</p>
         
     | 
| 
       2385 
     | 
    
         
            -
            <p>Here is a simple negative < 
     | 
| 
      
 2385 
     | 
    
         
            +
            <p>Here is a simple negative <tt class="docutils literal"><span class="pre">limit</span></tt> value usage example.</p>
         
     | 
| 
       2386 
2386 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2387 
2387 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --limit -1
         
     | 
| 
       2388 
2388 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2458,27 +2458,27 @@ records. It's very useful value to show all records.</p> 
     | 
|
| 
       2458 
2458 
     | 
    
         
             
            # ]
         
     | 
| 
       2459 
2459 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2460 
2460 
     | 
    
         
             
            </div>
         
     | 
| 
       2461 
     | 
    
         
            -
            <p>The < 
     | 
| 
       2462 
     | 
    
         
            -
            <p>The default value is < 
     | 
| 
      
 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>
         
     | 
| 
       2463 
2463 
     | 
    
         
             
            </div>
         
     | 
| 
       2464 
2464 
     | 
    
         
             
            <div class="section" id="scorer">
         
     | 
| 
       2465 
     | 
    
         
            -
            <h4>7.3. 
     | 
| 
      
 2465 
     | 
    
         
            +
            <h4>7.3.33.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>
         
     | 
| 
       2466 
2466 
     | 
    
         
             
            <p>TODO: write in English and add example.</p>
         
     | 
| 
       2467 
2467 
     | 
    
         
             
            <p>検索条件にマッチする全てのレコードに対して適用するgrn_exprをscript形式で指定します。</p>
         
     | 
| 
       2468 
2468 
     | 
    
         
             
            <p>scorerは、検索処理が完了し、ソート処理が実行される前に呼び出されます。従って、各レコードのスコアを操作する式を指定しておけば、検索結果のソート順序をカスタマイズできるようになります。</p>
         
     | 
| 
       2469 
2469 
     | 
    
         
             
            </div>
         
     | 
| 
       2470 
2470 
     | 
    
         
             
            </div>
         
     | 
| 
       2471 
2471 
     | 
    
         
             
            <div class="section" id="drilldown-related-parameters">
         
     | 
| 
       2472 
     | 
    
         
            -
            <span id="select-drilldown-related-parameters"></span><h3>7.3. 
     | 
| 
      
 2472 
     | 
    
         
            +
            <span id="select-drilldown-related-parameters"></span><h3>7.3.33.4.5. Drilldown related parameters<a class="headerlink" href="#drilldown-related-parameters" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       2473 
2473 
     | 
    
         
             
            <p>This section describes basic drilldown related parameters. Advanced
         
     | 
| 
       2474 
2474 
     | 
    
         
             
            drilldown related parameters are described in another section.</p>
         
     | 
| 
       2475 
2475 
     | 
    
         
             
            <div class="section" id="select-drilldown">
         
     | 
| 
       2476 
     | 
    
         
            -
            <span id="id6"></span><h4>7.3. 
     | 
| 
       2477 
     | 
    
         
            -
            <p> 
     | 
| 
      
 2476 
     | 
    
         
            +
            <span id="id6"></span><h4>7.3.33.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>
         
     | 
| 
       2478 
2478 
     | 
    
         
             
            <p>Matched records by specified search conditions are grouped by each
         
     | 
| 
       2479 
2479 
     | 
    
         
             
            key. If you specify no search condition, all records are grouped by
         
     | 
| 
       2480 
2480 
     | 
    
         
             
            each key.</p>
         
     | 
| 
       2481 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 2481 
     | 
    
         
            +
            <p>Here is a simple <tt class="docutils literal"><span class="pre">drilldown</span></tt> example:</p>
         
     | 
| 
       2482 
2482 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2483 
2483 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       2484 
2484 
     | 
    
         
             
              --output_columns _key,tag \
         
     | 
| 
         @@ -2556,7 +2556,7 @@ each key.</p> 
     | 
|
| 
       2556 
2556 
     | 
    
         
             
            # ]
         
     | 
| 
       2557 
2557 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2558 
2558 
     | 
    
         
             
            </div>
         
     | 
| 
       2559 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 2559 
     | 
    
         
            +
            <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs the following information:</p>
         
     | 
| 
       2560 
2560 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       2561 
2561 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       2562 
2562 
     | 
    
         
             
            <li>There is one record that has "Hello" tag.</li>
         
     | 
| 
         @@ -2564,7 +2564,7 @@ each key.</p> 
     | 
|
| 
       2564 
2564 
     | 
    
         
             
            <li>There is two records that has "Senna" tag.</li>
         
     | 
| 
       2565 
2565 
     | 
    
         
             
            </ul>
         
     | 
| 
       2566 
2566 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       2567 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 2567 
     | 
    
         
            +
            <p>Here is a <tt class="docutils literal"><span class="pre">drilldown</span></tt> with search condition example:</p>
         
     | 
| 
       2568 
2568 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2569 
2569 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       2570 
2570 
     | 
    
         
             
              --output_columns _key,tag \
         
     | 
| 
         @@ -2631,17 +2631,17 @@ each key.</p> 
     | 
|
| 
       2631 
2631 
     | 
    
         
             
            # ]
         
     | 
| 
       2632 
2632 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2633 
2633 
     | 
    
         
             
            </div>
         
     | 
| 
       2634 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 2634 
     | 
    
         
            +
            <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs the following information:</p>
         
     | 
| 
       2635 
2635 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       2636 
2636 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       2637 
     | 
    
         
            -
            <li>In records that have 5 or larger as < 
     | 
| 
      
 2637 
     | 
    
         
            +
            <li>In records that have 5 or larger as <tt class="docutils literal"><span class="pre">n_likes</span></tt> value:<ul>
         
     | 
| 
       2638 
2638 
     | 
    
         
             
            <li>There is one record that has "Hello" tag.</li>
         
     | 
| 
       2639 
2639 
     | 
    
         
             
            <li>There is two records that has "Groonga" tag.</li>
         
     | 
| 
       2640 
2640 
     | 
    
         
             
            </ul>
         
     | 
| 
       2641 
2641 
     | 
    
         
             
            </li>
         
     | 
| 
       2642 
2642 
     | 
    
         
             
            </ul>
         
     | 
| 
       2643 
2643 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       2644 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 2644 
     | 
    
         
            +
            <p>Here is a <tt class="docutils literal"><span class="pre">drilldown</span></tt> with multiple group keys example:</p>
         
     | 
| 
       2645 
2645 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2646 
2646 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       2647 
2647 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -2743,16 +2743,16 @@ each key.</p> 
     | 
|
| 
       2743 
2743 
     | 
    
         
             
            # ]
         
     | 
| 
       2744 
2744 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2745 
2745 
     | 
    
         
             
            </div>
         
     | 
| 
       2746 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 2746 
     | 
    
         
            +
            <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command outputs the following information:</p>
         
     | 
| 
       2747 
2747 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       2748 
2748 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       2749 
     | 
    
         
            -
            <li>About < 
     | 
| 
      
 2749 
     | 
    
         
            +
            <li>About <tt class="docutils literal"><span class="pre">tag</span></tt>:<ul>
         
     | 
| 
       2750 
2750 
     | 
    
         
             
            <li>There is one record that has "Hello" tag.</li>
         
     | 
| 
       2751 
2751 
     | 
    
         
             
            <li>There is two records that has "Groonga" tag.</li>
         
     | 
| 
       2752 
2752 
     | 
    
         
             
            <li>There is two records that has "Senna" tag.</li>
         
     | 
| 
       2753 
2753 
     | 
    
         
             
            </ul>
         
     | 
| 
       2754 
2754 
     | 
    
         
             
            </li>
         
     | 
| 
       2755 
     | 
    
         
            -
            <li>About < 
     | 
| 
      
 2755 
     | 
    
         
            +
            <li>About <tt class="docutils literal"><span class="pre">n_likes</span></tt>:<ul>
         
     | 
| 
       2756 
2756 
     | 
    
         
             
            <li>There is one record that has "Hello" tag.</li>
         
     | 
| 
       2757 
2757 
     | 
    
         
             
            <li>There is two records that has "Groonga" tag.</li>
         
     | 
| 
       2758 
2758 
     | 
    
         
             
            <li>There is two records that has "Senna" tag.</li>
         
     | 
| 
         @@ -2762,12 +2762,12 @@ each key.</p> 
     | 
|
| 
       2762 
2762 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       2763 
2763 
     | 
    
         
             
            </div>
         
     | 
| 
       2764 
2764 
     | 
    
         
             
            <div class="section" id="drilldown-sortby">
         
     | 
| 
       2765 
     | 
    
         
            -
            <span id="select-drilldown-sortby"></span><h4>7.3. 
     | 
| 
       2766 
     | 
    
         
            -
            <p> 
     | 
| 
      
 2765 
     | 
    
         
            +
            <span id="select-drilldown-sortby"></span><h4>7.3.33.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
         
     | 
| 
       2767 
2767 
     | 
    
         
             
            sort key is column name.</p>
         
     | 
| 
       2768 
     | 
    
         
            -
            <p>You can refer the number of grouped records by < 
     | 
| 
      
 2768 
     | 
    
         
            +
            <p>You can refer the number of grouped records by <tt class="docutils literal"><span class="pre">_nsubrecs</span></tt>
         
     | 
| 
       2769 
2769 
     | 
    
         
             
            <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a>.</p>
         
     | 
| 
       2770 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 2770 
     | 
    
         
            +
            <p>Here is a simple <tt class="docutils literal"><span class="pre">drilldown_sortby</span></tt> example:</p>
         
     | 
| 
       2771 
2771 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2772 
2772 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       2773 
2773 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -2871,10 +2871,10 @@ sort key is column name.</p> 
     | 
|
| 
       2871 
2871 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2872 
2872 
     | 
    
         
             
            </div>
         
     | 
| 
       2873 
2873 
     | 
    
         
             
            <p>Drilldown result is sorted by the number of grouped records (=
         
     | 
| 
       2874 
     | 
    
         
            -
            < 
     | 
| 
      
 2874 
     | 
    
         
            +
            <tt class="docutils literal"><span class="pre">_nsubrecs</span></tt> ) in descending order. If there are grouped results that
         
     | 
| 
       2875 
2875 
     | 
    
         
             
            the number of records in the group are the same, these grouped results
         
     | 
| 
       2876 
     | 
    
         
            -
            are sorted by grouped key (= < 
     | 
| 
       2877 
     | 
    
         
            -
            <p>The sort keys are used in all group keys specified in < 
     | 
| 
      
 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>
         
     | 
| 
       2878 
2878 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2879 
2879 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       2880 
2880 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -2977,15 +2977,15 @@ are sorted by grouped key (= <code class="docutils literal"><span class="pre">_k 
     | 
|
| 
       2977 
2977 
     | 
    
         
             
            # ]
         
     | 
| 
       2978 
2978 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2979 
2979 
     | 
    
         
             
            </div>
         
     | 
| 
       2980 
     | 
    
         
            -
            <p>The same sort keys are used in < 
     | 
| 
      
 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>
         
     | 
| 
       2981 
2981 
     | 
    
         
             
            drilldown.</p>
         
     | 
| 
       2982 
2982 
     | 
    
         
             
            <p>If you want to use different sort keys for each drilldown, use
         
     | 
| 
       2983 
2983 
     | 
    
         
             
            <a class="reference internal" href="#select-advanced-drilldown-related-parameters"><em>Advanced drilldown related parameters</em></a>.</p>
         
     | 
| 
       2984 
2984 
     | 
    
         
             
            </div>
         
     | 
| 
       2985 
2985 
     | 
    
         
             
            <div class="section" id="drilldown-output-columns">
         
     | 
| 
       2986 
     | 
    
         
            -
            <span id="select-drilldown-output-columns"></span><h4>7.3. 
     | 
| 
       2987 
     | 
    
         
            -
            <p> 
     | 
| 
       2988 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 2986 
     | 
    
         
            +
            <span id="select-drilldown-output-columns"></span><h4>7.3.33.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 
2989 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2990 
2990 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       2991 
2991 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -3050,7 +3050,7 @@ drilldown.</p> 
     | 
|
| 
       3050 
3050 
     | 
    
         
             
            # ]
         
     | 
| 
       3051 
3051 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3052 
3052 
     | 
    
         
             
            </div>
         
     | 
| 
       3053 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 3053 
     | 
    
         
            +
            <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command just outputs grouped key.</p>
         
     | 
| 
       3054 
3054 
     | 
    
         
             
            <p>If grouped key is a referenced type column (= column that its type is
         
     | 
| 
       3055 
3055 
     | 
    
         
             
            a table), you can access column of the table referenced by the
         
     | 
| 
       3056 
3056 
     | 
    
         
             
            referenced type column.</p>
         
     | 
| 
         @@ -3082,10 +3082,10 @@ load --table Items 
     | 
|
| 
       3082 
3082 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], 3]
         
     | 
| 
       3083 
3083 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3084 
3084 
     | 
    
         
             
            </div>
         
     | 
| 
       3085 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 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
         
     | 
| 
       3086 
3086 
     | 
    
         
             
            type column.</p>
         
     | 
| 
       3087 
     | 
    
         
            -
            <p>You can refer < 
     | 
| 
       3088 
     | 
    
         
            -
            < 
     | 
| 
      
 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>
         
     | 
| 
       3089 
3089 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3090 
3090 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Items \
         
     | 
| 
       3091 
3091 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -3145,7 +3145,7 @@ type column.</p> 
     | 
|
| 
       3145 
3145 
     | 
    
         
             
            # ]
         
     | 
| 
       3146 
3146 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3147 
3147 
     | 
    
         
             
            </div>
         
     | 
| 
       3148 
     | 
    
         
            -
            <p>You can use < 
     | 
| 
      
 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>
         
     | 
| 
       3149 
3149 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3150 
3150 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Items \
         
     | 
| 
       3151 
3151 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -3211,21 +3211,21 @@ type column.</p> 
     | 
|
| 
       3211 
3211 
     | 
    
         
             
            # ]
         
     | 
| 
       3212 
3212 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3213 
3213 
     | 
    
         
             
            </div>
         
     | 
| 
       3214 
     | 
    
         
            -
            <p>< 
     | 
| 
       3215 
     | 
    
         
            -
            <p>The default value of < 
     | 
| 
       3216 
     | 
    
         
            -
            <span class="pre">_nsubrecs</span></ 
     | 
| 
      
 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 
3217 
     | 
    
         
             
            the group are output.</p>
         
     | 
| 
       3218 
3218 
     | 
    
         
             
            <p>You can use more <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> in
         
     | 
| 
       3219 
     | 
    
         
            -
            < 
     | 
| 
       3220 
     | 
    
         
            -
            < 
     | 
| 
       3221 
     | 
    
         
            -
            < 
     | 
| 
      
 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 
3222 
     | 
    
         
             
            </div>
         
     | 
| 
       3223 
3223 
     | 
    
         
             
            <div class="section" id="drilldown-offset">
         
     | 
| 
       3224 
     | 
    
         
            -
            <span id="select-drilldown-offset"></span><h4>7.3. 
     | 
| 
       3225 
     | 
    
         
            -
            <p> 
     | 
| 
       3226 
     | 
    
         
            -
            records. Offset is zero-based. < 
     | 
| 
      
 3224 
     | 
    
         
            +
            <span id="select-drilldown-offset"></span><h4>7.3.33.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>
         
     | 
| 
      
 3225 
     | 
    
         
            +
            <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
         
     | 
| 
       3227 
3227 
     | 
    
         
             
            range is started from the 2nd record.</p>
         
     | 
| 
       3228 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 3228 
     | 
    
         
            +
            <p>Here is a <tt class="docutils literal"><span class="pre">drilldown_offset</span></tt> example:</p>
         
     | 
| 
       3229 
3229 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3230 
3230 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3231 
3231 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -3294,11 +3294,11 @@ range is started from the 2nd record.</p> 
     | 
|
| 
       3294 
3294 
     | 
    
         
             
            # ]
         
     | 
| 
       3295 
3295 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3296 
3296 
     | 
    
         
             
            </div>
         
     | 
| 
       3297 
     | 
    
         
            -
            <p>The < 
     | 
| 
       3298 
     | 
    
         
            -
            <p>You can specify negative value. It means that < 
     | 
| 
       3299 
     | 
    
         
            -
            <span class="pre">results</span> <span class="pre">+</span> <span class="pre">offset</span></ 
     | 
| 
       3300 
     | 
    
         
            -
            < 
     | 
| 
       3301 
     | 
    
         
            -
            (< 
     | 
| 
      
 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.)
         
     | 
| 
       3302 
3302 
     | 
    
         
             
            grouped result to the 3rd grouped result.</p>
         
     | 
| 
       3303 
3303 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3304 
3304 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
         @@ -3368,15 +3368,15 @@ grouped result to the 3rd grouped result.</p> 
     | 
|
| 
       3368 
3368 
     | 
    
         
             
            # ]
         
     | 
| 
       3369 
3369 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3370 
3370 
     | 
    
         
             
            </div>
         
     | 
| 
       3371 
     | 
    
         
            -
            <p>The < 
     | 
| 
       3372 
     | 
    
         
            -
            total number of grouped results is < 
     | 
| 
       3373 
     | 
    
         
            -
            <p>The default value of < 
     | 
| 
      
 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 
3374 
     | 
    
         
             
            </div>
         
     | 
| 
       3375 
3375 
     | 
    
         
             
            <div class="section" id="drilldown-limit">
         
     | 
| 
       3376 
     | 
    
         
            -
            <span id="select-drilldown-limit"></span><h4>7.3. 
     | 
| 
       3377 
     | 
    
         
            -
            <p> 
     | 
| 
       3378 
     | 
    
         
            -
            groups is less than < 
     | 
| 
       3379 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 3376 
     | 
    
         
            +
            <span id="select-drilldown-limit"></span><h4>7.3.33.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>
         
     | 
| 
      
 3377 
     | 
    
         
            +
            <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>
         
     | 
| 
       3380 
3380 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3381 
3381 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3382 
3382 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -3446,11 +3446,11 @@ groups is less than <code class="docutils literal"><span class="pre">drilldown_l 
     | 
|
| 
       3446 
3446 
     | 
    
         
             
            # ]
         
     | 
| 
       3447 
3447 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3448 
3448 
     | 
    
         
             
            </div>
         
     | 
| 
       3449 
     | 
    
         
            -
            <p>The < 
     | 
| 
       3450 
     | 
    
         
            -
            <p>You can specify negative value. It means that < 
     | 
| 
       3451 
     | 
    
         
            -
            <span class="pre">drilldown_limit</span> <span class="pre">+</span> <span class="pre">1</span></ 
     | 
| 
      
 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 
3452 
     | 
    
         
             
            all groups. It's very useful value to show all groups.</p>
         
     | 
| 
       3453 
     | 
    
         
            -
            <p>Here is a negative < 
     | 
| 
      
 3453 
     | 
    
         
            +
            <p>Here is a negative <tt class="docutils literal"><span class="pre">drilldown_limit</span></tt> value example.</p>
         
     | 
| 
       3454 
3454 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3455 
3455 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3456 
3456 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -3523,19 +3523,19 @@ all groups. It's very useful value to show all groups.</p> 
     | 
|
| 
       3523 
3523 
     | 
    
         
             
            # ]
         
     | 
| 
       3524 
3524 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3525 
3525 
     | 
    
         
             
            </div>
         
     | 
| 
       3526 
     | 
    
         
            -
            <p>The < 
     | 
| 
       3527 
     | 
    
         
            -
            <p>The default value of < 
     | 
| 
      
 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>
         
     | 
| 
       3528 
3528 
     | 
    
         
             
            </div>
         
     | 
| 
       3529 
3529 
     | 
    
         
             
            <div class="section" id="drilldown-calc-types">
         
     | 
| 
       3530 
     | 
    
         
            -
            <span id="select-drilldown-calc-types"></span><h4>7.3. 
     | 
| 
       3531 
     | 
    
         
            -
            <p> 
     | 
| 
      
 3530 
     | 
    
         
            +
            <span id="select-drilldown-calc-types"></span><h4>7.3.33.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>
         
     | 
| 
      
 3531 
     | 
    
         
            +
            <p>Specifies how to calculate (aggregate) values in grouped records by
         
     | 
| 
       3532 
3532 
     | 
    
         
             
            a drilldown. You can specify multiple calculation types separated by
         
     | 
| 
       3533 
     | 
    
         
            -
            "< 
     | 
| 
      
 3533 
     | 
    
         
            +
            "<tt class="docutils literal"><span class="pre">,</span></tt>". For example, <tt class="docutils literal"><span class="pre">MAX,MIN</span></tt>.</p>
         
     | 
| 
       3534 
3534 
     | 
    
         
             
            <p>Calculation target values are read from a column of grouped
         
     | 
| 
       3535 
3535 
     | 
    
         
             
            records. The column is specified by
         
     | 
| 
       3536 
3536 
     | 
    
         
             
            <a class="reference internal" href="#select-drilldown-calc-target"><em>drilldown_calc_target</em></a>.</p>
         
     | 
| 
       3537 
3537 
     | 
    
         
             
            <p>You can read calculated value by <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> such
         
     | 
| 
       3538 
     | 
    
         
            -
            as < 
     | 
| 
      
 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>
         
     | 
| 
       3539 
3539 
     | 
    
         
             
            <p>You can use the following calculation types:</p>
         
     | 
| 
       3540 
3540 
     | 
    
         
             
            <table border="1" class="docutils">
         
     | 
| 
       3541 
3541 
     | 
    
         
             
            <colgroup>
         
     | 
| 
         @@ -3552,42 +3552,42 @@ as <code class="docutils literal"><span class="pre">_max</span></code> and <code 
     | 
|
| 
       3552 
3552 
     | 
    
         
             
            </tr>
         
     | 
| 
       3553 
3553 
     | 
    
         
             
            </thead>
         
     | 
| 
       3554 
3554 
     | 
    
         
             
            <tbody valign="top">
         
     | 
| 
       3555 
     | 
    
         
            -
            <tr class="row-even"><td>< 
     | 
| 
      
 3555 
     | 
    
         
            +
            <tr class="row-even"><td><tt class="docutils literal"><span class="pre">NONE</span></tt></td>
         
     | 
| 
       3556 
3556 
     | 
    
         
             
            <td>Nothing.</td>
         
     | 
| 
       3557 
3557 
     | 
    
         
             
            <td>Not needs.</td>
         
     | 
| 
       3558 
3558 
     | 
    
         
             
            <td>Just ignored.</td>
         
     | 
| 
       3559 
3559 
     | 
    
         
             
            </tr>
         
     | 
| 
       3560 
     | 
    
         
            -
            <tr class="row-odd"><td>< 
     | 
| 
       3561 
     | 
    
         
            -
            <td>< 
     | 
| 
      
 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>
         
     | 
| 
       3562 
3562 
     | 
    
         
             
            <td>Not needs.</td>
         
     | 
| 
       3563 
3563 
     | 
    
         
             
            <td>Counting grouped records. It's always enabled. So you don't
         
     | 
| 
       3564 
3564 
     | 
    
         
             
            specify it.</td>
         
     | 
| 
       3565 
3565 
     | 
    
         
             
            </tr>
         
     | 
| 
       3566 
     | 
    
         
            -
            <tr class="row-even"><td>< 
     | 
| 
       3567 
     | 
    
         
            -
            <td>< 
     | 
| 
      
 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>
         
     | 
| 
       3568 
3568 
     | 
    
         
             
            <td>Needs.</td>
         
     | 
| 
       3569 
3569 
     | 
    
         
             
            <td>Finding the maximum integer value from integer values in
         
     | 
| 
       3570 
3570 
     | 
    
         
             
            grouped records.</td>
         
     | 
| 
       3571 
3571 
     | 
    
         
             
            </tr>
         
     | 
| 
       3572 
     | 
    
         
            -
            <tr class="row-odd"><td>< 
     | 
| 
       3573 
     | 
    
         
            -
            <td>< 
     | 
| 
      
 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>
         
     | 
| 
       3574 
3574 
     | 
    
         
             
            <td>Needs.</td>
         
     | 
| 
       3575 
3575 
     | 
    
         
             
            <td>Finding the minimum integer value from integer values in
         
     | 
| 
       3576 
3576 
     | 
    
         
             
            grouped records.</td>
         
     | 
| 
       3577 
3577 
     | 
    
         
             
            </tr>
         
     | 
| 
       3578 
     | 
    
         
            -
            <tr class="row-even"><td>< 
     | 
| 
       3579 
     | 
    
         
            -
            <td>< 
     | 
| 
      
 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>
         
     | 
| 
       3580 
3580 
     | 
    
         
             
            <td>Needs.</td>
         
     | 
| 
       3581 
3581 
     | 
    
         
             
            <td>Summing integer values in grouped records.</td>
         
     | 
| 
       3582 
3582 
     | 
    
         
             
            </tr>
         
     | 
| 
       3583 
     | 
    
         
            -
            <tr class="row-odd"><td>< 
     | 
| 
       3584 
     | 
    
         
            -
            <td>< 
     | 
| 
      
 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>
         
     | 
| 
       3585 
3585 
     | 
    
         
             
            <td>Needs.</td>
         
     | 
| 
       3586 
3586 
     | 
    
         
             
            <td>Averaging integer/float values in grouped records.</td>
         
     | 
| 
       3587 
3587 
     | 
    
         
             
            </tr>
         
     | 
| 
       3588 
3588 
     | 
    
         
             
            </tbody>
         
     | 
| 
       3589 
3589 
     | 
    
         
             
            </table>
         
     | 
| 
       3590 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 3590 
     | 
    
         
            +
            <p>Here is a <tt class="docutils literal"><span class="pre">MAX</span></tt> example:</p>
         
     | 
| 
       3591 
3591 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3592 
3592 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3593 
3593 
     | 
    
         
             
              --limit -1 \
         
     | 
| 
         @@ -3696,12 +3696,12 @@ grouped records.</td> 
     | 
|
| 
       3696 
3696 
     | 
    
         
             
            # ]
         
     | 
| 
       3697 
3697 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3698 
3698 
     | 
    
         
             
            </div>
         
     | 
| 
       3699 
     | 
    
         
            -
            <p>The < 
     | 
| 
       3700 
     | 
    
         
            -
            finding the maximum < 
     | 
| 
       3701 
     | 
    
         
            -
            outputs pairs of grouped key and the maximum < 
     | 
| 
       3702 
     | 
    
         
            -
            for the group. It uses < 
     | 
| 
       3703 
     | 
    
         
            -
            read the maximum < 
     | 
| 
       3704 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 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>
         
     | 
| 
       3705 
3705 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3706 
3706 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3707 
3707 
     | 
    
         
             
              --limit -1 \
         
     | 
| 
         @@ -3810,12 +3810,12 @@ read the maximum <code class="docutils literal"><span class="pre">n_likes</span> 
     | 
|
| 
       3810 
3810 
     | 
    
         
             
            # ]
         
     | 
| 
       3811 
3811 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3812 
3812 
     | 
    
         
             
            </div>
         
     | 
| 
       3813 
     | 
    
         
            -
            <p>The < 
     | 
| 
       3814 
     | 
    
         
            -
            finding the minimum < 
     | 
| 
       3815 
     | 
    
         
            -
            outputs pairs of grouped key and the minimum < 
     | 
| 
       3816 
     | 
    
         
            -
            for the group. It uses < 
     | 
| 
       3817 
     | 
    
         
            -
            read the minimum < 
     | 
| 
       3818 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 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>
         
     | 
| 
       3819 
3819 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3820 
3820 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3821 
3821 
     | 
    
         
             
              --limit -1 \
         
     | 
| 
         @@ -3924,12 +3924,12 @@ read the minimum <code class="docutils literal"><span class="pre">n_likes</span> 
     | 
|
| 
       3924 
3924 
     | 
    
         
             
            # ]
         
     | 
| 
       3925 
3925 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3926 
3926 
     | 
    
         
             
            </div>
         
     | 
| 
       3927 
     | 
    
         
            -
            <p>The < 
     | 
| 
       3928 
     | 
    
         
            -
            sums all < 
     | 
| 
       3929 
     | 
    
         
            -
            of grouped key and the summed < 
     | 
| 
       3930 
     | 
    
         
            -
            group. It uses < 
     | 
| 
       3931 
     | 
    
         
            -
            summed < 
     | 
| 
       3932 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 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>
         
     | 
| 
       3933 
3933 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3934 
3934 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3935 
3935 
     | 
    
         
             
              --limit -1 \
         
     | 
| 
         @@ -4038,11 +4038,11 @@ summed <code class="docutils literal"><span class="pre">n_likes</span></code> co 
     | 
|
| 
       4038 
4038 
     | 
    
         
             
            # ]
         
     | 
| 
       4039 
4039 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4040 
4040 
     | 
    
         
             
            </div>
         
     | 
| 
       4041 
     | 
    
         
            -
            <p>The < 
     | 
| 
       4042 
     | 
    
         
            -
            averages all < 
     | 
| 
       4043 
     | 
    
         
            -
            pairs of grouped key and the averaged < 
     | 
| 
       4044 
     | 
    
         
            -
            the group. It uses < 
     | 
| 
       4045 
     | 
    
         
            -
            the averaged < 
     | 
| 
      
 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>
         
     | 
| 
       4046 
4046 
     | 
    
         
             
            <p>Here is an example that uses all calculation types:</p>
         
     | 
| 
       4047 
4047 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4048 
4048 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
         @@ -4180,35 +4180,35 @@ the averaged <code class="docutils literal"><span class="pre">n_likes</span></co 
     | 
|
| 
       4180 
4180 
     | 
    
         
             
            # ]
         
     | 
| 
       4181 
4181 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4182 
4182 
     | 
    
         
             
            </div>
         
     | 
| 
       4183 
     | 
    
         
            -
            <p>The < 
     | 
| 
       4184 
     | 
    
         
            -
            by "< 
     | 
| 
      
 4183 
     | 
    
         
            +
            <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command specifies multiple calculation types separated
         
     | 
| 
      
 4184 
     | 
    
         
            +
            by "<tt class="docutils literal"><span class="pre">,</span></tt>" 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>
         
     | 
| 
       4185 
4185 
     | 
    
         
             
            <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 < 
     | 
| 
       4187 
     | 
    
         
            -
            < 
     | 
| 
       4188 
     | 
    
         
            -
            <p>The default value of < 
     | 
| 
       4189 
     | 
    
         
            -
            that only < 
     | 
| 
       4190 
     | 
    
         
            -
            < 
     | 
| 
      
 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>
         
     | 
| 
       4191 
4191 
     | 
    
         
             
            </div>
         
     | 
| 
       4192 
4192 
     | 
    
         
             
            <div class="section" id="drilldown-calc-target">
         
     | 
| 
       4193 
     | 
    
         
            -
            <span id="select-drilldown-calc-target"></span><h4>7.3. 
     | 
| 
       4194 
     | 
    
         
            -
            <p> 
     | 
| 
      
 4193 
     | 
    
         
            +
            <span id="select-drilldown-calc-target"></span><h4>7.3.33.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>
         
     | 
| 
       4195 
4195 
     | 
    
         
             
            <p>If you specify a calculation type that needs a target column such as
         
     | 
| 
       4196 
     | 
    
         
            -
            < 
     | 
| 
       4197 
     | 
    
         
            -
            < 
     | 
| 
       4198 
     | 
    
         
            -
            <p>You can specify only one column name like < 
     | 
| 
       4199 
     | 
    
         
            -
            <span class="pre">n_likes</span></ 
     | 
| 
       4200 
     | 
    
         
            -
            < 
     | 
| 
      
 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>
         
     | 
| 
       4201 
4201 
     | 
    
         
             
            <p>You can use referenced value from the target record by combining
         
     | 
| 
       4202 
     | 
    
         
            -
            "< 
     | 
| 
       4203 
     | 
    
         
            -
            <span class="pre">reference_column.nested_reference_column.value</span></ 
     | 
| 
      
 4202 
     | 
    
         
            +
            "<tt class="docutils literal"><span class="pre">.</span></tt>" 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 
4204 
     | 
    
         
             
            <p>See <a class="reference internal" href="#select-drilldown-calc-types"><em>drilldown_calc_types</em></a> to know how to use
         
     | 
| 
       4205 
     | 
    
         
            -
            < 
     | 
| 
       4206 
     | 
    
         
            -
            <p>The default value of < 
     | 
| 
      
 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
         
     | 
| 
       4207 
4207 
     | 
    
         
             
            that no calculation target column is specified.</p>
         
     | 
| 
       4208 
4208 
     | 
    
         
             
            </div>
         
     | 
| 
       4209 
4209 
     | 
    
         
             
            </div>
         
     | 
| 
       4210 
4210 
     | 
    
         
             
            <div class="section" id="advanced-drilldown-related-parameters">
         
     | 
| 
       4211 
     | 
    
         
            -
            <span id="select-advanced-drilldown-related-parameters"></span><h3>7.3. 
     | 
| 
      
 4211 
     | 
    
         
            +
            <span id="select-advanced-drilldown-related-parameters"></span><h3>7.3.33.4.6. Advanced drilldown related parameters<a class="headerlink" href="#advanced-drilldown-related-parameters" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       4212 
4212 
     | 
    
         
             
            <p>You can get multiple drilldown results by specifying multiple group
         
     | 
| 
       4213 
4213 
     | 
    
         
             
            keys by <a class="reference internal" href="#select-drilldown"><em>drilldown</em></a>. But you need to use the same
         
     | 
| 
       4214 
4214 
     | 
    
         
             
            configuration for all drilldowns. For example,
         
     | 
| 
         @@ -4217,70 +4217,70 @@ configuration for all drilldowns. For example, 
     | 
|
| 
       4217 
4217 
     | 
    
         
             
            parameters:</p>
         
     | 
| 
       4218 
4218 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4219 
4219 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4220 
     | 
    
         
            -
            <li>< 
     | 
| 
       4221 
     | 
    
         
            -
            <li>< 
     | 
| 
       4222 
     | 
    
         
            -
            <li>< 
     | 
| 
       4223 
     | 
    
         
            -
            <li>< 
     | 
| 
       4224 
     | 
    
         
            -
            <li>< 
     | 
| 
       4225 
     | 
    
         
            -
            <li>< 
     | 
| 
       4226 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 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>
         
     | 
| 
       4227 
4227 
     | 
    
         
             
            </ul>
         
     | 
| 
       4228 
4228 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4229 
     | 
    
         
            -
            <p>< 
     | 
| 
       4230 
     | 
    
         
            -
            < 
     | 
| 
      
 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>
         
     | 
| 
       4231 
4231 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4232 
4232 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4233 
4233 
     | 
    
         
             
            <li>Alphabets</li>
         
     | 
| 
       4234 
4234 
     | 
    
         
             
            <li>Digits</li>
         
     | 
| 
       4235 
     | 
    
         
            -
            <li>< 
     | 
| 
       4236 
     | 
    
         
            -
            <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>
         
     | 
| 
       4237 
4237 
     | 
    
         
             
            </ul>
         
     | 
| 
       4238 
4238 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4239 
     | 
    
         
            -
            <p>Parameters that has the same < 
     | 
| 
      
 4239 
     | 
    
         
            +
            <p>Parameters that has the same <tt class="docutils literal"><span class="pre">${LABEL}</span></tt> value are grouped. Grouped
         
     | 
| 
       4240 
4240 
     | 
    
         
             
            parameters are used for one drilldown.</p>
         
     | 
| 
       4241 
4241 
     | 
    
         
             
            <p>For example, there are 2 groups for the following parameters:</p>
         
     | 
| 
       4242 
4242 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4243 
4243 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4244 
     | 
    
         
            -
            <li>< 
     | 
| 
       4245 
     | 
    
         
            -
            <li>< 
     | 
| 
       4246 
     | 
    
         
            -
            <li>< 
     | 
| 
       4247 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 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>
         
     | 
| 
       4248 
4248 
     | 
    
         
             
            </ul>
         
     | 
| 
       4249 
4249 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4250 
     | 
    
         
            -
            <p>< 
     | 
| 
       4251 
     | 
    
         
            -
            are grouped. < 
     | 
| 
       4252 
     | 
    
         
            -
            < 
     | 
| 
       4253 
     | 
    
         
            -
            <p>In < 
     | 
| 
      
 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>
         
     | 
| 
       4254 
4254 
     | 
    
         
             
            is used for output columns.</p>
         
     | 
| 
       4255 
     | 
    
         
            -
            <p>In < 
     | 
| 
       4256 
     | 
    
         
            -
            < 
     | 
| 
       4257 
     | 
    
         
            -
            <p>See document for corresponding < 
     | 
| 
      
 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
         
     | 
| 
       4258 
4258 
     | 
    
         
             
            to use it for the following parameters:</p>
         
     | 
| 
       4259 
4259 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4260 
4260 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4261 
     | 
    
         
            -
            <li>< 
     | 
| 
       4262 
     | 
    
         
            -
            <li>< 
     | 
| 
       4263 
     | 
    
         
            -
            <li>< 
     | 
| 
       4264 
     | 
    
         
            -
            <li>< 
     | 
| 
       4265 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 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>
         
     | 
| 
       4266 
4266 
     | 
    
         
             
            </ul>
         
     | 
| 
       4267 
4267 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4268 
4268 
     | 
    
         
             
            <p>The following parameters are needed more description:</p>
         
     | 
| 
       4269 
4269 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4270 
4270 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4271 
     | 
    
         
            -
            <li>< 
     | 
| 
       4272 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 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>
         
     | 
| 
       4273 
4273 
     | 
    
         
             
            </ul>
         
     | 
| 
       4274 
4274 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4275 
4275 
     | 
    
         
             
            <p>Output format is different a bit. It's also needed more description.</p>
         
     | 
| 
       4276 
4276 
     | 
    
         
             
            <div class="section" id="drilldown-label-keys">
         
     | 
| 
       4277 
     | 
    
         
            -
            <span id="select-drilldown-label-keys"></span><h4>7.3. 
     | 
| 
      
 4277 
     | 
    
         
            +
            <span id="select-drilldown-label-keys"></span><h4>7.3.33.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 
4278 
     | 
    
         
             
            <p><a class="reference internal" href="#select-drilldown"><em>drilldown</em></a> can specify multiple keys for multiple
         
     | 
| 
       4279 
4279 
     | 
    
         
             
            drilldowns. But it can't specify multiple keys for one drilldown.</p>
         
     | 
| 
       4280 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4280 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></tt> can't specify multiple keys for multiple
         
     | 
| 
       4281 
4281 
     | 
    
         
             
            drilldowns. But it can specify multiple keys for one drilldown.</p>
         
     | 
| 
       4282 
     | 
    
         
            -
            <p>You can specify multiple keys separated by "< 
     | 
| 
       4283 
     | 
    
         
            -
            <p>Here is an example to group by multiple keys, < 
     | 
| 
      
 4282 
     | 
    
         
            +
            <p>You can specify multiple keys separated by "<tt class="docutils literal"><span class="pre">,</span></tt>".</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>
         
     | 
| 
       4284 
4284 
     | 
    
         
             
            column values:</p>
         
     | 
| 
       4285 
4285 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4286 
4286 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
         @@ -4402,27 +4402,27 @@ column values:</p> 
     | 
|
| 
       4402 
4402 
     | 
    
         
             
            # ]
         
     | 
| 
       4403 
4403 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4404 
4404 
     | 
    
         
             
            </div>
         
     | 
| 
       4405 
     | 
    
         
            -
            <p>< 
     | 
| 
       4406 
     | 
    
         
            -
            group. You can refer grouped keys by < 
     | 
| 
       4407 
     | 
    
         
            -
            <a class="reference internal" href="#select-drilldown-label-output-columns"><em>drilldown[${LABEL}].output_columns</em></a>. < 
     | 
| 
       4408 
     | 
    
         
            -
            column name to be used by group key. < 
     | 
| 
       4409 
     | 
    
         
            -
            < 
     | 
| 
       4410 
     | 
    
         
            -
            <p>Note that you can't use < 
     | 
| 
       4411 
     | 
    
         
            -
            specify one key as < 
     | 
| 
       4412 
     | 
    
         
            -
            <span class="pre">tag</span></ 
     | 
| 
      
 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 
4413 
     | 
    
         
             
            <a class="reference internal" href="#select-drilldown-output-columns"><em>drilldown_output_columns</em></a>.</p>
         
     | 
| 
       4414 
4414 
     | 
    
         
             
            </div>
         
     | 
| 
       4415 
4415 
     | 
    
         
             
            <div class="section" id="drilldown-label-output-columns">
         
     | 
| 
       4416 
     | 
    
         
            -
            <span id="select-drilldown-label-output-columns"></span><h4>7.3. 
     | 
| 
      
 4416 
     | 
    
         
            +
            <span id="select-drilldown-label-output-columns"></span><h4>7.3.33.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 
4417 
     | 
    
         
             
            <p>It's almost same as <a class="reference internal" href="#select-drilldown-output-columns"><em>drilldown_output_columns</em></a>. The
         
     | 
| 
       4418 
4418 
     | 
    
         
             
            difference between <a class="reference internal" href="#select-drilldown-output-columns"><em>drilldown_output_columns</em></a> and
         
     | 
| 
       4419 
     | 
    
         
            -
            < 
     | 
| 
       4420 
     | 
    
         
            -
            <p><a class="reference internal" href="#select-drilldown-output-columns"><em>drilldown_output_columns</em></a> uses < 
     | 
| 
      
 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>
         
     | 
| 
       4421 
4421 
     | 
    
         
             
            <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to refer group
         
     | 
| 
       4422 
     | 
    
         
            -
            key. < 
     | 
| 
      
 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>
         
     | 
| 
       4423 
4423 
     | 
    
         
             
            <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to refer group key when you specify
         
     | 
| 
       4424 
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 < 
     | 
| 
      
 4425 
     | 
    
         
            +
            <p>Here is an example to refer single group key by <tt class="docutils literal"><span class="pre">_key</span></tt>
         
     | 
| 
       4426 
4426 
     | 
    
         
             
            <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a>:</p>
         
     | 
| 
       4427 
4427 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4428 
4428 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
         @@ -4501,13 +4501,13 @@ only one group key by <a class="reference internal" href="#select-drilldown-labe 
     | 
|
| 
       4501 
4501 
     | 
    
         
             
            # ]
         
     | 
| 
       4502 
4502 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4503 
4503 
     | 
    
         
             
            </div>
         
     | 
| 
       4504 
     | 
    
         
            -
            <p>But you can't refer each group key by < 
     | 
| 
      
 4504 
     | 
    
         
            +
            <p>But you can't refer each group key by <tt class="docutils literal"><span class="pre">_key</span></tt>
         
     | 
| 
       4505 
4505 
     | 
    
         
             
            <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> in
         
     | 
| 
       4506 
     | 
    
         
            -
            < 
     | 
| 
       4507 
     | 
    
         
            -
            < 
     | 
| 
      
 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 
4508 
     | 
    
         
             
            used for group key in <a class="reference internal" href="#select-drilldown-label-keys"><em>drilldown[${LABEL}].keys</em></a>.</p>
         
     | 
| 
       4509 
4509 
     | 
    
         
             
            <p>Here is an example to refer each group key in multiple group keys by
         
     | 
| 
       4510 
     | 
    
         
            -
            < 
     | 
| 
      
 4510 
     | 
    
         
            +
            <tt class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></tt> syntax:</p>
         
     | 
| 
       4511 
4511 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4512 
4512 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       4513 
4513 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -4587,23 +4587,23 @@ used for group key in <a class="reference internal" href="#select-drilldown-labe 
     | 
|
| 
       4587 
4587 
     | 
    
         
             
            </div>
         
     | 
| 
       4588 
4588 
     | 
    
         
             
            <div class="admonition tip">
         
     | 
| 
       4589 
4589 
     | 
    
         
             
            <p class="first admonition-title">Tip</p>
         
     | 
| 
       4590 
     | 
    
         
            -
            <p>Why < 
     | 
| 
      
 4590 
     | 
    
         
            +
            <p>Why <tt class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></tt> syntax?</p>
         
     | 
| 
       4591 
4591 
     | 
    
         
             
            <p>It's implementation specific information.</p>
         
     | 
| 
       4592 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4592 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">_key</span></tt> is a vector value. The vector value is consists of all
         
     | 
| 
       4593 
4593 
     | 
    
         
             
            group keys. You can see byte sequence of the vector value by
         
     | 
| 
       4594 
     | 
    
         
            -
            referring < 
     | 
| 
       4595 
     | 
    
         
            -
            <p>There is one grouped record in < 
     | 
| 
      
 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
         
     | 
| 
       4596 
4596 
     | 
    
         
             
            values when you specify multiple group keys to
         
     | 
| 
       4597 
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 < 
     | 
| 
       4599 
     | 
    
         
            -
            <p class="last">On the other hand, there is no grouped record in < 
     | 
| 
      
 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
         
     | 
| 
       4600 
4600 
     | 
    
         
             
            you specify only one group key to
         
     | 
| 
       4601 
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 
     | 
    
         
            -
            < 
     | 
| 
      
 4602 
     | 
    
         
            +
            <tt class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></tt> syntax.</p>
         
     | 
| 
       4603 
4603 
     | 
    
         
             
            </div>
         
     | 
| 
       4604 
4604 
     | 
    
         
             
            </div>
         
     | 
| 
       4605 
4605 
     | 
    
         
             
            <div class="section" id="output-format-for-drilldown-label-style">
         
     | 
| 
       4606 
     | 
    
         
            -
            <span id="select-drilldown-label-output-format"></span><h4>7.3. 
     | 
| 
      
 4606 
     | 
    
         
            +
            <span id="select-drilldown-label-output-format"></span><h4>7.3.33.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 
4607 
     | 
    
         
             
            <p>There is a difference in output format between <a class="reference internal" href="#select-drilldown"><em>drilldown</em></a>
         
     | 
| 
       4608 
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
         
     | 
| 
       4609 
4609 
     | 
    
         
             
            array to output multiple drilldown results.
         
     | 
| 
         @@ -4638,46 +4638,46 @@ result.</p> 
     | 
|
| 
       4638 
4638 
     | 
    
         
             
            </div>
         
     | 
| 
       4639 
4639 
     | 
    
         
             
            </div>
         
     | 
| 
       4640 
4640 
     | 
    
         
             
            <div class="section" id="cache-related-parameter">
         
     | 
| 
       4641 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
      
 4641 
     | 
    
         
            +
            <h3>7.3.33.4.7. Cache related parameter<a class="headerlink" href="#cache-related-parameter" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       4642 
4642 
     | 
    
         
             
            <div class="section" id="cache">
         
     | 
| 
       4643 
     | 
    
         
            -
            <h4>7.3. 
     | 
| 
      
 4643 
     | 
    
         
            +
            <h4>7.3.33.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 
4644 
     | 
    
         
             
            <p>TODO: write in English and add example.</p>
         
     | 
| 
       4645 
4645 
     | 
    
         
             
            <p>クエリキャッシュに関する動作を設定します。</p>
         
     | 
| 
       4646 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4646 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">no</span></tt></p>
         
     | 
| 
       4647 
4647 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4648 
4648 
     | 
    
         
             
            <div>検索結果をクエリキャッシュに残しません。キャッシュして再利用される可能性が低いクエリに対して用います。キャッシュ容量は有限です。有効なキャッシュが多くヒットするために、このパラメータは有効です。</div></blockquote>
         
     | 
| 
       4649 
4649 
     | 
    
         
             
            </div>
         
     | 
| 
       4650 
4650 
     | 
    
         
             
            </div>
         
     | 
| 
       4651 
4651 
     | 
    
         
             
            <div class="section" id="score-related-parameters">
         
     | 
| 
       4652 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
       4653 
     | 
    
         
            -
            <p>There is a score related parameter, < 
     | 
| 
      
 4652 
     | 
    
         
            +
            <h3>7.3.33.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>
         
     | 
| 
       4654 
4654 
     | 
    
         
             
            <div class="section" id="adjuster">
         
     | 
| 
       4655 
     | 
    
         
            -
            <span id="select-adjuster"></span><h4>7.3. 
     | 
| 
       4656 
     | 
    
         
            -
            <p> 
     | 
| 
       4657 
     | 
    
         
            -
            < 
     | 
| 
      
 4655 
     | 
    
         
            +
            <span id="select-adjuster"></span><h4>7.3.33.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>
         
     | 
| 
      
 4656 
     | 
    
         
            +
            <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
         
     | 
| 
       4658 
4658 
     | 
    
         
             
            with not searched request.</p>
         
     | 
| 
       4659 
     | 
    
         
            -
            <p>You can increase score of specific records by < 
     | 
| 
       4660 
     | 
    
         
            -
            use < 
     | 
| 
       4661 
     | 
    
         
            -
            <p>For example, you can use < 
     | 
| 
       4662 
     | 
    
         
            -
            that have < 
     | 
| 
      
 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>
         
     | 
| 
       4663 
4663 
     | 
    
         
             
            <p>Here is the syntax:</p>
         
     | 
| 
       4664 
4664 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>--adjuster "SCORE_ADJUST_EXPRESSION1 + SCORE_ADJUST_EXPRESSION2 + ..."
         
     | 
| 
       4665 
4665 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4666 
4666 
     | 
    
         
             
            </div>
         
     | 
| 
       4667 
     | 
    
         
            -
            <p>Here is the < 
     | 
| 
      
 4667 
     | 
    
         
            +
            <p>Here is the <tt class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></tt> syntax:</p>
         
     | 
| 
       4668 
4668 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>COLUMN @ "KEYWORD" * FACTOR
         
     | 
| 
       4669 
4669 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4670 
4670 
     | 
    
         
             
            </div>
         
     | 
| 
       4671 
4671 
     | 
    
         
             
            <p>Note the following:</p>
         
     | 
| 
       4672 
4672 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4673 
4673 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4674 
     | 
    
         
            -
            <li>< 
     | 
| 
       4675 
     | 
    
         
            -
            <li>< 
     | 
| 
       4676 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 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">"KEYWORD"</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>
         
     | 
| 
       4677 
4677 
     | 
    
         
             
            </ul>
         
     | 
| 
       4678 
4678 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4679 
     | 
    
         
            -
            <p>Here is a sample < 
     | 
| 
       4680 
     | 
    
         
            -
            < 
     | 
| 
      
 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>
         
     | 
| 
       4681 
4681 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4682 
4682 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       4683 
4683 
     | 
    
         
             
              --filter true \
         
     | 
| 
         @@ -4738,13 +4738,13 @@ that have <code class="docutils literal"><span class="pre">groonga</span></code> 
     | 
|
| 
       4738 
4738 
     | 
    
         
             
            # ]
         
     | 
| 
       4739 
4739 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4740 
4740 
     | 
    
         
             
            </div>
         
     | 
| 
       4741 
     | 
    
         
            -
            <p>The < 
     | 
| 
       4742 
     | 
    
         
            -
            < 
     | 
| 
       4743 
     | 
    
         
            -
            < 
     | 
| 
       4744 
     | 
    
         
            -
            record that has < 
     | 
| 
       4745 
     | 
    
         
            -
            record that its key is < 
     | 
| 
       4746 
     | 
    
         
            -
            <p>You can omit < 
     | 
| 
       4747 
     | 
    
         
            -
            <p>Here is a sample < 
     | 
| 
      
 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">"groonga"</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">"groonga"</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">"Groonga"</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>
         
     | 
| 
       4748 
4748 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4749 
4749 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       4750 
4750 
     | 
    
         
             
              --filter true \
         
     | 
| 
         @@ -4805,12 +4805,12 @@ record that its key is <code class="docutils literal"><span class="pre">"Gr 
     | 
|
| 
       4805 
4805 
     | 
    
         
             
            # ]
         
     | 
| 
       4806 
4806 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4807 
4807 
     | 
    
         
             
            </div>
         
     | 
| 
       4808 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 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
         
     | 
| 
       4809 
4809 
     | 
    
         
             
            the factor is treated as 1. There is only one record that has
         
     | 
| 
       4810 
     | 
    
         
            -
            < 
     | 
| 
       4811 
     | 
    
         
            -
            key is < 
     | 
| 
       4812 
     | 
    
         
            -
            <p>Here is a sample < 
     | 
| 
       4813 
     | 
    
         
            -
            < 
     | 
| 
      
 4810 
     | 
    
         
            +
            <tt class="docutils literal"><span class="pre">"groonga"</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">"Groonga"</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>
         
     | 
| 
       4814 
4814 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4815 
4815 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       4816 
4816 
     | 
    
         
             
              --filter true \
         
     | 
| 
         @@ -4871,83 +4871,83 @@ key is <code class="docutils literal"><span class="pre">"Groonga"</spa 
     | 
|
| 
       4871 
4871 
     | 
    
         
             
            # ]
         
     | 
| 
       4872 
4872 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4873 
4873 
     | 
    
         
             
            </div>
         
     | 
| 
       4874 
     | 
    
         
            -
            <p>The < 
     | 
| 
       4875 
     | 
    
         
            -
            < 
     | 
| 
       4876 
     | 
    
         
            -
            scores of these < 
     | 
| 
       4877 
     | 
    
         
            -
            < 
     | 
| 
       4878 
     | 
    
         
            -
            a record that its key is < 
     | 
| 
       4879 
     | 
    
         
            -
            of the record is sum of scores of all < 
     | 
| 
       4880 
     | 
    
         
            -
            <p>The first < 
     | 
| 
      
 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">"Groonga"</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">@</span> <span class="pre">"groonga"</span> <span class="pre">*</span> <span class="pre">5</span></tt>.
         
     | 
| 
       4881 
4881 
     | 
    
         
             
            It increases score by 5.</p>
         
     | 
| 
       4882 
     | 
    
         
            -
            <p>The second < 
     | 
| 
      
 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">@</span> <span class="pre">"started"</span> <span class="pre">*</span> <span class="pre">3</span></tt>.
         
     | 
| 
       4883 
4883 
     | 
    
         
             
            It increases score by 3.</p>
         
     | 
| 
       4884 
     | 
    
         
            -
            <p>The final increased score is 9 (< 
     | 
| 
       4885 
     | 
    
         
            -
            <p>A < 
     | 
| 
       4886 
     | 
    
         
            -
            means that increased scores of all records that has < 
     | 
| 
      
 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">"KEYWORD"</span></tt>. This
         
     | 
| 
      
 4886 
     | 
    
         
            +
            means that increased scores of all records that has <tt class="docutils literal"><span class="pre">"KEYWORD"</span></tt> are
         
     | 
| 
       4887 
4887 
     | 
    
         
             
            the same value. You can change increase score for each record that has
         
     | 
| 
       4888 
     | 
    
         
            -
            the same < 
     | 
| 
      
 4888 
     | 
    
         
            +
            the same <tt class="docutils literal"><span class="pre">"KEYWORD"</span></tt>. It is useful to tune search score. See
         
     | 
| 
       4889 
4889 
     | 
    
         
             
            <a class="reference internal" href="../columns/vector.html#weight-vector-column"><em>Weight vector column</em></a> for details.</p>
         
     | 
| 
       4890 
4890 
     | 
    
         
             
            </div>
         
     | 
| 
       4891 
4891 
     | 
    
         
             
            </div>
         
     | 
| 
       4892 
4892 
     | 
    
         
             
            </div>
         
     | 
| 
       4893 
4893 
     | 
    
         
             
            <div class="section" id="id7">
         
     | 
| 
       4894 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
      
 4894 
     | 
    
         
            +
            <h2>7.3.33.5. 返値<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
       4895 
4895 
     | 
    
         
             
            <p>TODO: write in English and add example.</p>
         
     | 
| 
       4896 
4896 
     | 
    
         
             
            <p>以下のようなjson形式で値が返却されます。</p>
         
     | 
| 
       4897 
4897 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>[[リターンコード, 処理開始時間, 処理時間], [検索結果, ドリルダウン結果]]
         
     | 
| 
       4898 
4898 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4899 
4899 
     | 
    
         
             
            </div>
         
     | 
| 
       4900 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4900 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">リターンコード</span></tt></p>
         
     | 
| 
       4901 
4901 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4902 
4902 
     | 
    
         
             
            <div>grn_rcに対応する数値が返されます。0(GRN_SUCCESS)以外の場合は、続いてエラー内容を示す
         
     | 
| 
       4903 
4903 
     | 
    
         
             
            文字列が返されます。</div></blockquote>
         
     | 
| 
       4904 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4904 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">処理開始時間</span></tt></p>
         
     | 
| 
       4905 
4905 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4906 
4906 
     | 
    
         
             
            <div>処理を開始した時間について、1970年1月1日0時0分0秒を起点とした秒数を小数で返します。</div></blockquote>
         
     | 
| 
       4907 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4907 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">処理時間</span></tt></p>
         
     | 
| 
       4908 
4908 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4909 
4909 
     | 
    
         
             
            <div>処理にかかった秒数を返します。</div></blockquote>
         
     | 
| 
       4910 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4910 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">検索結果</span></tt></p>
         
     | 
| 
       4911 
4911 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4912 
4912 
     | 
    
         
             
            <div><p>drilldown条件が実行される前の検索結果が以下のように出力されます。:</p>
         
     | 
| 
       4913 
4913 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>[[ヒット数], [[カラム名1,カラム型1],..], 検索結果1,..]
         
     | 
| 
       4914 
4914 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4915 
4915 
     | 
    
         
             
            </div>
         
     | 
| 
       4916 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4916 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">ヒット数</span></tt></p>
         
     | 
| 
       4917 
4917 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4918 
     | 
    
         
            -
            <div>検索条件にヒットしたレコードの数が出力されます。 < 
     | 
| 
       4919 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 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 
4920 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4921 
4921 
     | 
    
         
             
            <div>output_columnsに指定された条件に従って、対象となるカラム名が出力されます。</div></blockquote>
         
     | 
| 
       4922 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4922 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">カラム型n</span></tt></p>
         
     | 
| 
       4923 
4923 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4924 
4924 
     | 
    
         
             
            <div>output_columnsに指定された条件に従って、対象となるカラム型が出力されます。</div></blockquote>
         
     | 
| 
       4925 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4925 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">検索結果n</span></tt></p>
         
     | 
| 
       4926 
4926 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4927 
4927 
     | 
    
         
             
            <div>output_columns, offset, limitによって指定された条件に従って各レコードの値が出力されます。</div></blockquote>
         
     | 
| 
       4928 
4928 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4929 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4929 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">drilldown結果</span></tt></p>
         
     | 
| 
       4930 
4930 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4931 
4931 
     | 
    
         
             
            <div><p>drilldown処理の結果が以下のように出力されます。:</p>
         
     | 
| 
       4932 
4932 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>[[[件数], [[カラム名1,カラム型1],..], 検索結果1,..],..]
         
     | 
| 
       4933 
4933 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4934 
4934 
     | 
    
         
             
            </div>
         
     | 
| 
       4935 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4935 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">件数</span></tt></p>
         
     | 
| 
       4936 
4936 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4937 
4937 
     | 
    
         
             
            <div>drilldownに指定されたカラムの値の異なり数が出力されます。</div></blockquote>
         
     | 
| 
       4938 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4938 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">カラム名n</span></tt></p>
         
     | 
| 
       4939 
4939 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4940 
4940 
     | 
    
         
             
            <div>drilldown_output_columnsに指定された条件に従って、対象となるカラム名が出力されます。</div></blockquote>
         
     | 
| 
       4941 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4941 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">カラム型n</span></tt></p>
         
     | 
| 
       4942 
4942 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4943 
4943 
     | 
    
         
             
            <div>drilldown_output_columnsに指定された条件に従って、対象となるカラム型が出力されます。</div></blockquote>
         
     | 
| 
       4944 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4944 
     | 
    
         
            +
            <p><tt class="docutils literal"><span class="pre">ドリルダウン結果n</span></tt></p>
         
     | 
| 
       4945 
4945 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4946 
4946 
     | 
    
         
             
            <div>drilldown_output_columns, drilldown_offset, drilldown_limitによって指定された条件に従って各レコードの値が出力されます。</div></blockquote>
         
     | 
| 
       4947 
4947 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4948 
4948 
     | 
    
         
             
            </div>
         
     | 
| 
       4949 
4949 
     | 
    
         
             
            <div class="section" id="see-also">
         
     | 
| 
       4950 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
      
 4950 
     | 
    
         
            +
            <h2>7.3.33.6. See also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
       4951 
4951 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4952 
4952 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4953 
4953 
     | 
    
         
             
            <li><a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a></li>
         
     | 
| 
         @@ -4961,97 +4961,95 @@ the same <code class="docutils literal"><span class="pre">"KEYWORD"</s 
     | 
|
| 
       4961 
4961 
     | 
    
         
             
                      </div>
         
     | 
| 
       4962 
4962 
     | 
    
         
             
                    </div>
         
     | 
| 
       4963 
4963 
     | 
    
         
             
                  </div>
         
     | 
| 
       4964 
     | 
    
         
            -
                  <div class="sphinxsidebar" 
     | 
| 
      
 4964 
     | 
    
         
            +
                  <div class="sphinxsidebar">
         
     | 
| 
       4965 
4965 
     | 
    
         
             
                    <div class="sphinxsidebarwrapper">
         
     | 
| 
       4966 
4966 
     | 
    
         
             
              <h3><a href="../../index.html">Table Of Contents</a></h3>
         
     | 
| 
       4967 
4967 
     | 
    
         
             
              <ul>
         
     | 
| 
       4968 
     | 
    
         
            -
            <li><a class="reference internal" href="#">7.3. 
     | 
| 
       4969 
     | 
    
         
            -
            <li><a class="reference internal" href="#summary">7.3. 
     | 
| 
       4970 
     | 
    
         
            -
            <li><a class="reference internal" href="#syntax">7.3. 
     | 
| 
       4971 
     | 
    
         
            -
            <li><a class="reference internal" href="#usage">7.3. 
     | 
| 
       4972 
     | 
    
         
            -
            <li><a class="reference internal" href="#simple-usage">7.3. 
     | 
| 
       4973 
     | 
    
         
            -
            <li><a class="reference internal" href="#search-conditions">7.3. 
     | 
| 
       4974 
     | 
    
         
            -
            <li><a class="reference internal" href="#search-condition-query">7.3. 
     | 
| 
       4975 
     | 
    
         
            -
            <li><a class="reference internal" href="#search-condition-filter">7.3. 
     | 
| 
      
 4968 
     | 
    
         
            +
            <li><a class="reference internal" href="#">7.3.33. <tt class="docutils literal"><span class="pre">select</span></tt></a><ul>
         
     | 
| 
      
 4969 
     | 
    
         
            +
            <li><a class="reference internal" href="#summary">7.3.33.1. Summary</a></li>
         
     | 
| 
      
 4970 
     | 
    
         
            +
            <li><a class="reference internal" href="#syntax">7.3.33.2. Syntax</a></li>
         
     | 
| 
      
 4971 
     | 
    
         
            +
            <li><a class="reference internal" href="#usage">7.3.33.3. Usage</a><ul>
         
     | 
| 
      
 4972 
     | 
    
         
            +
            <li><a class="reference internal" href="#simple-usage">7.3.33.3.1. Simple usage</a></li>
         
     | 
| 
      
 4973 
     | 
    
         
            +
            <li><a class="reference internal" href="#search-conditions">7.3.33.3.2. Search conditions</a><ul>
         
     | 
| 
      
 4974 
     | 
    
         
            +
            <li><a class="reference internal" href="#search-condition-query">7.3.33.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.33.3.2.2. Search condition: <tt class="docutils literal"><span class="pre">filter</span></tt></a></li>
         
     | 
| 
       4976 
4976 
     | 
    
         
             
            </ul>
         
     | 
| 
       4977 
4977 
     | 
    
         
             
            </li>
         
     | 
| 
       4978 
     | 
    
         
            -
            <li><a class="reference internal" href="#paging">7.3. 
     | 
| 
       4979 
     | 
    
         
            -
            <li><a class="reference internal" href="#the-total-number-of-records">7.3. 
     | 
| 
       4980 
     | 
    
         
            -
            <li><a class="reference internal" href="#drilldown">7.3. 
     | 
| 
      
 4978 
     | 
    
         
            +
            <li><a class="reference internal" href="#paging">7.3.33.3.3. Paging</a></li>
         
     | 
| 
      
 4979 
     | 
    
         
            +
            <li><a class="reference internal" href="#the-total-number-of-records">7.3.33.3.4. The total number of records</a></li>
         
     | 
| 
      
 4980 
     | 
    
         
            +
            <li><a class="reference internal" href="#drilldown">7.3.33.3.5. Drilldown</a></li>
         
     | 
| 
       4981 
4981 
     | 
    
         
             
            </ul>
         
     | 
| 
       4982 
4982 
     | 
    
         
             
            </li>
         
     | 
| 
       4983 
     | 
    
         
            -
            <li><a class="reference internal" href="#parameters">7.3. 
     | 
| 
       4984 
     | 
    
         
            -
            <li><a class="reference internal" href="#required-parameter">7.3. 
     | 
| 
       4985 
     | 
    
         
            -
            <li><a class="reference internal" href="#table">7.3. 
     | 
| 
      
 4983 
     | 
    
         
            +
            <li><a class="reference internal" href="#parameters">7.3.33.4. Parameters</a><ul>
         
     | 
| 
      
 4984 
     | 
    
         
            +
            <li><a class="reference internal" href="#required-parameter">7.3.33.4.1. Required parameter</a><ul>
         
     | 
| 
      
 4985 
     | 
    
         
            +
            <li><a class="reference internal" href="#table">7.3.33.4.1.1. <tt class="docutils literal"><span class="pre">table</span></tt></a></li>
         
     | 
| 
       4986 
4986 
     | 
    
         
             
            </ul>
         
     | 
| 
       4987 
4987 
     | 
    
         
             
            </li>
         
     | 
| 
       4988 
     | 
    
         
            -
            <li><a class="reference internal" href="#search-related-parameters">7.3. 
     | 
| 
       4989 
     | 
    
         
            -
            <li><a class="reference internal" href="#match-columns">7.3. 
     | 
| 
       4990 
     | 
    
         
            -
            <li><a class="reference internal" href="#query">7.3. 
     | 
| 
       4991 
     | 
    
         
            -
            <li><a class="reference internal" href="#filter">7.3. 
     | 
| 
      
 4988 
     | 
    
         
            +
            <li><a class="reference internal" href="#search-related-parameters">7.3.33.4.2. Search related parameters</a><ul>
         
     | 
| 
      
 4989 
     | 
    
         
            +
            <li><a class="reference internal" href="#match-columns">7.3.33.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.33.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.33.4.2.3. <tt class="docutils literal"><span class="pre">filter</span></tt></a></li>
         
     | 
| 
       4992 
4992 
     | 
    
         
             
            </ul>
         
     | 
| 
       4993 
4993 
     | 
    
         
             
            </li>
         
     | 
| 
       4994 
     | 
    
         
            -
            <li><a class="reference internal" href="#advanced-search-parameters">7.3. 
     | 
| 
       4995 
     | 
    
         
            -
            <li><a class="reference internal" href="#match-escalation-threshold">7.3. 
     | 
| 
       4996 
     | 
    
         
            -
            <li><a class="reference internal" href="#query-expansion">7.3. 
     | 
| 
       4997 
     | 
    
         
            -
            <li><a class="reference internal" href="#query-flags">7.3. 
     | 
| 
       4998 
     | 
    
         
            -
            <li><a class="reference internal" href="#query-expander">7.3. 
     | 
| 
      
 4994 
     | 
    
         
            +
            <li><a class="reference internal" href="#advanced-search-parameters">7.3.33.4.3. Advanced search parameters</a><ul>
         
     | 
| 
      
 4995 
     | 
    
         
            +
            <li><a class="reference internal" href="#match-escalation-threshold">7.3.33.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.33.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.33.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.33.4.3.4. <tt class="docutils literal"><span class="pre">query_expander</span></tt></a></li>
         
     | 
| 
       4999 
4999 
     | 
    
         
             
            </ul>
         
     | 
| 
       5000 
5000 
     | 
    
         
             
            </li>
         
     | 
| 
       5001 
     | 
    
         
            -
            <li><a class="reference internal" href="#output-related-parameters">7.3. 
     | 
| 
       5002 
     | 
    
         
            -
            <li><a class="reference internal" href="#output-columns">7.3. 
     | 
| 
       5003 
     | 
    
         
            -
            <li><a class="reference internal" href="#sortby">7.3. 
     | 
| 
       5004 
     | 
    
         
            -
            <li><a class="reference internal" href="#offset">7.3. 
     | 
| 
       5005 
     | 
    
         
            -
            <li><a class="reference internal" href="#limit">7.3. 
     | 
| 
       5006 
     | 
    
         
            -
            <li><a class="reference internal" href="#scorer">7.3. 
     | 
| 
      
 5001 
     | 
    
         
            +
            <li><a class="reference internal" href="#output-related-parameters">7.3.33.4.4. Output related parameters</a><ul>
         
     | 
| 
      
 5002 
     | 
    
         
            +
            <li><a class="reference internal" href="#output-columns">7.3.33.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.33.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.33.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.33.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.33.4.4.5. <tt class="docutils literal"><span class="pre">scorer</span></tt></a></li>
         
     | 
| 
       5007 
5007 
     | 
    
         
             
            </ul>
         
     | 
| 
       5008 
5008 
     | 
    
         
             
            </li>
         
     | 
| 
       5009 
     | 
    
         
            -
            <li><a class="reference internal" href="#drilldown-related-parameters">7.3. 
     | 
| 
       5010 
     | 
    
         
            -
            <li><a class="reference internal" href="#select-drilldown">7.3. 
     | 
| 
       5011 
     | 
    
         
            -
            <li><a class="reference internal" href="#drilldown-sortby">7.3. 
     | 
| 
       5012 
     | 
    
         
            -
            <li><a class="reference internal" href="#drilldown-output-columns">7.3. 
     | 
| 
       5013 
     | 
    
         
            -
            <li><a class="reference internal" href="#drilldown-offset">7.3. 
     | 
| 
       5014 
     | 
    
         
            -
            <li><a class="reference internal" href="#drilldown-limit">7.3. 
     | 
| 
       5015 
     | 
    
         
            -
            <li><a class="reference internal" href="#drilldown-calc-types">7.3. 
     | 
| 
       5016 
     | 
    
         
            -
            <li><a class="reference internal" href="#drilldown-calc-target">7.3. 
     | 
| 
      
 5009 
     | 
    
         
            +
            <li><a class="reference internal" href="#drilldown-related-parameters">7.3.33.4.5. Drilldown related parameters</a><ul>
         
     | 
| 
      
 5010 
     | 
    
         
            +
            <li><a class="reference internal" href="#select-drilldown">7.3.33.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.33.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.33.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.33.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.33.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.33.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.33.4.5.7. <tt class="docutils literal"><span class="pre">drilldown_calc_target</span></tt></a></li>
         
     | 
| 
       5017 
5017 
     | 
    
         
             
            </ul>
         
     | 
| 
       5018 
5018 
     | 
    
         
             
            </li>
         
     | 
| 
       5019 
     | 
    
         
            -
            <li><a class="reference internal" href="#advanced-drilldown-related-parameters">7.3. 
     | 
| 
       5020 
     | 
    
         
            -
            <li><a class="reference internal" href="#drilldown-label-keys">7.3. 
     | 
| 
       5021 
     | 
    
         
            -
            <li><a class="reference internal" href="#drilldown-label-output-columns">7.3. 
     | 
| 
       5022 
     | 
    
         
            -
            <li><a class="reference internal" href="#output-format-for-drilldown-label-style">7.3. 
     | 
| 
      
 5019 
     | 
    
         
            +
            <li><a class="reference internal" href="#advanced-drilldown-related-parameters">7.3.33.4.6. Advanced drilldown related parameters</a><ul>
         
     | 
| 
      
 5020 
     | 
    
         
            +
            <li><a class="reference internal" href="#drilldown-label-keys">7.3.33.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.33.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.33.4.6.3. Output format for <tt class="docutils literal"><span class="pre">drilldown[${LABEL}]</span></tt> style</a></li>
         
     | 
| 
       5023 
5023 
     | 
    
         
             
            </ul>
         
     | 
| 
       5024 
5024 
     | 
    
         
             
            </li>
         
     | 
| 
       5025 
     | 
    
         
            -
            <li><a class="reference internal" href="#cache-related-parameter">7.3. 
     | 
| 
       5026 
     | 
    
         
            -
            <li><a class="reference internal" href="#cache">7.3. 
     | 
| 
      
 5025 
     | 
    
         
            +
            <li><a class="reference internal" href="#cache-related-parameter">7.3.33.4.7. Cache related parameter</a><ul>
         
     | 
| 
      
 5026 
     | 
    
         
            +
            <li><a class="reference internal" href="#cache">7.3.33.4.7.1. <tt class="docutils literal"><span class="pre">cache</span></tt></a></li>
         
     | 
| 
       5027 
5027 
     | 
    
         
             
            </ul>
         
     | 
| 
       5028 
5028 
     | 
    
         
             
            </li>
         
     | 
| 
       5029 
     | 
    
         
            -
            <li><a class="reference internal" href="#score-related-parameters">7.3. 
     | 
| 
       5030 
     | 
    
         
            -
            <li><a class="reference internal" href="#adjuster">7.3. 
     | 
| 
      
 5029 
     | 
    
         
            +
            <li><a class="reference internal" href="#score-related-parameters">7.3.33.4.8. Score related parameters</a><ul>
         
     | 
| 
      
 5030 
     | 
    
         
            +
            <li><a class="reference internal" href="#adjuster">7.3.33.4.8.1. <tt class="docutils literal"><span class="pre">adjuster</span></tt></a></li>
         
     | 
| 
       5031 
5031 
     | 
    
         
             
            </ul>
         
     | 
| 
       5032 
5032 
     | 
    
         
             
            </li>
         
     | 
| 
       5033 
5033 
     | 
    
         
             
            </ul>
         
     | 
| 
       5034 
5034 
     | 
    
         
             
            </li>
         
     | 
| 
       5035 
     | 
    
         
            -
            <li><a class="reference internal" href="#id7">7.3. 
     | 
| 
       5036 
     | 
    
         
            -
            <li><a class="reference internal" href="#see-also">7.3. 
     | 
| 
      
 5035 
     | 
    
         
            +
            <li><a class="reference internal" href="#id7">7.3.33.5. 返値</a></li>
         
     | 
| 
      
 5036 
     | 
    
         
            +
            <li><a class="reference internal" href="#see-also">7.3.33.6. See also</a></li>
         
     | 
| 
       5037 
5037 
     | 
    
         
             
            </ul>
         
     | 
| 
       5038 
5038 
     | 
    
         
             
            </li>
         
     | 
| 
       5039 
5039 
     | 
    
         
             
            </ul>
         
     | 
| 
       5040 
5040 
     | 
    
         | 
| 
       5041 
5041 
     | 
    
         
             
              <h4>Previous topic</h4>
         
     | 
| 
       5042 
5042 
     | 
    
         
             
              <p class="topless"><a href="ruby_load.html"
         
     | 
| 
       5043 
     | 
    
         
            -
                                    title="previous chapter">7.3. 
     | 
| 
      
 5043 
     | 
    
         
            +
                                    title="previous chapter">7.3.32. <tt class="docutils literal"><span class="pre">ruby_load</span></tt></a></p>
         
     | 
| 
       5044 
5044 
     | 
    
         
             
              <h4>Next topic</h4>
         
     | 
| 
       5045 
5045 
     | 
    
         
             
              <p class="topless"><a href="shutdown.html"
         
     | 
| 
       5046 
     | 
    
         
            -
                                    title="next chapter">7.3. 
     | 
| 
       5047 
     | 
    
         
            -
              < 
     | 
| 
       5048 
     | 
    
         
            -
             
     | 
| 
       5049 
     | 
    
         
            -
                < 
     | 
| 
       5050 
     | 
    
         
            -
             
     | 
| 
       5051 
     | 
    
         
            -
             
     | 
| 
       5052 
     | 
    
         
            -
             
     | 
| 
       5053 
     | 
    
         
            -
               </div>
         
     | 
| 
       5054 
     | 
    
         
            -
            <div id="searchbox" style="display: none" role="search">
         
     | 
| 
      
 5046 
     | 
    
         
            +
                                    title="next chapter">7.3.34. <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">
         
     | 
| 
       5055 
5053 
     | 
    
         
             
              <h3>Quick search</h3>
         
     | 
| 
       5056 
5054 
     | 
    
         
             
                <form class="search" action="../../search.html" method="get">
         
     | 
| 
       5057 
5055 
     | 
    
         
             
                  <input type="text" name="q" />
         
     | 
| 
         @@ -5068,24 +5066,24 @@ the same <code class="docutils literal"><span class="pre">"KEYWORD"</s 
     | 
|
| 
       5068 
5066 
     | 
    
         
             
                  </div>
         
     | 
| 
       5069 
5067 
     | 
    
         
             
                  <div class="clearer"></div>
         
     | 
| 
       5070 
5068 
     | 
    
         
             
                </div>
         
     | 
| 
       5071 
     | 
    
         
            -
                <div class="related" 
     | 
| 
      
 5069 
     | 
    
         
            +
                <div class="related">
         
     | 
| 
       5072 
5070 
     | 
    
         
             
                  <h3>Navigation</h3>
         
     | 
| 
       5073 
5071 
     | 
    
         
             
                  <ul>
         
     | 
| 
       5074 
5072 
     | 
    
         
             
                    <li class="right" style="margin-right: 10px">
         
     | 
| 
       5075 
5073 
     | 
    
         
             
                      <a href="../../genindex.html" title="General Index"
         
     | 
| 
       5076 
5074 
     | 
    
         
             
                         >index</a></li>
         
     | 
| 
       5077 
5075 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       5078 
     | 
    
         
            -
                      <a href="shutdown.html" title="7.3. 
     | 
| 
      
 5076 
     | 
    
         
            +
                      <a href="shutdown.html" title="7.3.34. shutdown"
         
     | 
| 
       5079 
5077 
     | 
    
         
             
                         >next</a> |</li>
         
     | 
| 
       5080 
5078 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       5081 
     | 
    
         
            -
                      <a href="ruby_load.html" title="7.3. 
     | 
| 
      
 5079 
     | 
    
         
            +
                      <a href="ruby_load.html" title="7.3.32. ruby_load"
         
     | 
| 
       5082 
5080 
     | 
    
         
             
                         >previous</a> |</li>
         
     | 
| 
       5083 
     | 
    
         
            -
                    <li><a href="../../index.html">Groonga v5.0. 
     | 
| 
      
 5081 
     | 
    
         
            +
                    <li><a href="../../index.html">Groonga v5.0.1-42-g4d10df1 documentation</a> »</li>
         
     | 
| 
       5084 
5082 
     | 
    
         
             
                      <li><a href="../../reference.html" >7. Reference manual</a> »</li>
         
     | 
| 
       5085 
5083 
     | 
    
         
             
                      <li><a href="../command.html" >7.3. Command</a> »</li> 
         
     | 
| 
       5086 
5084 
     | 
    
         
             
                  </ul>
         
     | 
| 
       5087 
5085 
     | 
    
         
             
                </div>
         
     | 
| 
       5088 
     | 
    
         
            -
                <div class="footer" 
     | 
| 
      
 5086 
     | 
    
         
            +
                <div class="footer">
         
     | 
| 
       5089 
5087 
     | 
    
         
             
                    © Copyright 2009-2015, Brazil, Inc.
         
     | 
| 
       5090 
5088 
     | 
    
         
             
                </div>
         
     | 
| 
       5091 
5089 
     | 
    
         
             
              </body>
         
     |