rroonga 5.0.4-x86-mingw32 → 5.0.5-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/README.md +2 -2
 - data/example/measure-data-column-disk-usage.rb +124 -0
 - data/example/measure-index-column-disk-usage.rb +81 -0
 - data/example/measure-table-disk-usage.rb +100 -0
 - data/ext/groonga/rb-grn-database.c +31 -0
 - data/ext/groonga/rb-grn-double-array-trie.c +1 -8
 - data/ext/groonga/rb-grn-logger.c +45 -0
 - data/ext/groonga/rb-grn-object.c +29 -1
 - data/ext/groonga/rb-grn-patricia-trie.c +1 -8
 - data/ext/groonga/rb-grn-table-cursor.c +8 -3
 - data/ext/groonga/rb-grn-table.c +10 -5
 - data/ext/groonga/rb-grn-thread.c +160 -0
 - data/ext/groonga/rb-grn-windows-event-logger.c +79 -0
 - data/ext/groonga/rb-grn.h +3 -1
 - data/ext/groonga/rb-groonga.c +3 -1
 - 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/dumper.rb +6 -1
 - data/rroonga-build.rb +4 -4
 - data/test/groonga-test-utils.rb +5 -1
 - data/test/test-database.rb +11 -0
 - data/test/test-logger.rb +6 -0
 - data/test/test-operator.rb +6 -6
 - data/test/test-procedure.rb +15 -0
 - data/test/test-table-dumper.rb +170 -1
 - data/test/test-thread.rb +42 -0
 - data/test/test-windows-event-logger.rb +28 -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-4.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/libwinpthread-1.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/httpd/groonga-httpd.conf +2 -2
 - data/vendor/local/etc/groonga/windows_event_log/provider.man +38 -0
 - data/vendor/local/include/groonga/groonga.h +2 -0
 - data/vendor/local/include/groonga/groonga/command.h +2 -0
 - data/vendor/local/include/groonga/groonga/groonga.h +5 -0
 - data/vendor/local/include/groonga/groonga/obj.h +1 -0
 - data/vendor/local/include/groonga/groonga/portability.h +16 -0
 - data/vendor/local/include/groonga/groonga/thread.h +42 -0
 - data/vendor/local/include/groonga/groonga/windows_event_logger.h +33 -0
 - data/vendor/local/lib/groonga/plugins/functions/vector.a +0 -0
 - data/vendor/local/lib/groonga/plugins/functions/vector.dll +0 -0
 - data/vendor/local/lib/groonga/plugins/functions/vector.dll.a +0 -0
 - data/vendor/local/lib/groonga/plugins/functions/vector.la +2 -2
 - 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.rb +5 -0
 - data/vendor/local/lib/groonga/plugins/sharding/logical_count.rb +43 -6
 - data/vendor/local/lib/groonga/plugins/sharding/logical_enumerator.rb +32 -25
 - data/vendor/local/lib/groonga/plugins/sharding/logical_parameters.rb +44 -0
 - data/vendor/local/lib/groonga/plugins/sharding/logical_range_filter.rb +217 -49
 - data/vendor/local/lib/groonga/plugins/sharding/logical_select.rb +507 -45
 - data/vendor/local/lib/groonga/plugins/sharding/logical_shard_list.rb +28 -0
 - data/vendor/local/lib/groonga/plugins/sharding/logical_table_remove.rb +11 -6
 - data/vendor/local/lib/groonga/plugins/sharding/parameters.rb +10 -0
 - 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/command.rb +31 -1
 - data/vendor/local/lib/groonga/scripts/ruby/context.rb +18 -2
 - data/vendor/local/lib/groonga/scripts/ruby/database.rb +12 -4
 - data/vendor/local/lib/groonga/scripts/ruby/expression_size_estimator.rb +31 -28
 - data/vendor/local/lib/groonga/scripts/ruby/initialize/post.rb +1 -0
 - data/vendor/local/lib/groonga/scripts/ruby/logger/level.rb +4 -2
 - data/vendor/local/lib/groonga/scripts/ruby/query_logger.rb +9 -0
 - data/vendor/local/lib/groonga/scripts/ruby/query_logger/flag.rb +39 -0
 - data/vendor/local/lib/groonga/scripts/ruby/record.rb +12 -0
 - data/vendor/local/lib/groonga/scripts/ruby/table.rb +35 -1
 - 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.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/_sources/contribution/development.txt +3 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/build.txt +19 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/build/unix_autotools.txt +101 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/build/unix_cmake.txt +94 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/build/windows_cmake.txt +93 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/release.txt +16 -7
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/repository.txt +7 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/test.txt +4 -0
 - 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 +4 -4
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/fedora.txt +3 -3
 - 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 +4 -4
 - 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 -4
 - 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 +319 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference.txt +1 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/api/grn_ctx.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/api/grn_db.txt +23 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/api/grn_thread.txt +122 -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_copy.txt +381 -0
 - 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 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/database_unmap.txt +85 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/io_flush.txt +218 -9
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/lock_clear.txt +1 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/log_level.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_count.txt +3 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_parameters.txt +138 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_range_filter.txt +97 -10
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_select.txt +745 -23
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_shard_list.txt +107 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_table_remove.txt +3 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/normalize.txt +2 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/normalizer_list.txt +1 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/object_exist.txt +90 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/plugin_register.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/plugin_unregister.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/register.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/request_cancel.txt +1 -3
 - 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 +240 -56
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_create.txt +33 -7
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_rename.txt +90 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_tokenize.txt +2 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/thread_limit.txt +110 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/tokenize.txt +2 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/tokenizer_list.txt +1 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/truncate.txt +1 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/executables/groonga-httpd.txt +3 -4
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/highlight_full.txt +0 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/highlight_html.txt +0 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/query.txt +2 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/snippet_html.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/grn_expr/query_syntax.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/grn_expr/script_syntax.txt +34 -14
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/indexing.txt +2 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/query_expanders/tsv.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/regular_expression.txt +3 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/scoring_note.txt +2 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/sharding.txt +108 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/tokenizers.txt +0 -21
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/tuning.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/spec/search.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/troubleshooting/different_results_with_the_same_keyword.txt +4 -4
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/introduction.txt +24 -18
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/match_columns.txt +19 -19
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/micro_blog.txt +9 -9
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/query_expansion.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_static/basic.css +68 -6
 - data/vendor/local/share/doc/groonga/en/html/_static/doctools.js +27 -2
 - 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-1.11.1.js +10308 -0
 - data/vendor/local/share/doc/groonga/en/html/_static/jquery.js +4 -9404
 - 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-1.3.1.js +999 -0
 - data/vendor/local/share/doc/groonga/en/html/_static/underscore.js +31 -1415
 - 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 +19 -17
 - data/vendor/local/share/doc/groonga/en/html/client.html +19 -17
 - data/vendor/local/share/doc/groonga/en/html/community.html +19 -17
 - data/vendor/local/share/doc/groonga/en/html/contribution.html +78 -70
 - data/vendor/local/share/doc/groonga/en/html/contribution/development.html +30 -27
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/build.html +146 -0
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/build/unix_autotools.html +237 -0
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/build/unix_cmake.html +227 -0
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/build/windows_cmake.html +231 -0
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/com.html +37 -35
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/cooperation.html +54 -52
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/query.html +80 -78
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/release.html +135 -122
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/repository.html +38 -34
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/test.html +58 -54
 - data/vendor/local/share/doc/groonga/en/html/contribution/documentation.html +21 -19
 - data/vendor/local/share/doc/groonga/en/html/contribution/documentation/c-api.html +27 -25
 - data/vendor/local/share/doc/groonga/en/html/contribution/documentation/i18n.html +23 -21
 - data/vendor/local/share/doc/groonga/en/html/contribution/documentation/introduction.html +30 -28
 - data/vendor/local/share/doc/groonga/en/html/contribution/report.html +21 -19
 - data/vendor/local/share/doc/groonga/en/html/development.html +19 -17
 - data/vendor/local/share/doc/groonga/en/html/development/travis-ci.html +30 -28
 - data/vendor/local/share/doc/groonga/en/html/genindex.html +48 -20
 - data/vendor/local/share/doc/groonga/en/html/index.html +123 -105
 - data/vendor/local/share/doc/groonga/en/html/install.html +33 -31
 - data/vendor/local/share/doc/groonga/en/html/install/centos.html +32 -30
 - data/vendor/local/share/doc/groonga/en/html/install/debian.html +31 -29
 - data/vendor/local/share/doc/groonga/en/html/install/fedora.html +29 -27
 - data/vendor/local/share/doc/groonga/en/html/install/mac_os_x.html +26 -24
 - data/vendor/local/share/doc/groonga/en/html/install/others.html +92 -90
 - data/vendor/local/share/doc/groonga/en/html/install/solaris.html +26 -24
 - data/vendor/local/share/doc/groonga/en/html/install/ubuntu.html +29 -28
 - data/vendor/local/share/doc/groonga/en/html/install/windows.html +34 -32
 - data/vendor/local/share/doc/groonga/en/html/limitations.html +19 -17
 - data/vendor/local/share/doc/groonga/en/html/news.html +509 -142
 - data/vendor/local/share/doc/groonga/en/html/news/0.x.html +19 -17
 - data/vendor/local/share/doc/groonga/en/html/news/1.0.x.html +20 -18
 - data/vendor/local/share/doc/groonga/en/html/news/1.1.x.html +19 -17
 - data/vendor/local/share/doc/groonga/en/html/news/1.2.x.html +34 -32
 - data/vendor/local/share/doc/groonga/en/html/news/1.3.x.html +29 -27
 - data/vendor/local/share/doc/groonga/en/html/news/2.x.html +110 -108
 - data/vendor/local/share/doc/groonga/en/html/news/3.x.html +73 -71
 - data/vendor/local/share/doc/groonga/en/html/news/4.x.html +111 -109
 - data/vendor/local/share/doc/groonga/en/html/news/senna.html +19 -17
 - data/vendor/local/share/doc/groonga/en/html/objects.inv +0 -0
 - data/vendor/local/share/doc/groonga/en/html/reference.html +111 -94
 - data/vendor/local/share/doc/groonga/en/html/reference/api.html +55 -52
 - data/vendor/local/share/doc/groonga/en/html/reference/api/global_configurations.html +51 -49
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_cache.html +63 -61
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_column.html +84 -82
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_command_version.html +46 -44
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_content_type.html +41 -39
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ctx.html +89 -87
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_db.html +88 -50
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_encoding.html +48 -46
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_expr.html +83 -81
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_geo.html +46 -44
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_hook.html +48 -46
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ii.html +46 -44
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_index_cursor.html +45 -43
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_info.html +45 -43
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_match_escalation.html +44 -42
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_obj.html +93 -91
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_proc.html +48 -46
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_search.html +43 -41
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table.html +79 -77
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table_cursor.html +69 -67
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_thread.html +296 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_type.html +45 -43
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_user_data.html +38 -36
 - data/vendor/local/share/doc/groonga/en/html/reference/api/overview.html +51 -49
 - data/vendor/local/share/doc/groonga/en/html/reference/api/plugin.html +60 -58
 - data/vendor/local/share/doc/groonga/en/html/reference/cast.html +19 -17
 - data/vendor/local/share/doc/groonga/en/html/reference/column.html +21 -19
 - data/vendor/local/share/doc/groonga/en/html/reference/columns/index.html +23 -21
 - data/vendor/local/share/doc/groonga/en/html/reference/columns/pseudo.html +28 -26
 - data/vendor/local/share/doc/groonga/en/html/reference/columns/scalar.html +23 -21
 - data/vendor/local/share/doc/groonga/en/html/reference/columns/vector.html +72 -70
 - data/vendor/local/share/doc/groonga/en/html/reference/command.html +70 -61
 - data/vendor/local/share/doc/groonga/en/html/reference/command/command_version.html +23 -21
 - data/vendor/local/share/doc/groonga/en/html/reference/command/output_format.html +59 -57
 - data/vendor/local/share/doc/groonga/en/html/reference/command/request_id.html +28 -26
 - data/vendor/local/share/doc/groonga/en/html/reference/command/return_code.html +100 -98
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/cache_limit.html +44 -42
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/check.html +49 -47
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/clearlock.html +33 -31
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/column_copy.html +796 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/column_create.html +62 -60
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/column_list.html +96 -94
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/column_remove.html +46 -44
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/column_rename.html +67 -64
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/database_unmap.html +236 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/define_selector.html +62 -60
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/defrag.html +46 -44
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/delete.html +59 -57
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/dump.html +63 -61
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/io_flush.html +281 -54
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/load.html +66 -64
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/lock_clear.html +53 -52
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/log_level.html +48 -46
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/log_put.html +48 -46
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/log_reopen.html +48 -46
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_count.html +78 -75
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_parameters.html +283 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_range_filter.html +160 -85
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_select.html +2071 -83
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_shard_list.html +287 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_table_remove.html +71 -68
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/normalize.html +86 -84
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/normalizer_list.html +52 -50
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/object_exist.html +227 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/plugin_register.html +57 -55
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/plugin_unregister.html +53 -51
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/quit.html +43 -41
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/range_filter.html +43 -41
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/register.html +56 -54
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/request_cancel.html +75 -74
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_eval.html +59 -57
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_load.html +59 -57
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/select.html +898 -647
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/shutdown.html +43 -41
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/status.html +50 -48
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/suggest.html +87 -85
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/table_create.html +175 -152
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/table_list.html +55 -53
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/table_remove.html +46 -44
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/table_rename.html +327 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/table_tokenize.html +77 -75
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/thread_limit.html +241 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenize.html +108 -106
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenizer_list.html +56 -51
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/truncate.html +56 -55
 - data/vendor/local/share/doc/groonga/en/html/reference/executables.html +24 -22
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/grndb.html +41 -39
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/grnslap.html +28 -26
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-benchmark.html +33 -31
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-httpd.html +83 -81
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-server-http.html +29 -27
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-create-dataset.html +23 -21
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-httpd.html +48 -46
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-learner.html +40 -38
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga.html +84 -82
 - data/vendor/local/share/doc/groonga/en/html/reference/function.html +22 -20
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/between.html +47 -45
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/edit_distance.html +25 -23
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_distance.html +85 -83
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_circle.html +36 -34
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_rectangle.html +26 -24
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/highlight_full.html +66 -64
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/highlight_html.html +54 -52
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/html_untag.html +35 -33
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/in_values.html +34 -32
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/now.html +23 -21
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/query.html +55 -53
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/rand.html +24 -22
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/snippet_html.html +49 -47
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/sub_filter.html +45 -43
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/vector_size.html +33 -31
 - data/vendor/local/share/doc/groonga/en/html/reference/grn_expr.html +29 -27
 - data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/query_syntax.html +244 -242
 - data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/script_syntax.html +327 -325
 - data/vendor/local/share/doc/groonga/en/html/reference/indexing.html +35 -29
 - data/vendor/local/share/doc/groonga/en/html/reference/log.html +43 -41
 - data/vendor/local/share/doc/groonga/en/html/reference/normalizers.html +49 -47
 - data/vendor/local/share/doc/groonga/en/html/reference/operations.html +21 -19
 - data/vendor/local/share/doc/groonga/en/html/reference/operations/geolocation_search.html +23 -21
 - data/vendor/local/share/doc/groonga/en/html/reference/output.html +36 -34
 - data/vendor/local/share/doc/groonga/en/html/reference/query_expanders.html +21 -19
 - data/vendor/local/share/doc/groonga/en/html/reference/query_expanders/tsv.html +62 -60
 - data/vendor/local/share/doc/groonga/en/html/reference/regular_expression.html +107 -103
 - data/vendor/local/share/doc/groonga/en/html/reference/scorer.html +50 -40
 - data/vendor/local/share/doc/groonga/en/html/reference/scorers/scorer_tf_at_most.html +27 -25
 - data/vendor/local/share/doc/groonga/en/html/reference/scorers/scorer_tf_idf.html +41 -31
 - data/vendor/local/share/doc/groonga/en/html/reference/scoring_note.html +19 -17
 - data/vendor/local/share/doc/groonga/en/html/reference/sharding.html +241 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/suggest.html +21 -19
 - data/vendor/local/share/doc/groonga/en/html/reference/suggest/completion.html +30 -28
 - data/vendor/local/share/doc/groonga/en/html/reference/suggest/correction.html +23 -21
 - data/vendor/local/share/doc/groonga/en/html/reference/suggest/introduction.html +23 -21
 - data/vendor/local/share/doc/groonga/en/html/reference/suggest/suggestion.html +23 -21
 - data/vendor/local/share/doc/groonga/en/html/reference/tables.html +56 -54
 - data/vendor/local/share/doc/groonga/en/html/reference/token_filters.html +41 -39
 - data/vendor/local/share/doc/groonga/en/html/reference/tokenizers.html +341 -289
 - data/vendor/local/share/doc/groonga/en/html/reference/tuning.html +68 -66
 - data/vendor/local/share/doc/groonga/en/html/reference/types.html +43 -41
 - 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 +19 -17
 - data/vendor/local/share/doc/groonga/en/html/server/gqtp.html +22 -20
 - data/vendor/local/share/doc/groonga/en/html/server/http.html +21 -19
 - data/vendor/local/share/doc/groonga/en/html/server/http/comparison.html +37 -35
 - data/vendor/local/share/doc/groonga/en/html/server/http/groonga-httpd.html +23 -21
 - data/vendor/local/share/doc/groonga/en/html/server/http/groonga.html +23 -21
 - data/vendor/local/share/doc/groonga/en/html/server/memcached.html +21 -19
 - data/vendor/local/share/doc/groonga/en/html/server/package.html +39 -37
 - data/vendor/local/share/doc/groonga/en/html/spec.html +23 -21
 - data/vendor/local/share/doc/groonga/en/html/spec/gqtp.html +129 -127
 - data/vendor/local/share/doc/groonga/en/html/spec/search.html +22 -20
 - data/vendor/local/share/doc/groonga/en/html/troubleshooting.html +19 -17
 - data/vendor/local/share/doc/groonga/en/html/troubleshooting/different_results_with_the_same_keyword.html +25 -23
 - data/vendor/local/share/doc/groonga/en/html/troubleshooting/mmap_cannot_allocate_memory.html +22 -20
 - data/vendor/local/share/doc/groonga/en/html/tutorial.html +20 -18
 - data/vendor/local/share/doc/groonga/en/html/tutorial/data.html +29 -23
 - data/vendor/local/share/doc/groonga/en/html/tutorial/drilldown.html +35 -33
 - data/vendor/local/share/doc/groonga/en/html/tutorial/index.html +25 -23
 - data/vendor/local/share/doc/groonga/en/html/tutorial/introduction.html +46 -39
 - data/vendor/local/share/doc/groonga/en/html/tutorial/lexicon.html +21 -19
 - data/vendor/local/share/doc/groonga/en/html/tutorial/match_columns.html +65 -63
 - data/vendor/local/share/doc/groonga/en/html/tutorial/micro_blog.html +55 -53
 - data/vendor/local/share/doc/groonga/en/html/tutorial/network.html +25 -23
 - data/vendor/local/share/doc/groonga/en/html/tutorial/patricia_trie.html +22 -20
 - data/vendor/local/share/doc/groonga/en/html/tutorial/query_expansion.html +25 -23
 - data/vendor/local/share/doc/groonga/en/html/tutorial/search.html +37 -35
 - data/vendor/local/share/doc/groonga/ja/html/.buildinfo +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development.txt +3 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/build.txt +19 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/build/unix_autotools.txt +101 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/build/unix_cmake.txt +94 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/build/windows_cmake.txt +93 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/release.txt +16 -7
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/repository.txt +7 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/test.txt +4 -0
 - 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 +4 -4
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/fedora.txt +3 -3
 - 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 +4 -4
 - 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 -4
 - 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 +319 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference.txt +1 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/grn_ctx.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/grn_db.txt +23 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/grn_thread.txt +122 -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_copy.txt +381 -0
 - 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 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/database_unmap.txt +85 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/io_flush.txt +218 -9
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/lock_clear.txt +1 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/log_level.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_count.txt +3 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_parameters.txt +138 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_range_filter.txt +97 -10
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_select.txt +745 -23
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_shard_list.txt +107 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_table_remove.txt +3 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/normalize.txt +2 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/normalizer_list.txt +1 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/object_exist.txt +90 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/plugin_register.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/plugin_unregister.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/register.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/request_cancel.txt +1 -3
 - 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 +240 -56
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_create.txt +33 -7
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_rename.txt +90 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_tokenize.txt +2 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/thread_limit.txt +110 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/tokenize.txt +2 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/tokenizer_list.txt +1 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/truncate.txt +1 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/groonga-httpd.txt +3 -4
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/highlight_full.txt +0 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/highlight_html.txt +0 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/query.txt +2 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/snippet_html.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/grn_expr/query_syntax.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/grn_expr/script_syntax.txt +34 -14
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/indexing.txt +2 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/query_expanders/tsv.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/regular_expression.txt +3 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/scoring_note.txt +2 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/sharding.txt +108 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/tokenizers.txt +0 -21
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/tuning.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/spec/search.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/troubleshooting/different_results_with_the_same_keyword.txt +4 -4
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/introduction.txt +24 -18
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/match_columns.txt +19 -19
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/micro_blog.txt +9 -9
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/query_expansion.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_static/basic.css +68 -6
 - data/vendor/local/share/doc/groonga/ja/html/_static/doctools.js +27 -2
 - 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-1.11.1.js +10308 -0
 - data/vendor/local/share/doc/groonga/ja/html/_static/jquery.js +4 -9404
 - 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-1.3.1.js +999 -0
 - data/vendor/local/share/doc/groonga/ja/html/_static/underscore.js +31 -1415
 - 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 +19 -17
 - data/vendor/local/share/doc/groonga/ja/html/client.html +19 -17
 - data/vendor/local/share/doc/groonga/ja/html/community.html +19 -17
 - data/vendor/local/share/doc/groonga/ja/html/contribution.html +77 -69
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development.html +30 -27
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/build.html +144 -0
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/build/unix_autotools.html +226 -0
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/build/unix_cmake.html +215 -0
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/build/windows_cmake.html +229 -0
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/com.html +36 -34
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/cooperation.html +53 -51
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/query.html +79 -77
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/release.html +134 -121
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/repository.html +29 -27
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/test.html +57 -53
 - data/vendor/local/share/doc/groonga/ja/html/contribution/documentation.html +21 -19
 - data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/c-api.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/i18n.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/introduction.html +30 -28
 - data/vendor/local/share/doc/groonga/ja/html/contribution/report.html +21 -19
 - data/vendor/local/share/doc/groonga/ja/html/development.html +19 -17
 - data/vendor/local/share/doc/groonga/ja/html/development/travis-ci.html +25 -23
 - data/vendor/local/share/doc/groonga/ja/html/genindex.html +48 -20
 - data/vendor/local/share/doc/groonga/ja/html/index.html +122 -104
 - data/vendor/local/share/doc/groonga/ja/html/install.html +33 -31
 - data/vendor/local/share/doc/groonga/ja/html/install/centos.html +35 -33
 - data/vendor/local/share/doc/groonga/ja/html/install/debian.html +33 -31
 - data/vendor/local/share/doc/groonga/ja/html/install/fedora.html +30 -28
 - data/vendor/local/share/doc/groonga/ja/html/install/mac_os_x.html +26 -24
 - data/vendor/local/share/doc/groonga/ja/html/install/others.html +83 -81
 - data/vendor/local/share/doc/groonga/ja/html/install/solaris.html +25 -23
 - data/vendor/local/share/doc/groonga/ja/html/install/ubuntu.html +30 -29
 - data/vendor/local/share/doc/groonga/ja/html/install/windows.html +33 -31
 - data/vendor/local/share/doc/groonga/ja/html/limitations.html +19 -17
 - data/vendor/local/share/doc/groonga/ja/html/news.html +460 -126
 - data/vendor/local/share/doc/groonga/ja/html/news/0.x.html +19 -17
 - data/vendor/local/share/doc/groonga/ja/html/news/1.0.x.html +20 -18
 - data/vendor/local/share/doc/groonga/ja/html/news/1.1.x.html +19 -17
 - data/vendor/local/share/doc/groonga/ja/html/news/1.2.x.html +34 -32
 - data/vendor/local/share/doc/groonga/ja/html/news/1.3.x.html +29 -27
 - data/vendor/local/share/doc/groonga/ja/html/news/2.x.html +102 -100
 - data/vendor/local/share/doc/groonga/ja/html/news/3.x.html +66 -64
 - data/vendor/local/share/doc/groonga/ja/html/news/4.x.html +91 -89
 - data/vendor/local/share/doc/groonga/ja/html/news/senna.html +19 -17
 - data/vendor/local/share/doc/groonga/ja/html/objects.inv +0 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference.html +111 -94
 - data/vendor/local/share/doc/groonga/ja/html/reference/api.html +55 -52
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/global_configurations.html +51 -49
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_cache.html +58 -56
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_column.html +84 -82
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_command_version.html +46 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_content_type.html +41 -39
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ctx.html +85 -83
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_db.html +88 -50
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_encoding.html +48 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_expr.html +78 -76
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_geo.html +46 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_hook.html +48 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ii.html +46 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_index_cursor.html +45 -43
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_info.html +45 -43
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_match_escalation.html +44 -42
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_obj.html +93 -91
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_proc.html +48 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_search.html +43 -41
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table.html +79 -77
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table_cursor.html +69 -67
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_thread.html +286 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_type.html +45 -43
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_user_data.html +38 -36
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/overview.html +48 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/plugin.html +60 -58
 - data/vendor/local/share/doc/groonga/ja/html/reference/cast.html +19 -17
 - data/vendor/local/share/doc/groonga/ja/html/reference/column.html +21 -19
 - data/vendor/local/share/doc/groonga/ja/html/reference/columns/index.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/reference/columns/pseudo.html +28 -26
 - data/vendor/local/share/doc/groonga/ja/html/reference/columns/scalar.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/reference/columns/vector.html +61 -59
 - data/vendor/local/share/doc/groonga/ja/html/reference/command.html +70 -61
 - data/vendor/local/share/doc/groonga/ja/html/reference/command/command_version.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/reference/command/output_format.html +49 -47
 - data/vendor/local/share/doc/groonga/ja/html/reference/command/request_id.html +28 -26
 - data/vendor/local/share/doc/groonga/ja/html/reference/command/return_code.html +99 -97
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/cache_limit.html +41 -39
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/check.html +49 -47
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/clearlock.html +33 -31
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_copy.html +781 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_create.html +62 -60
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_list.html +88 -86
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_remove.html +46 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_rename.html +66 -63
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/database_unmap.html +229 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/define_selector.html +62 -60
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/defrag.html +46 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/delete.html +58 -56
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/dump.html +63 -61
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/io_flush.html +266 -54
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/load.html +59 -57
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/lock_clear.html +53 -52
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_level.html +48 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_put.html +48 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_reopen.html +48 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_count.html +78 -75
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_parameters.html +276 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_range_filter.html +158 -85
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_select.html +2008 -80
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_shard_list.html +285 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_table_remove.html +71 -68
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalize.html +82 -79
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalizer_list.html +52 -50
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/object_exist.html +220 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/plugin_register.html +53 -51
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/plugin_unregister.html +51 -49
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/quit.html +43 -41
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/range_filter.html +43 -41
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/register.html +52 -50
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/request_cancel.html +68 -67
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_eval.html +59 -57
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_load.html +59 -57
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/select.html +680 -448
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/shutdown.html +43 -41
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/status.html +48 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/suggest.html +84 -82
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_create.html +146 -126
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_list.html +55 -53
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_remove.html +46 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_rename.html +322 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_tokenize.html +73 -70
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/thread_limit.html +229 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenize.html +94 -91
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenizer_list.html +56 -51
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/truncate.html +56 -55
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables.html +24 -22
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/grndb.html +39 -37
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/grnslap.html +28 -26
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-benchmark.html +33 -31
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-httpd.html +73 -72
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-server-http.html +29 -27
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-create-dataset.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-httpd.html +48 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-learner.html +40 -38
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga.html +84 -82
 - data/vendor/local/share/doc/groonga/ja/html/reference/function.html +22 -20
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/between.html +46 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/edit_distance.html +25 -23
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_distance.html +69 -67
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_circle.html +36 -34
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_rectangle.html +26 -24
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/highlight_full.html +56 -54
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/highlight_html.html +45 -43
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/html_untag.html +34 -32
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/in_values.html +35 -33
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/now.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/query.html +48 -46
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/rand.html +24 -22
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/snippet_html.html +35 -33
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/sub_filter.html +37 -35
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/vector_size.html +33 -31
 - data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr.html +26 -24
 - data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/query_syntax.html +143 -141
 - data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/script_syntax.html +236 -234
 - data/vendor/local/share/doc/groonga/ja/html/reference/indexing.html +34 -28
 - data/vendor/local/share/doc/groonga/ja/html/reference/log.html +43 -41
 - data/vendor/local/share/doc/groonga/ja/html/reference/normalizers.html +39 -37
 - data/vendor/local/share/doc/groonga/ja/html/reference/operations.html +21 -19
 - data/vendor/local/share/doc/groonga/ja/html/reference/operations/geolocation_search.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/reference/output.html +32 -30
 - data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders.html +21 -19
 - data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders/tsv.html +42 -39
 - data/vendor/local/share/doc/groonga/ja/html/reference/regular_expression.html +91 -88
 - data/vendor/local/share/doc/groonga/ja/html/reference/scorer.html +50 -40
 - data/vendor/local/share/doc/groonga/ja/html/reference/scorers/scorer_tf_at_most.html +27 -25
 - data/vendor/local/share/doc/groonga/ja/html/reference/scorers/scorer_tf_idf.html +41 -31
 - data/vendor/local/share/doc/groonga/ja/html/reference/scoring_note.html +19 -17
 - data/vendor/local/share/doc/groonga/ja/html/reference/sharding.html +223 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/suggest.html +21 -19
 - data/vendor/local/share/doc/groonga/ja/html/reference/suggest/completion.html +27 -25
 - data/vendor/local/share/doc/groonga/ja/html/reference/suggest/correction.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/reference/suggest/introduction.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/reference/suggest/suggestion.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/reference/tables.html +46 -44
 - data/vendor/local/share/doc/groonga/ja/html/reference/token_filters.html +38 -36
 - data/vendor/local/share/doc/groonga/ja/html/reference/tokenizers.html +303 -243
 - data/vendor/local/share/doc/groonga/ja/html/reference/tuning.html +62 -60
 - data/vendor/local/share/doc/groonga/ja/html/reference/types.html +42 -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 +19 -17
 - data/vendor/local/share/doc/groonga/ja/html/server/gqtp.html +21 -19
 - data/vendor/local/share/doc/groonga/ja/html/server/http.html +21 -19
 - data/vendor/local/share/doc/groonga/ja/html/server/http/comparison.html +31 -29
 - data/vendor/local/share/doc/groonga/ja/html/server/http/groonga-httpd.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/server/http/groonga.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/server/memcached.html +21 -19
 - data/vendor/local/share/doc/groonga/ja/html/server/package.html +38 -36
 - data/vendor/local/share/doc/groonga/ja/html/spec.html +23 -21
 - data/vendor/local/share/doc/groonga/ja/html/spec/gqtp.html +128 -126
 - data/vendor/local/share/doc/groonga/ja/html/spec/search.html +22 -20
 - data/vendor/local/share/doc/groonga/ja/html/troubleshooting.html +19 -17
 - data/vendor/local/share/doc/groonga/ja/html/troubleshooting/different_results_with_the_same_keyword.html +25 -23
 - data/vendor/local/share/doc/groonga/ja/html/troubleshooting/mmap_cannot_allocate_memory.html +22 -20
 - data/vendor/local/share/doc/groonga/ja/html/tutorial.html +20 -18
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/data.html +29 -23
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/drilldown.html +34 -32
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/index.html +22 -20
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/introduction.html +46 -39
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/lexicon.html +21 -19
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/match_columns.html +66 -64
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/micro_blog.html +52 -50
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/network.html +25 -23
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/patricia_trie.html +22 -20
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/query_expansion.html +25 -23
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/search.html +35 -33
 - data/vendor/local/share/license/groonga/README.md +6 -0
 - data/vendor/local/share/license/mruby/AUTHORS +1 -0
 - data/vendor/local/share/license/mruby/MITL +1 -1
 - data/vendor/local/share/license/mruby/README.md +6 -5
 - data/vendor/local/share/license/msgpack/README +219 -0
 - data/vendor/local/share/man/ja/man1/groonga.1 +23512 -15126
 - data/vendor/local/share/man/man1/groonga.1 +26542 -17745
 - metadata +77 -3
 - data/vendor/local/share/license/msgpack/AUTHORS +0 -0
 
| 
         @@ -7,7 +7,7 @@ 
     | 
|
| 
       7 
7 
     | 
    
         
             
              <head>
         
     | 
| 
       8 
8 
     | 
    
         
             
                <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
         
     | 
| 
       9 
9 
     | 
    
         | 
| 
       10 
     | 
    
         
            -
                <title>7.3. 
     | 
| 
      
 10 
     | 
    
         
            +
                <title>7.3.40. ruby_load — Groonga v5.0.6-226-gd7da7e7 documentation</title>
         
     | 
| 
       11 
11 
     | 
    
         | 
| 
       12 
12 
     | 
    
         
             
                <link rel="stylesheet" href="../../_static/groonga.css" type="text/css" />
         
     | 
| 
       13 
13 
     | 
    
         
             
                <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
         
     | 
| 
         @@ -15,7 +15,7 @@ 
     | 
|
| 
       15 
15 
     | 
    
         
             
                <script type="text/javascript">
         
     | 
| 
       16 
16 
     | 
    
         
             
                  var DOCUMENTATION_OPTIONS = {
         
     | 
| 
       17 
17 
     | 
    
         
             
                    URL_ROOT:    '../../',
         
     | 
| 
       18 
     | 
    
         
            -
                    VERSION:     '5.0. 
     | 
| 
      
 18 
     | 
    
         
            +
                    VERSION:     '5.0.6-226-gd7da7e7',
         
     | 
| 
       19 
19 
     | 
    
         
             
                    COLLAPSE_INDEX: false,
         
     | 
| 
       20 
20 
     | 
    
         
             
                    FILE_SUFFIX: '.html',
         
     | 
| 
       21 
21 
     | 
    
         
             
                    HAS_SOURCE:  true
         
     | 
| 
         @@ -25,12 +25,12 @@ 
     | 
|
| 
       25 
25 
     | 
    
         
             
                <script type="text/javascript" src="../../_static/underscore.js"></script>
         
     | 
| 
       26 
26 
     | 
    
         
             
                <script type="text/javascript" src="../../_static/doctools.js"></script>
         
     | 
| 
       27 
27 
     | 
    
         
             
                <link rel="shortcut icon" href="../../_static/favicon.ico"/>
         
     | 
| 
       28 
     | 
    
         
            -
                <link rel="top" title="Groonga v5.0. 
     | 
| 
      
 28 
     | 
    
         
            +
                <link rel="top" title="Groonga v5.0.6-226-gd7da7e7 documentation" href="../../index.html" />
         
     | 
| 
       29 
29 
     | 
    
         
             
                <link rel="up" title="7.3. Command" href="../command.html" />
         
     | 
| 
       30 
     | 
    
         
            -
                <link rel="next" title="7.3. 
     | 
| 
       31 
     | 
    
         
            -
                <link rel="prev" title="7.3. 
     | 
| 
      
 30 
     | 
    
         
            +
                <link rel="next" title="7.3.41. select" href="select.html" />
         
     | 
| 
      
 31 
     | 
    
         
            +
                <link rel="prev" title="7.3.39. ruby_eval" href="ruby_eval.html" /> 
         
     | 
| 
       32 
32 
     | 
    
         
             
              </head>
         
     | 
| 
       33 
     | 
    
         
            -
              <body>
         
     | 
| 
      
 33 
     | 
    
         
            +
              <body role="document">
         
     | 
| 
       34 
34 
     | 
    
         
             
            <div class="header">
         
     | 
| 
       35 
35 
     | 
    
         
             
              <h1 class="title">
         
     | 
| 
       36 
36 
     | 
    
         
             
                <a id="top-link" href="../../index.html">
         
     | 
| 
         @@ -48,46 +48,46 @@ 
     | 
|
| 
       48 
48 
     | 
    
         
             
            </div>
         
     | 
| 
       49 
49 
     | 
    
         | 
| 
       50 
50 
     | 
    
         | 
| 
       51 
     | 
    
         
            -
                <div class="related">
         
     | 
| 
      
 51 
     | 
    
         
            +
                <div class="related" role="navigation" aria-label="related navigation">
         
     | 
| 
       52 
52 
     | 
    
         
             
                  <h3>Navigation</h3>
         
     | 
| 
       53 
53 
     | 
    
         
             
                  <ul>
         
     | 
| 
       54 
54 
     | 
    
         
             
                    <li class="right" style="margin-right: 10px">
         
     | 
| 
       55 
55 
     | 
    
         
             
                      <a href="../../genindex.html" title="General Index"
         
     | 
| 
       56 
56 
     | 
    
         
             
                         accesskey="I">index</a></li>
         
     | 
| 
       57 
57 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       58 
     | 
    
         
            -
                      <a href="select.html" title="7.3. 
     | 
| 
      
 58 
     | 
    
         
            +
                      <a href="select.html" title="7.3.41. select"
         
     | 
| 
       59 
59 
     | 
    
         
             
                         accesskey="N">next</a> |</li>
         
     | 
| 
       60 
60 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       61 
     | 
    
         
            -
                      <a href="ruby_eval.html" title="7.3. 
     | 
| 
      
 61 
     | 
    
         
            +
                      <a href="ruby_eval.html" title="7.3.39. ruby_eval"
         
     | 
| 
       62 
62 
     | 
    
         
             
                         accesskey="P">previous</a> |</li>
         
     | 
| 
       63 
     | 
    
         
            -
                    <li><a href="../../index.html">Groonga v5.0. 
     | 
| 
       64 
     | 
    
         
            -
                      <li><a href="../../reference.html" >7. Reference manual</a> »</li>
         
     | 
| 
       65 
     | 
    
         
            -
                      <li><a href="../command.html" accesskey="U">7.3. Command</a> »</li> 
         
     | 
| 
      
 63 
     | 
    
         
            +
                    <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.6-226-gd7da7e7 documentation</a> »</li>
         
     | 
| 
      
 64 
     | 
    
         
            +
                      <li class="nav-item nav-item-1"><a href="../../reference.html" >7. Reference manual</a> »</li>
         
     | 
| 
      
 65 
     | 
    
         
            +
                      <li class="nav-item nav-item-2"><a href="../command.html" accesskey="U">7.3. Command</a> »</li> 
         
     | 
| 
       66 
66 
     | 
    
         
             
                  </ul>
         
     | 
| 
       67 
67 
     | 
    
         
             
                </div>  
         
     | 
| 
       68 
68 
     | 
    
         | 
| 
       69 
69 
     | 
    
         
             
                <div class="document">
         
     | 
| 
       70 
70 
     | 
    
         
             
                  <div class="documentwrapper">
         
     | 
| 
       71 
71 
     | 
    
         
             
                    <div class="bodywrapper">
         
     | 
| 
       72 
     | 
    
         
            -
                      <div class="body">
         
     | 
| 
      
 72 
     | 
    
         
            +
                      <div class="body" role="main">
         
     | 
| 
       73 
73 
     | 
    
         | 
| 
       74 
74 
     | 
    
         
             
              <div class="section" id="ruby-load">
         
     | 
| 
       75 
     | 
    
         
            -
            <h1>7.3. 
     | 
| 
      
 75 
     | 
    
         
            +
            <h1>7.3.40. <code class="docutils literal"><span class="pre">ruby_load</span></code><a class="headerlink" href="#ruby-load" title="Permalink to this headline">¶</a></h1>
         
     | 
| 
       76 
76 
     | 
    
         
             
            <div class="section" id="summary">
         
     | 
| 
       77 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
       78 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 77 
     | 
    
         
            +
            <h2>7.3.40.1. Summary<a class="headerlink" href="#summary" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
      
 78 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">ruby_load</span></code> command loads specified Ruby script.</p>
         
     | 
| 
       79 
79 
     | 
    
         
             
            </div>
         
     | 
| 
       80 
80 
     | 
    
         
             
            <div class="section" id="syntax">
         
     | 
| 
       81 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
       82 
     | 
    
         
            -
            <p 
     | 
| 
      
 81 
     | 
    
         
            +
            <h2>7.3.40.2. Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
      
 82 
     | 
    
         
            +
            <p>This command takes only one required parameter:</p>
         
     | 
| 
       83 
83 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>ruby_load path
         
     | 
| 
       84 
84 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       85 
85 
     | 
    
         
             
            </div>
         
     | 
| 
       86 
86 
     | 
    
         
             
            </div>
         
     | 
| 
       87 
87 
     | 
    
         
             
            <div class="section" id="usage">
         
     | 
| 
       88 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
       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.40.3. Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
      
 89 
     | 
    
         
            +
            <p>You can load any script file which mruby supports by calling <code class="docutils literal"><span class="pre">ruby_load</span></code>.</p>
         
     | 
| 
      
 90 
     | 
    
         
            +
            <p>Here is an example that just load <code class="docutils literal"><span class="pre">expression.rb</span></code> as Ruby script.</p>
         
     | 
| 
       91 
91 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       92 
92 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>register ruby/load
         
     | 
| 
       93 
93 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], true]
         
     | 
| 
         @@ -95,36 +95,36 @@ ruby_load "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 <code class="docutils literal"><span class="pre">ruby/load</span></code> plugin to use <code class="docutils literal"><span class="pre">ruby_load</span></code> command in advance.</p>
         
     | 
| 
      
 99 
     | 
    
         
            +
            <p>Note that <code class="docutils literal"><span class="pre">ruby_load</span></code> is implemented as an experimental plugin,
         
     | 
| 
       100 
100 
     | 
    
         
             
            and the specification may be changed in the future.</p>
         
     | 
| 
       101 
101 
     | 
    
         
             
            </div>
         
     | 
| 
       102 
102 
     | 
    
         
             
            <div class="section" id="parameters">
         
     | 
| 
       103 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
      
 103 
     | 
    
         
            +
            <h2>7.3.40.4. Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
       104 
104 
     | 
    
         
             
            <p>This section describes all parameters.</p>
         
     | 
| 
       105 
105 
     | 
    
         
             
            <div class="section" id="path">
         
     | 
| 
       106 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
      
 106 
     | 
    
         
            +
            <h3>7.3.40.4.1. <code class="docutils literal"><span class="pre">path</span></code><a class="headerlink" href="#path" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       107 
107 
     | 
    
         
             
            <p>Specifies the Ruby script path which you want to load.</p>
         
     | 
| 
       108 
108 
     | 
    
         
             
            </div>
         
     | 
| 
       109 
109 
     | 
    
         
             
            </div>
         
     | 
| 
       110 
110 
     | 
    
         
             
            <div class="section" id="return-value">
         
     | 
| 
       111 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
       112 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 111 
     | 
    
         
            +
            <h2>7.3.40.5. Return value<a class="headerlink" href="#return-value" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
      
 112 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">ruby_load</span></code> returns the loaded result with metadata such as
         
     | 
| 
       113 
113 
     | 
    
         
             
            exception information (Including metadata isn't implemented yet):</p>
         
     | 
| 
       114 
114 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>[HEADER, {"value": LOADED_VALUE}]
         
     | 
| 
       115 
115 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       116 
116 
     | 
    
         
             
            </div>
         
     | 
| 
       117 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 117 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">HEADER</span></code></p>
         
     | 
| 
       118 
118 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       119 
     | 
    
         
            -
            <div>See <a class="reference internal" href="../command/output_format.html"><em>Output format</em></a> about < 
     | 
| 
       120 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 119 
     | 
    
         
            +
            <div>See <a class="reference internal" href="../command/output_format.html"><em>Output format</em></a> about <code class="docutils literal"><span class="pre">HEADER</span></code>.</div></blockquote>
         
     | 
| 
      
 120 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">LOADED_VALUE</span></code></p>
         
     | 
| 
       121 
121 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       122 
     | 
    
         
            -
            <div><p>< 
     | 
| 
       123 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 122 
     | 
    
         
            +
            <div><p><code class="docutils literal"><span class="pre">LOADED_VALUE</span></code> is the loaded value of ruby script.</p>
         
     | 
| 
      
 123 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">ruby_load</span></code> just return <code class="docutils literal"><span class="pre">null</span></code> as <code class="docutils literal"><span class="pre">LOADED_VALUE</span></code> for now, it will be supported in the future.</p>
         
     | 
| 
       124 
124 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       125 
125 
     | 
    
         
             
            </div>
         
     | 
| 
       126 
126 
     | 
    
         
             
            <div class="section" id="see-also">
         
     | 
| 
       127 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
      
 127 
     | 
    
         
            +
            <h2>7.3.40.6. See also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
       128 
128 
     | 
    
         
             
            <p><a class="reference internal" href="ruby_eval.html"><em>ruby_eval</em></a></p>
         
     | 
| 
       129 
129 
     | 
    
         
             
            </div>
         
     | 
| 
       130 
130 
     | 
    
         
             
            </div>
         
     | 
| 
         @@ -133,36 +133,38 @@ exception information (Including metadata isn't implemented yet):</p> 
     | 
|
| 
       133 
133 
     | 
    
         
             
                      </div>
         
     | 
| 
       134 
134 
     | 
    
         
             
                    </div>
         
     | 
| 
       135 
135 
     | 
    
         
             
                  </div>
         
     | 
| 
       136 
     | 
    
         
            -
                  <div class="sphinxsidebar">
         
     | 
| 
      
 136 
     | 
    
         
            +
                  <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
         
     | 
| 
       137 
137 
     | 
    
         
             
                    <div class="sphinxsidebarwrapper">
         
     | 
| 
       138 
138 
     | 
    
         
             
              <h3><a href="../../index.html">Table Of Contents</a></h3>
         
     | 
| 
       139 
139 
     | 
    
         
             
              <ul>
         
     | 
| 
       140 
     | 
    
         
            -
            <li><a class="reference internal" href="#">7.3. 
     | 
| 
       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.40. <code class="docutils literal"><span class="pre">ruby_load</span></code></a><ul>
         
     | 
| 
      
 141 
     | 
    
         
            +
            <li><a class="reference internal" href="#summary">7.3.40.1. Summary</a></li>
         
     | 
| 
      
 142 
     | 
    
         
            +
            <li><a class="reference internal" href="#syntax">7.3.40.2. Syntax</a></li>
         
     | 
| 
      
 143 
     | 
    
         
            +
            <li><a class="reference internal" href="#usage">7.3.40.3. Usage</a></li>
         
     | 
| 
      
 144 
     | 
    
         
            +
            <li><a class="reference internal" href="#parameters">7.3.40.4. Parameters</a><ul>
         
     | 
| 
      
 145 
     | 
    
         
            +
            <li><a class="reference internal" href="#path">7.3.40.4.1. <code class="docutils literal"><span class="pre">path</span></code></a></li>
         
     | 
| 
       146 
146 
     | 
    
         
             
            </ul>
         
     | 
| 
       147 
147 
     | 
    
         
             
            </li>
         
     | 
| 
       148 
     | 
    
         
            -
            <li><a class="reference internal" href="#return-value">7.3. 
     | 
| 
       149 
     | 
    
         
            -
            <li><a class="reference internal" href="#see-also">7.3. 
     | 
| 
      
 148 
     | 
    
         
            +
            <li><a class="reference internal" href="#return-value">7.3.40.5. Return value</a></li>
         
     | 
| 
      
 149 
     | 
    
         
            +
            <li><a class="reference internal" href="#see-also">7.3.40.6. See also</a></li>
         
     | 
| 
       150 
150 
     | 
    
         
             
            </ul>
         
     | 
| 
       151 
151 
     | 
    
         
             
            </li>
         
     | 
| 
       152 
152 
     | 
    
         
             
            </ul>
         
     | 
| 
       153 
153 
     | 
    
         | 
| 
       154 
154 
     | 
    
         
             
              <h4>Previous topic</h4>
         
     | 
| 
       155 
155 
     | 
    
         
             
              <p class="topless"><a href="ruby_eval.html"
         
     | 
| 
       156 
     | 
    
         
            -
                                    title="previous chapter">7.3. 
     | 
| 
      
 156 
     | 
    
         
            +
                                    title="previous chapter">7.3.39. <code class="docutils literal"><span class="pre">ruby_eval</span></code></a></p>
         
     | 
| 
       157 
157 
     | 
    
         
             
              <h4>Next topic</h4>
         
     | 
| 
       158 
158 
     | 
    
         
             
              <p class="topless"><a href="select.html"
         
     | 
| 
       159 
     | 
    
         
            -
                                    title="next chapter">7.3. 
     | 
| 
       160 
     | 
    
         
            -
              < 
     | 
| 
       161 
     | 
    
         
            -
             
     | 
| 
       162 
     | 
    
         
            -
                < 
     | 
| 
       163 
     | 
    
         
            -
             
     | 
| 
       164 
     | 
    
         
            -
             
     | 
| 
       165 
     | 
    
         
            -
             
     | 
| 
      
 159 
     | 
    
         
            +
                                    title="next chapter">7.3.41. <code class="docutils literal"><span class="pre">select</span></code></a></p>
         
     | 
| 
      
 160 
     | 
    
         
            +
              <div role="note" aria-label="source link">
         
     | 
| 
      
 161 
     | 
    
         
            +
                <h3>This Page</h3>
         
     | 
| 
      
 162 
     | 
    
         
            +
                <ul class="this-page-menu">
         
     | 
| 
      
 163 
     | 
    
         
            +
                  <li><a href="../../_sources/reference/commands/ruby_load.txt"
         
     | 
| 
      
 164 
     | 
    
         
            +
                        rel="nofollow">Show Source</a></li>
         
     | 
| 
      
 165 
     | 
    
         
            +
                </ul>
         
     | 
| 
      
 166 
     | 
    
         
            +
               </div>
         
     | 
| 
      
 167 
     | 
    
         
            +
            <div id="searchbox" style="display: none" role="search">
         
     | 
| 
       166 
168 
     | 
    
         
             
              <h3>Quick search</h3>
         
     | 
| 
       167 
169 
     | 
    
         
             
                <form class="search" action="../../search.html" method="get">
         
     | 
| 
       168 
170 
     | 
    
         
             
                  <input type="text" name="q" />
         
     | 
| 
         @@ -179,24 +181,24 @@ exception information (Including metadata isn't implemented yet):</p> 
     | 
|
| 
       179 
181 
     | 
    
         
             
                  </div>
         
     | 
| 
       180 
182 
     | 
    
         
             
                  <div class="clearer"></div>
         
     | 
| 
       181 
183 
     | 
    
         
             
                </div>
         
     | 
| 
       182 
     | 
    
         
            -
                <div class="related">
         
     | 
| 
      
 184 
     | 
    
         
            +
                <div class="related" role="navigation" aria-label="related navigation">
         
     | 
| 
       183 
185 
     | 
    
         
             
                  <h3>Navigation</h3>
         
     | 
| 
       184 
186 
     | 
    
         
             
                  <ul>
         
     | 
| 
       185 
187 
     | 
    
         
             
                    <li class="right" style="margin-right: 10px">
         
     | 
| 
       186 
188 
     | 
    
         
             
                      <a href="../../genindex.html" title="General Index"
         
     | 
| 
       187 
189 
     | 
    
         
             
                         >index</a></li>
         
     | 
| 
       188 
190 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       189 
     | 
    
         
            -
                      <a href="select.html" title="7.3. 
     | 
| 
      
 191 
     | 
    
         
            +
                      <a href="select.html" title="7.3.41. select"
         
     | 
| 
       190 
192 
     | 
    
         
             
                         >next</a> |</li>
         
     | 
| 
       191 
193 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       192 
     | 
    
         
            -
                      <a href="ruby_eval.html" title="7.3. 
     | 
| 
      
 194 
     | 
    
         
            +
                      <a href="ruby_eval.html" title="7.3.39. ruby_eval"
         
     | 
| 
       193 
195 
     | 
    
         
             
                         >previous</a> |</li>
         
     | 
| 
       194 
     | 
    
         
            -
                    <li><a href="../../index.html">Groonga v5.0. 
     | 
| 
       195 
     | 
    
         
            -
                      <li><a href="../../reference.html" >7. Reference manual</a> »</li>
         
     | 
| 
       196 
     | 
    
         
            -
                      <li><a href="../command.html" >7.3. Command</a> »</li> 
         
     | 
| 
      
 196 
     | 
    
         
            +
                    <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.6-226-gd7da7e7 documentation</a> »</li>
         
     | 
| 
      
 197 
     | 
    
         
            +
                      <li class="nav-item nav-item-1"><a href="../../reference.html" >7. Reference manual</a> »</li>
         
     | 
| 
      
 198 
     | 
    
         
            +
                      <li class="nav-item nav-item-2"><a href="../command.html" >7.3. Command</a> »</li> 
         
     | 
| 
       197 
199 
     | 
    
         
             
                  </ul>
         
     | 
| 
       198 
200 
     | 
    
         
             
                </div>
         
     | 
| 
       199 
     | 
    
         
            -
                <div class="footer">
         
     | 
| 
      
 201 
     | 
    
         
            +
                <div class="footer" role="contentinfo">
         
     | 
| 
       200 
202 
     | 
    
         
             
                    © Copyright 2009-2015, Brazil, Inc.
         
     | 
| 
       201 
203 
     | 
    
         
             
                </div>
         
     | 
| 
       202 
204 
     | 
    
         
             
              </body>
         
     | 
| 
         @@ -7,7 +7,7 @@ 
     | 
|
| 
       7 
7 
     | 
    
         
             
              <head>
         
     | 
| 
       8 
8 
     | 
    
         
             
                <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
         
     | 
| 
       9 
9 
     | 
    
         | 
| 
       10 
     | 
    
         
            -
                <title>7.3. 
     | 
| 
      
 10 
     | 
    
         
            +
                <title>7.3.41. select — Groonga v5.0.6-226-gd7da7e7 documentation</title>
         
     | 
| 
       11 
11 
     | 
    
         | 
| 
       12 
12 
     | 
    
         
             
                <link rel="stylesheet" href="../../_static/groonga.css" type="text/css" />
         
     | 
| 
       13 
13 
     | 
    
         
             
                <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
         
     | 
| 
         @@ -15,7 +15,7 @@ 
     | 
|
| 
       15 
15 
     | 
    
         
             
                <script type="text/javascript">
         
     | 
| 
       16 
16 
     | 
    
         
             
                  var DOCUMENTATION_OPTIONS = {
         
     | 
| 
       17 
17 
     | 
    
         
             
                    URL_ROOT:    '../../',
         
     | 
| 
       18 
     | 
    
         
            -
                    VERSION:     '5.0. 
     | 
| 
      
 18 
     | 
    
         
            +
                    VERSION:     '5.0.6-226-gd7da7e7',
         
     | 
| 
       19 
19 
     | 
    
         
             
                    COLLAPSE_INDEX: false,
         
     | 
| 
       20 
20 
     | 
    
         
             
                    FILE_SUFFIX: '.html',
         
     | 
| 
       21 
21 
     | 
    
         
             
                    HAS_SOURCE:  true
         
     | 
| 
         @@ -25,12 +25,12 @@ 
     | 
|
| 
       25 
25 
     | 
    
         
             
                <script type="text/javascript" src="../../_static/underscore.js"></script>
         
     | 
| 
       26 
26 
     | 
    
         
             
                <script type="text/javascript" src="../../_static/doctools.js"></script>
         
     | 
| 
       27 
27 
     | 
    
         
             
                <link rel="shortcut icon" href="../../_static/favicon.ico"/>
         
     | 
| 
       28 
     | 
    
         
            -
                <link rel="top" title="Groonga v5.0. 
     | 
| 
      
 28 
     | 
    
         
            +
                <link rel="top" title="Groonga v5.0.6-226-gd7da7e7 documentation" href="../../index.html" />
         
     | 
| 
       29 
29 
     | 
    
         
             
                <link rel="up" title="7.3. Command" href="../command.html" />
         
     | 
| 
       30 
     | 
    
         
            -
                <link rel="next" title="7.3. 
     | 
| 
       31 
     | 
    
         
            -
                <link rel="prev" title="7.3. 
     | 
| 
      
 30 
     | 
    
         
            +
                <link rel="next" title="7.3.42. shutdown" href="shutdown.html" />
         
     | 
| 
      
 31 
     | 
    
         
            +
                <link rel="prev" title="7.3.40. ruby_load" href="ruby_load.html" /> 
         
     | 
| 
       32 
32 
     | 
    
         
             
              </head>
         
     | 
| 
       33 
     | 
    
         
            -
              <body>
         
     | 
| 
      
 33 
     | 
    
         
            +
              <body role="document">
         
     | 
| 
       34 
34 
     | 
    
         
             
            <div class="header">
         
     | 
| 
       35 
35 
     | 
    
         
             
              <h1 class="title">
         
     | 
| 
       36 
36 
     | 
    
         
             
                <a id="top-link" href="../../index.html">
         
     | 
| 
         @@ -48,42 +48,43 @@ 
     | 
|
| 
       48 
48 
     | 
    
         
             
            </div>
         
     | 
| 
       49 
49 
     | 
    
         | 
| 
       50 
50 
     | 
    
         | 
| 
       51 
     | 
    
         
            -
                <div class="related">
         
     | 
| 
      
 51 
     | 
    
         
            +
                <div class="related" role="navigation" aria-label="related navigation">
         
     | 
| 
       52 
52 
     | 
    
         
             
                  <h3>Navigation</h3>
         
     | 
| 
       53 
53 
     | 
    
         
             
                  <ul>
         
     | 
| 
       54 
54 
     | 
    
         
             
                    <li class="right" style="margin-right: 10px">
         
     | 
| 
       55 
55 
     | 
    
         
             
                      <a href="../../genindex.html" title="General Index"
         
     | 
| 
       56 
56 
     | 
    
         
             
                         accesskey="I">index</a></li>
         
     | 
| 
       57 
57 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       58 
     | 
    
         
            -
                      <a href="shutdown.html" title="7.3. 
     | 
| 
      
 58 
     | 
    
         
            +
                      <a href="shutdown.html" title="7.3.42. shutdown"
         
     | 
| 
       59 
59 
     | 
    
         
             
                         accesskey="N">next</a> |</li>
         
     | 
| 
       60 
60 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       61 
     | 
    
         
            -
                      <a href="ruby_load.html" title="7.3. 
     | 
| 
      
 61 
     | 
    
         
            +
                      <a href="ruby_load.html" title="7.3.40. ruby_load"
         
     | 
| 
       62 
62 
     | 
    
         
             
                         accesskey="P">previous</a> |</li>
         
     | 
| 
       63 
     | 
    
         
            -
                    <li><a href="../../index.html">Groonga v5.0. 
     | 
| 
       64 
     | 
    
         
            -
                      <li><a href="../../reference.html" >7. Reference manual</a> »</li>
         
     | 
| 
       65 
     | 
    
         
            -
                      <li><a href="../command.html" accesskey="U">7.3. Command</a> »</li> 
         
     | 
| 
      
 63 
     | 
    
         
            +
                    <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.6-226-gd7da7e7 documentation</a> »</li>
         
     | 
| 
      
 64 
     | 
    
         
            +
                      <li class="nav-item nav-item-1"><a href="../../reference.html" >7. Reference manual</a> »</li>
         
     | 
| 
      
 65 
     | 
    
         
            +
                      <li class="nav-item nav-item-2"><a href="../command.html" accesskey="U">7.3. Command</a> »</li> 
         
     | 
| 
       66 
66 
     | 
    
         
             
                  </ul>
         
     | 
| 
       67 
67 
     | 
    
         
             
                </div>  
         
     | 
| 
       68 
68 
     | 
    
         | 
| 
       69 
69 
     | 
    
         
             
                <div class="document">
         
     | 
| 
       70 
70 
     | 
    
         
             
                  <div class="documentwrapper">
         
     | 
| 
       71 
71 
     | 
    
         
             
                    <div class="bodywrapper">
         
     | 
| 
       72 
     | 
    
         
            -
                      <div class="body">
         
     | 
| 
      
 72 
     | 
    
         
            +
                      <div class="body" role="main">
         
     | 
| 
       73 
73 
     | 
    
         | 
| 
       74 
74 
     | 
    
         
             
              <div class="section" id="select">
         
     | 
| 
       75 
     | 
    
         
            -
            <h1>7.3. 
     | 
| 
      
 75 
     | 
    
         
            +
            <h1>7.3.41. <code class="docutils literal"><span class="pre">select</span></code><a class="headerlink" href="#select" title="Permalink to this headline">¶</a></h1>
         
     | 
| 
       76 
76 
     | 
    
         
             
            <div class="section" id="summary">
         
     | 
| 
       77 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
       78 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 77 
     | 
    
         
            +
            <h2>7.3.41.1. Summary<a class="headerlink" href="#summary" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
      
 78 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">select</span></code> searches records that are matched to specified conditions
         
     | 
| 
       79 
79 
     | 
    
         
             
            from a table and then outputs them.</p>
         
     | 
| 
       80 
     | 
    
         
            -
            <p>< 
     | 
| 
       81 
     | 
    
         
            -
            understand < 
     | 
| 
      
 80 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">select</span></code> is the most important command in groonga. You need to
         
     | 
| 
      
 81 
     | 
    
         
            +
            understand <code class="docutils literal"><span class="pre">select</span></code> to use the full power of Groonga.</p>
         
     | 
| 
       82 
82 
     | 
    
         
             
            </div>
         
     | 
| 
       83 
83 
     | 
    
         
             
            <div class="section" id="syntax">
         
     | 
| 
       84 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
       85 
     | 
    
         
            -
            <p 
     | 
| 
       86 
     | 
    
         
            -
            < 
     | 
| 
      
 84 
     | 
    
         
            +
            <h2>7.3.41.2. Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
      
 85 
     | 
    
         
            +
            <p>This command takes many parameters.</p>
         
     | 
| 
      
 86 
     | 
    
         
            +
            <p>The required parameter is only <code class="docutils literal"><span class="pre">table</span></code>. Other parameters are
         
     | 
| 
      
 87 
     | 
    
         
            +
            optional:</p>
         
     | 
| 
       87 
88 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select table
         
     | 
| 
       88 
89 
     | 
    
         
             
                   [match_columns=null]
         
     | 
| 
       89 
90 
     | 
    
         
             
                   [query=null]
         
     | 
| 
         @@ -108,41 +109,41 @@ understand <tt class="docutils literal"><span class="pre">select</span></tt> to 
     | 
|
| 
       108 
109 
     | 
    
         
             
                   [drilldown_calc_target=null]
         
     | 
| 
       109 
110 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       110 
111 
     | 
    
         
             
            </div>
         
     | 
| 
       111 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 112 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">select</span></code> has the following named parameters for advanced drilldown:</p>
         
     | 
| 
       112 
113 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       113 
114 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       114 
     | 
    
         
            -
            <li>< 
     | 
| 
       115 
     | 
    
         
            -
            <li>< 
     | 
| 
       116 
     | 
    
         
            -
            <li>< 
     | 
| 
       117 
     | 
    
         
            -
            <li>< 
     | 
| 
       118 
     | 
    
         
            -
            <li>< 
     | 
| 
       119 
     | 
    
         
            -
            <li>< 
     | 
| 
       120 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 115 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys=null</span></code></li>
         
     | 
| 
      
 116 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].sortby=null</span></code></li>
         
     | 
| 
      
 117 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns="_key,</span> <span class="pre">_nsubrecs"</span></code></li>
         
     | 
| 
      
 118 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].offset=0</span></code></li>
         
     | 
| 
      
 119 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].limit=10</span></code></li>
         
     | 
| 
      
 120 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_types=NONE</span></code></li>
         
     | 
| 
      
 121 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_target=null</span></code></li>
         
     | 
| 
       121 
122 
     | 
    
         
             
            </ul>
         
     | 
| 
       122 
123 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       123 
     | 
    
         
            -
            <p>You can use one or more alphabets, digits, < 
     | 
| 
       124 
     | 
    
         
            -
            < 
     | 
| 
       125 
     | 
    
         
            -
            <p>Parameters that have the same < 
     | 
| 
      
 124 
     | 
    
         
            +
            <p>You can use one or more alphabets, digits, <code class="docutils literal"><span class="pre">_</span></code> and <code class="docutils literal"><span class="pre">.</span></code> for
         
     | 
| 
      
 125 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">${LABEL}</span></code>. For example, <code class="docutils literal"><span class="pre">parent.sub1</span></code> is a valid <code class="docutils literal"><span class="pre">${LABEL}</span></code>.</p>
         
     | 
| 
      
 126 
     | 
    
         
            +
            <p>Parameters that have the same <code class="docutils literal"><span class="pre">${LABEL}</span></code> are grouped.</p>
         
     | 
| 
       126 
127 
     | 
    
         
             
            <p>For example, the following parameters specify one drilldown:</p>
         
     | 
| 
       127 
128 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       128 
129 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       129 
     | 
    
         
            -
            <li>< 
     | 
| 
       130 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 130 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">--drilldown[label].keys</span> <span class="pre">column</span></code></li>
         
     | 
| 
      
 131 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">--drilldown[label].sortby</span> <span class="pre">-_nsubrecs</span></code></li>
         
     | 
| 
       131 
132 
     | 
    
         
             
            </ul>
         
     | 
| 
       132 
133 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       133 
134 
     | 
    
         
             
            <p>The following parameters specify two drilldowns:</p>
         
     | 
| 
       134 
135 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       135 
136 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       136 
     | 
    
         
            -
            <li>< 
     | 
| 
       137 
     | 
    
         
            -
            <li>< 
     | 
| 
       138 
     | 
    
         
            -
            <li>< 
     | 
| 
       139 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 137 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">--drilldown[label1].keys</span> <span class="pre">column1</span></code></li>
         
     | 
| 
      
 138 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">--drilldown[label1].sortby</span> <span class="pre">-_nsubrecs</span></code></li>
         
     | 
| 
      
 139 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">--drilldown[label2].keys</span> <span class="pre">column2</span></code></li>
         
     | 
| 
      
 140 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">--drilldown[label2].sortby</span> <span class="pre">_key</span></code></li>
         
     | 
| 
       140 
141 
     | 
    
         
             
            </ul>
         
     | 
| 
       141 
142 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       142 
143 
     | 
    
         
             
            </div>
         
     | 
| 
       143 
144 
     | 
    
         
             
            <div class="section" id="usage">
         
     | 
| 
       144 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
       145 
     | 
    
         
            -
            <p>Let's learn about < 
     | 
| 
      
 145 
     | 
    
         
            +
            <h2>7.3.41.3. Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
      
 146 
     | 
    
         
            +
            <p>Let's learn about <code class="docutils literal"><span class="pre">select</span></code> usage with examples. This section shows
         
     | 
| 
       146 
147 
     | 
    
         
             
            many popular usages.</p>
         
     | 
| 
       147 
148 
     | 
    
         
             
            <p>Here are a schema definition and sample data to show usage.</p>
         
     | 
| 
       148 
149 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
         @@ -154,7 +155,7 @@ column_create Entries n_likes COLUMN_SCALAR UInt32 
     | 
|
| 
       154 
155 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], true]
         
     | 
| 
       155 
156 
     | 
    
         
             
            column_create Entries tag COLUMN_SCALAR ShortText
         
     | 
| 
       156 
157 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], true]
         
     | 
| 
       157 
     | 
    
         
            -
            table_create Terms TABLE_PAT_KEY 
     | 
| 
      
 158 
     | 
    
         
            +
            table_create Terms TABLE_PAT_KEY ShortText --default_tokenizer TokenBigram --normalizer NormalizerAuto
         
     | 
| 
       158 
159 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], true]
         
     | 
| 
       159 
160 
     | 
    
         
             
            column_create Terms entries_key_index COLUMN_INDEX|WITH_POSITION Entries _key
         
     | 
| 
       160 
161 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], true]
         
     | 
| 
         @@ -186,19 +187,19 @@ load --table Entries 
     | 
|
| 
       186 
187 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], 5]
         
     | 
| 
       187 
188 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       188 
189 
     | 
    
         
             
            </div>
         
     | 
| 
       189 
     | 
    
         
            -
            <p>There is a table, < 
     | 
| 
      
 190 
     | 
    
         
            +
            <p>There is a table, <code class="docutils literal"><span class="pre">Entries</span></code>, for blog entries. An entry has title,
         
     | 
| 
       190 
191 
     | 
    
         
             
            content, the number of likes for the entry and tag. Title is key of
         
     | 
| 
       191 
     | 
    
         
            -
            < 
     | 
| 
       192 
     | 
    
         
            -
            number of likes is value of < 
     | 
| 
       193 
     | 
    
         
            -
            of < 
     | 
| 
       194 
     | 
    
         
            -
            <p>< 
     | 
| 
       195 
     | 
    
         
            -
            using < 
     | 
| 
       196 
     | 
    
         
            -
            < 
     | 
| 
      
 192 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">Entries</span></code>. Content is value of <code class="docutils literal"><span class="pre">Entries.content</span></code> column. The
         
     | 
| 
      
 193 
     | 
    
         
            +
            number of likes is value of <code class="docutils literal"><span class="pre">Entries.n_likes</span></code> column. Tag is value
         
     | 
| 
      
 194 
     | 
    
         
            +
            of <code class="docutils literal"><span class="pre">Entries.tag</span></code> column.</p>
         
     | 
| 
      
 195 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">Entries._key</span></code> column and <code class="docutils literal"><span class="pre">Entries.content</span></code> column are indexed
         
     | 
| 
      
 196 
     | 
    
         
            +
            using <code class="docutils literal"><span class="pre">TokenBigram</span></code> tokenizer. So both <code class="docutils literal"><span class="pre">Entries._key</span></code> and
         
     | 
| 
      
 197 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">Entries.content</span></code> are fulltext search ready.</p>
         
     | 
| 
       197 
198 
     | 
    
         
             
            <p>OK. The schema and data for examples are ready.</p>
         
     | 
| 
       198 
199 
     | 
    
         
             
            <div class="section" id="simple-usage">
         
     | 
| 
       199 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
      
 200 
     | 
    
         
            +
            <span id="select-simple-usage"></span><h3>7.3.41.3.1. Simple usage<a class="headerlink" href="#simple-usage" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       200 
201 
     | 
    
         
             
            <p>Here is the most simple usage with the above schema and data. It outputs
         
     | 
| 
       201 
     | 
    
         
            -
            all records in < 
     | 
| 
      
 202 
     | 
    
         
            +
            all records in <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
         
     | 
| 
       202 
203 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       203 
204 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries
         
     | 
| 
       204 
205 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -277,29 +278,29 @@ all records in <tt class="docutils literal"><span class="pre">Entries</span></tt 
     | 
|
| 
       277 
278 
     | 
    
         
             
            <p>Why does the command output all records? There are two reasons. The
         
     | 
| 
       278 
279 
     | 
    
         
             
            first reason is that the command doesn't specify any search
         
     | 
| 
       279 
280 
     | 
    
         
             
            conditions. No search condition means all records are matched. The
         
     | 
| 
       280 
     | 
    
         
            -
            second reason is that the number of all records is 5. < 
     | 
| 
      
 281 
     | 
    
         
            +
            second reason is that the number of all records is 5. <code class="docutils literal"><span class="pre">select</span></code>
         
     | 
| 
       281 
282 
     | 
    
         
             
            command outputs 10 records at a maximum by default. There are only 5
         
     | 
| 
       282 
283 
     | 
    
         
             
            records. It is less than 10. So the command outputs all records.</p>
         
     | 
| 
       283 
284 
     | 
    
         
             
            </div>
         
     | 
| 
       284 
285 
     | 
    
         
             
            <div class="section" id="search-conditions">
         
     | 
| 
       285 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
       286 
     | 
    
         
            -
            <p>Search conditions are specified by < 
     | 
| 
       287 
     | 
    
         
            -
            also specify both < 
     | 
| 
       288 
     | 
    
         
            -
            records must be matched against both < 
     | 
| 
      
 286 
     | 
    
         
            +
            <h3>7.3.41.3.2. Search conditions<a class="headerlink" href="#search-conditions" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
      
 287 
     | 
    
         
            +
            <p>Search conditions are specified by <code class="docutils literal"><span class="pre">query</span></code> or <code class="docutils literal"><span class="pre">filter</span></code>. You can
         
     | 
| 
      
 288 
     | 
    
         
            +
            also specify both <code class="docutils literal"><span class="pre">query</span></code> and <code class="docutils literal"><span class="pre">filter</span></code>. It means that selected
         
     | 
| 
      
 289 
     | 
    
         
            +
            records must be matched against both <code class="docutils literal"><span class="pre">query</span></code> and <code class="docutils literal"><span class="pre">filter</span></code>.</p>
         
     | 
| 
       289 
290 
     | 
    
         
             
            <div class="section" id="search-condition-query">
         
     | 
| 
       290 
     | 
    
         
            -
            <h4>7.3. 
     | 
| 
       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, < 
     | 
| 
      
 291 
     | 
    
         
            +
            <h4>7.3.41.3.2.1. Search condition: <code class="docutils literal"><span class="pre">query</span></code><a class="headerlink" href="#search-condition-query" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 292 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">query</span></code> is designed for search box in Web page. Imagine a search box
         
     | 
| 
      
 293 
     | 
    
         
            +
            in google.com. You specify search conditions for <code class="docutils literal"><span class="pre">query</span></code> as space
         
     | 
| 
      
 294 
     | 
    
         
            +
            separated keywords. For example, <code class="docutils literal"><span class="pre">search</span> <span class="pre">engine</span></code> means a matched
         
     | 
| 
      
 295 
     | 
    
         
            +
            record should contain two words, <code class="docutils literal"><span class="pre">search</span></code> and <code class="docutils literal"><span class="pre">engine</span></code>.</p>
         
     | 
| 
      
 296 
     | 
    
         
            +
            <p>Normally, <code class="docutils literal"><span class="pre">query</span></code> parameter is used for specifying fulltext search
         
     | 
| 
       296 
297 
     | 
    
         
             
            conditions. It can be used for non fulltext search conditions but
         
     | 
| 
       297 
     | 
    
         
            -
            < 
     | 
| 
       298 
     | 
    
         
            -
            <p>< 
     | 
| 
       299 
     | 
    
         
            -
            < 
     | 
| 
       300 
     | 
    
         
            -
            conditions. < 
     | 
| 
       301 
     | 
    
         
            -
            matched against < 
     | 
| 
       302 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 298 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">filter</span></code> is used for the propose.</p>
         
     | 
| 
      
 299 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">query</span></code> parameter is used with <code class="docutils literal"><span class="pre">match_columns</span></code> parameter when
         
     | 
| 
      
 300 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">query</span></code> parameter is used for specifying fulltext search
         
     | 
| 
      
 301 
     | 
    
         
            +
            conditions. <code class="docutils literal"><span class="pre">match_columns</span></code> specifies which columnes and indexes are
         
     | 
| 
      
 302 
     | 
    
         
            +
            matched against <code class="docutils literal"><span class="pre">query</span></code>.</p>
         
     | 
| 
      
 303 
     | 
    
         
            +
            <p>Here is a simple <code class="docutils literal"><span class="pre">query</span></code> usage example.</p>
         
     | 
| 
       303 
304 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       304 
305 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query fast
         
     | 
| 
       305 
306 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -354,16 +355,16 @@ matched against <tt class="docutils literal"><span class="pre">query</span></tt> 
     | 
|
| 
       354 
355 
     | 
    
         
             
            # ]
         
     | 
| 
       355 
356 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       356 
357 
     | 
    
         
             
            </div>
         
     | 
| 
       357 
     | 
    
         
            -
            <p>The < 
     | 
| 
       358 
     | 
    
         
            -
            in < 
     | 
| 
       359 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 358 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain a word <code class="docutils literal"><span class="pre">fast</span></code>
         
     | 
| 
      
 359 
     | 
    
         
            +
            in <code class="docutils literal"><span class="pre">content</span></code> column value from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
         
     | 
| 
      
 360 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">query</span></code> has query syntax but its deatils aren't described here. See
         
     | 
| 
       360 
361 
     | 
    
         
             
            <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a> for datails.</p>
         
     | 
| 
       361 
362 
     | 
    
         
             
            </div>
         
     | 
| 
       362 
363 
     | 
    
         
             
            <div class="section" id="search-condition-filter">
         
     | 
| 
       363 
     | 
    
         
            -
            <h4>7.3. 
     | 
| 
       364 
     | 
    
         
            -
            <p>< 
     | 
| 
       365 
     | 
    
         
            -
            search conditions for < 
     | 
| 
       366 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 364 
     | 
    
         
            +
            <h4>7.3.41.3.2.2. Search condition: <code class="docutils literal"><span class="pre">filter</span></code><a class="headerlink" href="#search-condition-filter" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 365 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">filter</span></code> is designed for complex search conditions. You specify
         
     | 
| 
      
 366 
     | 
    
         
            +
            search conditions for <code class="docutils literal"><span class="pre">filter</span></code> as ECMAScript like syntax.</p>
         
     | 
| 
      
 367 
     | 
    
         
            +
            <p>Here is a simple <code class="docutils literal"><span class="pre">filter</span></code> usage example.</p>
         
     | 
| 
       367 
368 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       368 
369 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --filter 'content @ "fast" && _key == "Groonga"'
         
     | 
| 
       369 
370 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -411,20 +412,20 @@ search conditions for <tt class="docutils literal"><span class="pre">filter</spa 
     | 
|
| 
       411 
412 
     | 
    
         
             
            # ]
         
     | 
| 
       412 
413 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       413 
414 
     | 
    
         
             
            </div>
         
     | 
| 
       414 
     | 
    
         
            -
            <p>The < 
     | 
| 
       415 
     | 
    
         
            -
            in < 
     | 
| 
       416 
     | 
    
         
            -
            < 
     | 
| 
       417 
     | 
    
         
            -
            < 
     | 
| 
       418 
     | 
    
         
            -
            < 
     | 
| 
       419 
     | 
    
         
            -
            < 
     | 
| 
       420 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 415 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain a word <code class="docutils literal"><span class="pre">fast</span></code>
         
     | 
| 
      
 416 
     | 
    
         
            +
            in <code class="docutils literal"><span class="pre">content</span></code> column value and has <code class="docutils literal"><span class="pre">Groonga</span></code> as <code class="docutils literal"><span class="pre">_key</span></code> from
         
     | 
| 
      
 417 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">Entries</span></code> table. There are three operators in the command, <code class="docutils literal"><span class="pre">@</span></code>,
         
     | 
| 
      
 418 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">&&</span></code> and <code class="docutils literal"><span class="pre">==</span></code>. <code class="docutils literal"><span class="pre">@</span></code> is fulltext search operator. <code class="docutils literal"><span class="pre">&&</span></code> and
         
     | 
| 
      
 419 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">==</span></code> are the same as ECMAScript. <code class="docutils literal"><span class="pre">&&</span></code> is logical AND operator and
         
     | 
| 
      
 420 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">==</span></code> is equality operator.</p>
         
     | 
| 
      
 421 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">filter</span></code> has more operators and syntax like grouping by <code class="docutils literal"><span class="pre">(...)</span></code>
         
     | 
| 
       421 
422 
     | 
    
         
             
            its details aren't described here. See
         
     | 
| 
       422 
423 
     | 
    
         
             
            <a class="reference internal" href="../grn_expr/script_syntax.html"><em>Script syntax</em></a> for datails.</p>
         
     | 
| 
       423 
424 
     | 
    
         
             
            </div>
         
     | 
| 
       424 
425 
     | 
    
         
             
            </div>
         
     | 
| 
       425 
426 
     | 
    
         
             
            <div class="section" id="paging">
         
     | 
| 
       426 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
       427 
     | 
    
         
            -
            <p>You can specify range of outputted records by < 
     | 
| 
      
 427 
     | 
    
         
            +
            <h3>7.3.41.3.3. Paging<a class="headerlink" href="#paging" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
      
 428 
     | 
    
         
            +
            <p>You can specify range of outputted records by <code class="docutils literal"><span class="pre">offset</span></code> and <code class="docutils literal"><span class="pre">limit</span></code>.
         
     | 
| 
       428 
429 
     | 
    
         
             
            Here is an example to output only the 2nd record.</p>
         
     | 
| 
       429 
430 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       430 
431 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --offset 1 --limit 1
         
     | 
| 
         @@ -473,15 +474,15 @@ Here is an example to output only the 2nd record.</p> 
     | 
|
| 
       473 
474 
     | 
    
         
             
            # ]
         
     | 
| 
       474 
475 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       475 
476 
     | 
    
         
             
            </div>
         
     | 
| 
       476 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 477 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">offset</span></code> is zero-based. <code class="docutils literal"><span class="pre">--offset</span> <span class="pre">1</span></code> means output range is
         
     | 
| 
       477 
478 
     | 
    
         
             
            started from the 2nd record.</p>
         
     | 
| 
       478 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 479 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">limit</span></code> specifies the max number of output records. <code class="docutils literal"><span class="pre">--limit</span> <span class="pre">1</span></code>
         
     | 
| 
       479 
480 
     | 
    
         
             
            means the number of output records is 1 at a maximium. If no records
         
     | 
| 
       480 
     | 
    
         
            -
            are matched, < 
     | 
| 
      
 481 
     | 
    
         
            +
            are matched, <code class="docutils literal"><span class="pre">select</span></code> command outputs no records.</p>
         
     | 
| 
       481 
482 
     | 
    
         
             
            </div>
         
     | 
| 
       482 
483 
     | 
    
         
             
            <div class="section" id="the-total-number-of-records">
         
     | 
| 
       483 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
       484 
     | 
    
         
            -
            <p>You can use < 
     | 
| 
      
 484 
     | 
    
         
            +
            <h3>7.3.41.3.4. The total number of records<a class="headerlink" href="#the-total-number-of-records" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
      
 485 
     | 
    
         
            +
            <p>You can use <code class="docutils literal"><span class="pre">--limit</span> <span class="pre">0</span></code> to retrieve the total number of recrods
         
     | 
| 
       485 
486 
     | 
    
         
             
            without any contents of records.</p>
         
     | 
| 
       486 
487 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       487 
488 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --limit 0
         
     | 
| 
         @@ -523,19 +524,19 @@ without any contents of records.</p> 
     | 
|
| 
       523 
524 
     | 
    
         
             
            # ]
         
     | 
| 
       524 
525 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       525 
526 
     | 
    
         
             
            </div>
         
     | 
| 
       526 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 527 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">--limit</span> <span class="pre">0</span></code> is also useful for retrieving only the number of matched
         
     | 
| 
       527 
528 
     | 
    
         
             
            records.</p>
         
     | 
| 
       528 
529 
     | 
    
         
             
            </div>
         
     | 
| 
       529 
530 
     | 
    
         
             
            <div class="section" id="drilldown">
         
     | 
| 
       530 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
      
 531 
     | 
    
         
            +
            <h3>7.3.41.3.5. Drilldown<a class="headerlink" href="#drilldown" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       531 
532 
     | 
    
         
             
            <p>You can get additional grouped results against the search result in
         
     | 
| 
       532 
     | 
    
         
            -
            one < 
     | 
| 
       533 
     | 
    
         
            -
            <span class="pre">``select</span></ 
     | 
| 
      
 533 
     | 
    
         
            +
            one <code class="docutils literal"><span class="pre">select</span></code>. You need to use two or more <code class="docutils literal"><span class="pre">SELECT``s</span> <span class="pre">in</span> <span class="pre">SQL</span> <span class="pre">but</span>
         
     | 
| 
      
 534 
     | 
    
         
            +
            <span class="pre">``select</span></code> in Groonga can do it in one <code class="docutils literal"><span class="pre">select</span></code>.</p>
         
     | 
| 
       534 
535 
     | 
    
         
             
            <p>This feature is called as <a class="reference external" href="http://en.wikipedia.org/wiki/Drill_down">drilldown</a> in Groonga. It's also
         
     | 
| 
       535 
536 
     | 
    
         
             
            called as <a class="reference external" href="http://en.wikipedia.org/wiki/Faceted_search">faceted search</a> in other search
         
     | 
| 
       536 
537 
     | 
    
         
             
            engine.</p>
         
     | 
| 
       537 
538 
     | 
    
         
             
            <p>For example, think about the following situation.</p>
         
     | 
| 
       538 
     | 
    
         
            -
            <p>You search entries that has < 
     | 
| 
      
 539 
     | 
    
         
            +
            <p>You search entries that has <code class="docutils literal"><span class="pre">fast</span></code> word:</p>
         
     | 
| 
       539 
540 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       540 
541 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --filter 'content @ "fast"'
         
     | 
| 
       541 
542 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -590,9 +591,9 @@ engine.</p> 
     | 
|
| 
       590 
591 
     | 
    
         
             
            # ]
         
     | 
| 
       591 
592 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       592 
593 
     | 
    
         
             
            </div>
         
     | 
| 
       593 
     | 
    
         
            -
            <p>You want to use < 
     | 
| 
       594 
     | 
    
         
            -
            < 
     | 
| 
       595 
     | 
    
         
            -
            suitable tag until you see the result of < 
     | 
| 
      
 594 
     | 
    
         
            +
            <p>You want to use <code class="docutils literal"><span class="pre">tag</span></code> for additional search condition like
         
     | 
| 
      
 595 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">--filter</span> <span class="pre">'content</span> <span class="pre">@</span> <span class="pre">"fast"</span> <span class="pre">&&</span> <span class="pre">tag</span> <span class="pre">==</span> <span class="pre">"???"</span></code>. But you don't know
         
     | 
| 
      
 596 
     | 
    
         
            +
            suitable tag until you see the result of <code class="docutils literal"><span class="pre">content</span> <span class="pre">@</span> <span class="pre">"fast"</span></code>.</p>
         
     | 
| 
       596 
597 
     | 
    
         
             
            <p>If you know the number of matched records of each available tag, you
         
     | 
| 
       597 
598 
     | 
    
         
             
            can choose suitable tag. You can use drilldown for the case:</p>
         
     | 
| 
       598 
599 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
         @@ -668,7 +669,7 @@ can choose suitable tag. You can use drilldown for the case:</p> 
     | 
|
| 
       668 
669 
     | 
    
         
             
            # ]
         
     | 
| 
       669 
670 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       670 
671 
     | 
    
         
             
            </div>
         
     | 
| 
       671 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 672 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">--drilldown</span> <span class="pre">tag</span></code> returns a list of pair of available tag and the
         
     | 
| 
       672 
673 
     | 
    
         
             
            number of matched records. You can avoid "no hit search" case by
         
     | 
| 
       673 
674 
     | 
    
         
             
            choosing a tag from the list. You can also avoid "too many search
         
     | 
| 
       674 
675 
     | 
    
         
             
            results" case by choosing a tag that the number of matched records is
         
     | 
| 
         @@ -684,18 +685,18 @@ search query by their keyboard. They just click a link.)</li> 
     | 
|
| 
       684 
685 
     | 
    
         
             
            <p>Groonga supports not only counting grouped records but also finding
         
     | 
| 
       685 
686 
     | 
    
         
             
            the maximum and/or minimum value from grouped records, summing values
         
     | 
| 
       686 
687 
     | 
    
         
             
            in grouped records and so on. See
         
     | 
| 
       687 
     | 
    
         
            -
            <a class="reference internal" href="#select-drilldown-related-parameters">< 
     | 
| 
      
 688 
     | 
    
         
            +
            <a class="reference internal" href="#select-drilldown-related-parameters"><span>Drilldown related parameters</span></a> for details.</p>
         
     | 
| 
       688 
689 
     | 
    
         
             
            </div>
         
     | 
| 
       689 
690 
     | 
    
         
             
            </div>
         
     | 
| 
       690 
691 
     | 
    
         
             
            <div class="section" id="parameters">
         
     | 
| 
       691 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
      
 692 
     | 
    
         
            +
            <h2>7.3.41.4. Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
       692 
693 
     | 
    
         
             
            <p>This section describes all parameters. Parameters are categorized.</p>
         
     | 
| 
       693 
694 
     | 
    
         
             
            <div class="section" id="required-parameter">
         
     | 
| 
       694 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
       695 
     | 
    
         
            -
            <p>There is a required parameter, < 
     | 
| 
      
 695 
     | 
    
         
            +
            <h3>7.3.41.4.1. Required parameter<a class="headerlink" href="#required-parameter" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
      
 696 
     | 
    
         
            +
            <p>There is a required parameter, <code class="docutils literal"><span class="pre">table</span></code>.</p>
         
     | 
| 
       696 
697 
     | 
    
         
             
            <div class="section" id="table">
         
     | 
| 
       697 
     | 
    
         
            -
            <span id="select-table"></span><h4>7.3. 
     | 
| 
       698 
     | 
    
         
            -
            <p>Specifies a table to be searched. < 
     | 
| 
      
 698 
     | 
    
         
            +
            <span id="select-table"></span><h4>7.3.41.4.1.1. <code class="docutils literal"><span class="pre">table</span></code><a class="headerlink" href="#table" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 699 
     | 
    
         
            +
            <p>Specifies a table to be searched. <code class="docutils literal"><span class="pre">table</span></code> must be specified.</p>
         
     | 
| 
       699 
700 
     | 
    
         
             
            <p>If nonexistent table is specified, an error is returned.</p>
         
     | 
| 
       700 
701 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       701 
702 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Nonexistent
         
     | 
| 
         @@ -709,7 +710,7 @@ in grouped records and so on. See 
     | 
|
| 
       709 
710 
     | 
    
         
             
            #       [
         
     | 
| 
       710 
711 
     | 
    
         
             
            #         "grn_select",
         
     | 
| 
       711 
712 
     | 
    
         
             
            #         "proc.c",
         
     | 
| 
       712 
     | 
    
         
            -
            #          
     | 
| 
      
 713 
     | 
    
         
            +
            #         1217
         
     | 
| 
       713 
714 
     | 
    
         
             
            #       ]
         
     | 
| 
       714 
715 
     | 
    
         
             
            #     ]
         
     | 
| 
       715 
716 
     | 
    
         
             
            #   ]
         
     | 
| 
         @@ -719,25 +720,25 @@ in grouped records and so on. See 
     | 
|
| 
       719 
720 
     | 
    
         
             
            </div>
         
     | 
| 
       720 
721 
     | 
    
         
             
            </div>
         
     | 
| 
       721 
722 
     | 
    
         
             
            <div class="section" id="search-related-parameters">
         
     | 
| 
       722 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
       723 
     | 
    
         
            -
            <p>There are search related parameters. Typically, < 
     | 
| 
       724 
     | 
    
         
            -
            < 
     | 
| 
       725 
     | 
    
         
            -
            box. < 
     | 
| 
      
 723 
     | 
    
         
            +
            <span id="select-search-related-parameters"></span><h3>7.3.41.4.2. Search related parameters<a class="headerlink" href="#search-related-parameters" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
      
 724 
     | 
    
         
            +
            <p>There are search related parameters. Typically, <code class="docutils literal"><span class="pre">match_columns</span></code> and
         
     | 
| 
      
 725 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">query</span></code> parameters are used for implementing a search
         
     | 
| 
      
 726 
     | 
    
         
            +
            box. <code class="docutils literal"><span class="pre">filter</span></code> parameters is used for implementing complex search
         
     | 
| 
       726 
727 
     | 
    
         
             
            feature.</p>
         
     | 
| 
       727 
     | 
    
         
            -
            <p>If both < 
     | 
| 
       728 
     | 
    
         
            -
            be matched against both < 
     | 
| 
       729 
     | 
    
         
            -
            and < 
     | 
| 
      
 728 
     | 
    
         
            +
            <p>If both <code class="docutils literal"><span class="pre">query</span></code> and <code class="docutils literal"><span class="pre">filter</span></code> are specified, selected records must
         
     | 
| 
      
 729 
     | 
    
         
            +
            be matched against both <code class="docutils literal"><span class="pre">query</span></code> and <code class="docutils literal"><span class="pre">filter</span></code>. If both <code class="docutils literal"><span class="pre">query</span></code>
         
     | 
| 
      
 730 
     | 
    
         
            +
            and <code class="docutils literal"><span class="pre">filter</span></code> aren't specified, all records are selected.</p>
         
     | 
| 
       730 
731 
     | 
    
         
             
            <div class="section" id="match-columns">
         
     | 
| 
       731 
     | 
    
         
            -
            <span id="select-match-columns"></span><h4>7.3. 
     | 
| 
      
 732 
     | 
    
         
            +
            <span id="select-match-columns"></span><h4>7.3.41.4.2.1. <code class="docutils literal"><span class="pre">match_columns</span></code><a class="headerlink" href="#match-columns" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
       732 
733 
     | 
    
         
             
            <p>Specifies the default target column for fulltext search by
         
     | 
| 
       733 
     | 
    
         
            -
            < 
     | 
| 
       734 
     | 
    
         
            -
            specified in < 
     | 
| 
       735 
     | 
    
         
            -
            < 
     | 
| 
       736 
     | 
    
         
            -
            not. < 
     | 
| 
      
 734 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">query</span></code> parameter value. A target column for fulltext search can be
         
     | 
| 
      
 735 
     | 
    
         
            +
            specified in <code class="docutils literal"><span class="pre">query</span></code> parameter. The difference between
         
     | 
| 
      
 736 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">match_columns</span></code> and <code class="docutils literal"><span class="pre">query</span></code> is whether weight is supported or
         
     | 
| 
      
 737 
     | 
    
         
            +
            not. <code class="docutils literal"><span class="pre">match_columns</span></code> supports weight but <code class="docutils literal"><span class="pre">query</span></code> doesn't.</p>
         
     | 
| 
       737 
738 
     | 
    
         
             
            <p>Weight is relative importance of target column. A higher weight target
         
     | 
| 
       738 
739 
     | 
    
         
             
            column gets more hit score rather than a lower weight target column
         
     | 
| 
       739 
740 
     | 
    
         
             
            when a record is matched by fulltext search. The default weight is 1.</p>
         
     | 
| 
       740 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 741 
     | 
    
         
            +
            <p>Here is a simple <code class="docutils literal"><span class="pre">match_columns</span></code> usage example.</p>
         
     | 
| 
       741 
742 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       742 
743 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query fast --output_columns '_key, _score'
         
     | 
| 
       743 
744 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -774,18 +775,18 @@ when a record is matched by fulltext search. The default weight is 1.</p> 
     | 
|
| 
       774 
775 
     | 
    
         
             
            # ]
         
     | 
| 
       775 
776 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       776 
777 
     | 
    
         
             
            </div>
         
     | 
| 
       777 
     | 
    
         
            -
            <p>< 
     | 
| 
       778 
     | 
    
         
            -
            fulltext search is < 
     | 
| 
       779 
     | 
    
         
            -
            is 1. < 
     | 
| 
       780 
     | 
    
         
            -
            command outputs < 
     | 
| 
      
 778 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">--match_columns</span> <span class="pre">content</span></code> means the default target column for
         
     | 
| 
      
 779 
     | 
    
         
            +
            fulltext search is <code class="docutils literal"><span class="pre">content</span></code> column and its weight
         
     | 
| 
      
 780 
     | 
    
         
            +
            is 1. <code class="docutils literal"><span class="pre">--output_columns</span> <span class="pre">'_key,</span> <span class="pre">_score'</span></code> means that the <code class="docutils literal"><span class="pre">select</span></code>
         
     | 
| 
      
 781 
     | 
    
         
            +
            command outputs <code class="docutils literal"><span class="pre">_key</span></code> value and <code class="docutils literal"><span class="pre">_score</span></code> value for matched
         
     | 
| 
       781 
782 
     | 
    
         
             
            records.</p>
         
     | 
| 
       782 
     | 
    
         
            -
            <p>Pay attention to < 
     | 
| 
       783 
     | 
    
         
            -
            matched counts against < 
     | 
| 
       784 
     | 
    
         
            -
            < 
     | 
| 
       785 
     | 
    
         
            -
            is 1 means that < 
     | 
| 
       786 
     | 
    
         
            -
            fact that < 
     | 
| 
       787 
     | 
    
         
            -
            < 
     | 
| 
       788 
     | 
    
         
            -
            <p>To specify weight, < 
     | 
| 
      
 783 
     | 
    
         
            +
            <p>Pay attention to <code class="docutils literal"><span class="pre">_score</span></code> value. <code class="docutils literal"><span class="pre">_score</span></code> value is the number of
         
     | 
| 
      
 784 
     | 
    
         
            +
            matched counts against <code class="docutils literal"><span class="pre">query</span></code> parameter value. In the example,
         
     | 
| 
      
 785 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">query</span></code> parameter value is <code class="docutils literal"><span class="pre">fast</span></code>. The fact that <code class="docutils literal"><span class="pre">_score</span></code> value
         
     | 
| 
      
 786 
     | 
    
         
            +
            is 1 means that <code class="docutils literal"><span class="pre">fast</span></code> appers in <code class="docutils literal"><span class="pre">content</span></code> column only once.  The
         
     | 
| 
      
 787 
     | 
    
         
            +
            fact that <code class="docutils literal"><span class="pre">_score</span></code> value is 2 means that <code class="docutils literal"><span class="pre">fast</span></code> appears in
         
     | 
| 
      
 788 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">content</span></code> column twice.</p>
         
     | 
| 
      
 789 
     | 
    
         
            +
            <p>To specify weight, <code class="docutils literal"><span class="pre">column</span> <span class="pre">*</span> <span class="pre">weight</span></code> syntax is used. Here is a
         
     | 
| 
       789 
790 
     | 
    
         
             
            weight usage example.</p>
         
     | 
| 
       790 
791 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       791 
792 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns 'content * 2' --query fast --output_columns '_key, _score'
         
     | 
| 
         @@ -823,17 +824,17 @@ weight usage example.</p> 
     | 
|
| 
       823 
824 
     | 
    
         
             
            # ]
         
     | 
| 
       824 
825 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       825 
826 
     | 
    
         
             
            </div>
         
     | 
| 
       826 
     | 
    
         
            -
            <p>< 
     | 
| 
       827 
     | 
    
         
            -
            fulltext search is < 
     | 
| 
       828 
     | 
    
         
            -
            <p>Pay attention to < 
     | 
| 
      
 827 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">--match_columns</span> <span class="pre">'content</span> <span class="pre">*</span> <span class="pre">2'</span></code> means the default target column for
         
     | 
| 
      
 828 
     | 
    
         
            +
            fulltext search is <code class="docutils literal"><span class="pre">content</span></code> column and its weight is 2.</p>
         
     | 
| 
      
 829 
     | 
    
         
            +
            <p>Pay attention to <code class="docutils literal"><span class="pre">_score</span></code> value. <code class="docutils literal"><span class="pre">_score</span></code> value is doubled because
         
     | 
| 
       829 
830 
     | 
    
         
             
            weight is 2.</p>
         
     | 
| 
       830 
831 
     | 
    
         
             
            <p>You can specify one or more columns as the default target columns for
         
     | 
| 
       831 
832 
     | 
    
         
             
            fulltext search. If one or more columns are specified, fulltext search
         
     | 
| 
       832 
833 
     | 
    
         
             
            is done for all columns and scores are accumulated. If one of the
         
     | 
| 
       833 
     | 
    
         
            -
            columns is matched against < 
     | 
| 
      
 834 
     | 
    
         
            +
            columns is matched against <code class="docutils literal"><span class="pre">query</span></code> parameter value, the record is
         
     | 
| 
       834 
835 
     | 
    
         
             
            treated as matched.</p>
         
     | 
| 
       835 
     | 
    
         
            -
            <p>To specify one or more columns, < 
     | 
| 
       836 
     | 
    
         
            -
            <span class="pre">weight2</span> <span class="pre">||</span> <span class="pre">...</span></ 
     | 
| 
      
 836 
     | 
    
         
            +
            <p>To specify one or more columns, <code class="docutils literal"><span class="pre">column1</span> <span class="pre">*</span> <span class="pre">weight1</span> <span class="pre">||</span> <span class="pre">column2</span> <span class="pre">*</span>
         
     | 
| 
      
 837 
     | 
    
         
            +
            <span class="pre">weight2</span> <span class="pre">||</span> <span class="pre">...</span></code> syntax is used. <code class="docutils literal"><span class="pre">*</span> <span class="pre">weight</span></code> can be omitted. If it is
         
     | 
| 
       837 
838 
     | 
    
         
             
            omitted, 1 is used for weight. Here is a one or more columns usage
         
     | 
| 
       838 
839 
     | 
    
         
             
            example.</p>
         
     | 
| 
       839 
840 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
         @@ -868,23 +869,23 @@ example.</p> 
     | 
|
| 
       868 
869 
     | 
    
         
             
            # ]
         
     | 
| 
       869 
870 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       870 
871 
     | 
    
         
             
            </div>
         
     | 
| 
       871 
     | 
    
         
            -
            <p>< 
     | 
| 
       872 
     | 
    
         
            -
            columns for fulltext search are < 
     | 
| 
       873 
     | 
    
         
            -
            < 
     | 
| 
       874 
     | 
    
         
            -
            is 1. This weight allocation means < 
     | 
| 
       875 
     | 
    
         
            -
            important rather than < 
     | 
| 
      
 872 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">--match_columns</span> <span class="pre">'_key</span> <span class="pre">*</span> <span class="pre">10</span> <span class="pre">||</span> <span class="pre">content'</span></code> means the default target
         
     | 
| 
      
 873 
     | 
    
         
            +
            columns for fulltext search are <code class="docutils literal"><span class="pre">_key</span></code> and <code class="docutils literal"><span class="pre">content</span></code> columns and
         
     | 
| 
      
 874 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">_key</span></code> column's weight is 10 and <code class="docutils literal"><span class="pre">content</span></code> column's weight
         
     | 
| 
      
 875 
     | 
    
         
            +
            is 1. This weight allocation means <code class="docutils literal"><span class="pre">_key</span></code> column value is more
         
     | 
| 
      
 876 
     | 
    
         
            +
            important rather than <code class="docutils literal"><span class="pre">content</span></code> column value. In this example, title
         
     | 
| 
       876 
877 
     | 
    
         
             
            of blog entry is more important rather thatn content of blog entry.</p>
         
     | 
| 
       877 
878 
     | 
    
         
             
            </div>
         
     | 
| 
       878 
879 
     | 
    
         
             
            <div class="section" id="query">
         
     | 
| 
       879 
     | 
    
         
            -
            <span id="select-query"></span><h4>7.3. 
     | 
| 
      
 880 
     | 
    
         
            +
            <span id="select-query"></span><h4>7.3.41.4.2.2. <code class="docutils literal"><span class="pre">query</span></code><a class="headerlink" href="#query" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
       880 
881 
     | 
    
         
             
            <p>Specifies the query text. Normally, it is used for fulltext search
         
     | 
| 
       881 
     | 
    
         
            -
            with < 
     | 
| 
      
 882 
     | 
    
         
            +
            with <code class="docutils literal"><span class="pre">match_columns</span></code> parameter. <code class="docutils literal"><span class="pre">query</span></code> parameter is designed for
         
     | 
| 
       882 
883 
     | 
    
         
             
            a fulltext search form in a Web page. A query text should be formatted
         
     | 
| 
       883 
884 
     | 
    
         
             
            in <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a>. The syntax is similar to common search
         
     | 
| 
       884 
     | 
    
         
            -
            form like Google's search form. For example, < 
     | 
| 
       885 
     | 
    
         
            -
            that groonga searches records that contain both < 
     | 
| 
       886 
     | 
    
         
            -
            < 
     | 
| 
       887 
     | 
    
         
            -
            contain either < 
     | 
| 
      
 885 
     | 
    
         
            +
            form like Google's search form. For example, <code class="docutils literal"><span class="pre">word1</span> <span class="pre">word2</span></code> means
         
     | 
| 
      
 886 
     | 
    
         
            +
            that groonga searches records that contain both <code class="docutils literal"><span class="pre">word1</span></code> and
         
     | 
| 
      
 887 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">word2</span></code>. <code class="docutils literal"><span class="pre">word1</span> <span class="pre">OR</span> <span class="pre">word2</span></code> means that groogna searches records that
         
     | 
| 
      
 888 
     | 
    
         
            +
            contain either <code class="docutils literal"><span class="pre">word1</span></code> or <code class="docutils literal"><span class="pre">word2</span></code>.</p>
         
     | 
| 
       888 
889 
     | 
    
         
             
            <p>Here is a simple logical and search example.</p>
         
     | 
| 
       889 
890 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       890 
891 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query "fast groonga"
         
     | 
| 
         @@ -933,8 +934,8 @@ contain either <tt class="docutils literal"><span class="pre">word1</span></tt> 
     | 
|
| 
       933 
934 
     | 
    
         
             
            # ]
         
     | 
| 
       934 
935 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       935 
936 
     | 
    
         
             
            </div>
         
     | 
| 
       936 
     | 
    
         
            -
            <p>The < 
     | 
| 
       937 
     | 
    
         
            -
            < 
     | 
| 
      
 937 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain two words
         
     | 
| 
      
 938 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">fast</span></code> and <code class="docutils literal"><span class="pre">groonga</span></code> in <code class="docutils literal"><span class="pre">content</span></code> column value from <code class="docutils literal"><span class="pre">Entries</span></code>
         
     | 
| 
       938 
939 
     | 
    
         
             
            table.</p>
         
     | 
| 
       939 
940 
     | 
    
         
             
            <p>Here is a simple logical or search example.</p>
         
     | 
| 
       940 
941 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
         @@ -991,14 +992,14 @@ table.</p> 
     | 
|
| 
       991 
992 
     | 
    
         
             
            # ]
         
     | 
| 
       992 
993 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       993 
994 
     | 
    
         
             
            </div>
         
     | 
| 
       994 
     | 
    
         
            -
            <p>The < 
     | 
| 
       995 
     | 
    
         
            -
            < 
     | 
| 
       996 
     | 
    
         
            -
            < 
     | 
| 
      
 995 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain one of two words
         
     | 
| 
      
 996 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">groonga</span></code> or <code class="docutils literal"><span class="pre">mroonga</span></code> in <code class="docutils literal"><span class="pre">content</span></code> column value from
         
     | 
| 
      
 997 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
         
     | 
| 
       997 
998 
     | 
    
         
             
            <p>See <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a> for other syntax.</p>
         
     | 
| 
       998 
999 
     | 
    
         
             
            <p>It can be used for not only fulltext search but also other
         
     | 
| 
       999 
     | 
    
         
            -
            conditions. For example, < 
     | 
| 
       1000 
     | 
    
         
            -
            < 
     | 
| 
       1001 
     | 
    
         
            -
            value of < 
     | 
| 
      
 1000 
     | 
    
         
            +
            conditions. For example, <code class="docutils literal"><span class="pre">column:value</span></code> means the value of
         
     | 
| 
      
 1001 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">column</span></code> column is equal to <code class="docutils literal"><span class="pre">value</span></code>. <code class="docutils literal"><span class="pre">column:<value</span></code> means the
         
     | 
| 
      
 1002 
     | 
    
         
            +
            value of <code class="docutils literal"><span class="pre">column</span></code> column is less than <code class="docutils literal"><span class="pre">value</span></code>.</p>
         
     | 
| 
       1002 
1003 
     | 
    
         
             
            <p>Here is a simple equality operator search example.</p>
         
     | 
| 
       1003 
1004 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1004 
1005 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --query _key:Groonga
         
     | 
| 
         @@ -1047,8 +1048,8 @@ value of <tt class="docutils literal"><span class="pre">column</span></tt> colum 
     | 
|
| 
       1047 
1048 
     | 
    
         
             
            # ]
         
     | 
| 
       1048 
1049 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1049 
1050 
     | 
    
         
             
            </div>
         
     | 
| 
       1050 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1051 
     | 
    
         
            -
            < 
     | 
| 
      
 1051 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that <code class="docutils literal"><span class="pre">_key</span></code> column value is
         
     | 
| 
      
 1052 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">Groonga</span></code> from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
         
     | 
| 
       1052 
1053 
     | 
    
         
             
            <p>Here is a simple less than operator search example.</p>
         
     | 
| 
       1053 
1054 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1054 
1055 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --query n_likes:<11
         
     | 
| 
         @@ -1118,23 +1119,23 @@ value of <tt class="docutils literal"><span class="pre">column</span></tt> colum 
     | 
|
| 
       1118 
1119 
     | 
    
         
             
            # ]
         
     | 
| 
       1119 
1120 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1120 
1121 
     | 
    
         
             
            </div>
         
     | 
| 
       1121 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1122 
     | 
    
         
            -
            is less than < 
     | 
| 
      
 1122 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that <code class="docutils literal"><span class="pre">n_likes</span></code> column value
         
     | 
| 
      
 1123 
     | 
    
         
            +
            is less than <code class="docutils literal"><span class="pre">11</span></code> from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
         
     | 
| 
       1123 
1124 
     | 
    
         
             
            <p>See <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a> for other operations.</p>
         
     | 
| 
       1124 
1125 
     | 
    
         
             
            </div>
         
     | 
| 
       1125 
1126 
     | 
    
         
             
            <div class="section" id="filter">
         
     | 
| 
       1126 
     | 
    
         
            -
            <span id="select-filter"></span><h4>7.3. 
     | 
| 
      
 1127 
     | 
    
         
            +
            <span id="select-filter"></span><h4>7.3.41.4.2.3. <code class="docutils literal"><span class="pre">filter</span></code><a class="headerlink" href="#filter" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
       1127 
1128 
     | 
    
         
             
            <p>Specifies the filter text. Normally, it is used for complex search
         
     | 
| 
       1128 
     | 
    
         
            -
            conditions. < 
     | 
| 
       1129 
     | 
    
         
            -
            < 
     | 
| 
      
 1129 
     | 
    
         
            +
            conditions. <code class="docutils literal"><span class="pre">filter</span></code> can be used with <code class="docutils literal"><span class="pre">query</span></code> parameter. If both
         
     | 
| 
      
 1130 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">filter</span></code> and <code class="docutils literal"><span class="pre">query</span></code> are specified, there are conbined with
         
     | 
| 
       1130 
1131 
     | 
    
         
             
            logical and. It means that matched records should be matched against
         
     | 
| 
       1131 
     | 
    
         
            -
            both < 
     | 
| 
       1132 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 1132 
     | 
    
         
            +
            both <code class="docutils literal"><span class="pre">filter</span></code> and <code class="docutils literal"><span class="pre">query</span></code>.</p>
         
     | 
| 
      
 1133 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">filter</span></code> parameter is designed for complex conditions. A filter text
         
     | 
| 
       1133 
1134 
     | 
    
         
             
            should be formated in <a class="reference internal" href="../grn_expr/script_syntax.html"><em>Script syntax</em></a>. The syntax is
         
     | 
| 
       1134 
     | 
    
         
            -
            similar to ECMAScript. For example, < 
     | 
| 
       1135 
     | 
    
         
            -
            the value of < 
     | 
| 
       1136 
     | 
    
         
            -
            <span class="pre">value</span></ 
     | 
| 
       1137 
     | 
    
         
            -
            < 
     | 
| 
      
 1135 
     | 
    
         
            +
            similar to ECMAScript. For example, <code class="docutils literal"><span class="pre">column</span> <span class="pre">==</span> <span class="pre">"value"</span></code> means that
         
     | 
| 
      
 1136 
     | 
    
         
            +
            the value of <code class="docutils literal"><span class="pre">column</span></code> column is equal to <code class="docutils literal"><span class="pre">"value"</span></code>. <code class="docutils literal"><span class="pre">column</span> <span class="pre"><</span>
         
     | 
| 
      
 1137 
     | 
    
         
            +
            <span class="pre">value</span></code> means that the value of <code class="docutils literal"><span class="pre">column</span></code> column is less than
         
     | 
| 
      
 1138 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">value</span></code>.</p>
         
     | 
| 
       1138 
1139 
     | 
    
         
             
            <p>Here is a simple equality operator search example.</p>
         
     | 
| 
       1139 
1140 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1140 
1141 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --filter '_key == "Groonga"'
         
     | 
| 
         @@ -1183,8 +1184,8 @@ the value of <tt class="docutils literal"><span class="pre">column</span></tt> c 
     | 
|
| 
       1183 
1184 
     | 
    
         
             
            # ]
         
     | 
| 
       1184 
1185 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1185 
1186 
     | 
    
         
             
            </div>
         
     | 
| 
       1186 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1187 
     | 
    
         
            -
            < 
     | 
| 
      
 1187 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that <code class="docutils literal"><span class="pre">_key</span></code> column value is
         
     | 
| 
      
 1188 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">Groonga</span></code> from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
         
     | 
| 
       1188 
1189 
     | 
    
         
             
            <p>Here is a simple less than operator search example.</p>
         
     | 
| 
       1189 
1190 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1190 
1191 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --filter 'n_likes < 11'
         
     | 
| 
         @@ -1254,15 +1255,15 @@ the value of <tt class="docutils literal"><span class="pre">column</span></tt> c 
     | 
|
| 
       1254 
1255 
     | 
    
         
             
            # ]
         
     | 
| 
       1255 
1256 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1256 
1257 
     | 
    
         
             
            </div>
         
     | 
| 
       1257 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1258 
     | 
    
         
            -
            is less than < 
     | 
| 
      
 1258 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that <code class="docutils literal"><span class="pre">n_likes</span></code> column value
         
     | 
| 
      
 1259 
     | 
    
         
            +
            is less than <code class="docutils literal"><span class="pre">11</span></code> from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
         
     | 
| 
       1259 
1260 
     | 
    
         
             
            <p>See <a class="reference internal" href="../grn_expr/script_syntax.html"><em>Script syntax</em></a> for other operators.</p>
         
     | 
| 
       1260 
1261 
     | 
    
         
             
            </div>
         
     | 
| 
       1261 
1262 
     | 
    
         
             
            </div>
         
     | 
| 
       1262 
1263 
     | 
    
         
             
            <div class="section" id="advanced-search-parameters">
         
     | 
| 
       1263 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
      
 1264 
     | 
    
         
            +
            <span id="select-advanced-search-parameters"></span><h3>7.3.41.4.3. Advanced search parameters<a class="headerlink" href="#advanced-search-parameters" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       1264 
1265 
     | 
    
         
             
            <div class="section" id="match-escalation-threshold">
         
     | 
| 
       1265 
     | 
    
         
            -
            <span id=" 
     | 
| 
      
 1266 
     | 
    
         
            +
            <span id="select-match-escalation-threshold"></span><h4>7.3.41.4.3.1. <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code><a class="headerlink" href="#match-escalation-threshold" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
       1266 
1267 
     | 
    
         
             
            <p>Specifies threshold to determine whether search storategy
         
     | 
| 
       1267 
1268 
     | 
    
         
             
            escalation is used or not. The threshold is compared against the
         
     | 
| 
       1268 
1269 
     | 
    
         
             
            number of matched records. If the number of matched records is equal
         
     | 
| 
         @@ -1273,15 +1274,15 @@ is used only when no records are matched.</p> 
     | 
|
| 
       1273 
1274 
     | 
    
         
             
            <p>The default threshold can be customized by one of the followings.</p>
         
     | 
| 
       1274 
1275 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       1275 
1276 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       1276 
     | 
    
         
            -
            <li>< 
     | 
| 
       1277 
     | 
    
         
            -
            <li>< 
     | 
| 
       1278 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 1277 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">--with-match-escalation-threshold</span></code> option of configure</li>
         
     | 
| 
      
 1278 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">--match-escalation-threshold</span></code> option of groogna command</li>
         
     | 
| 
      
 1279 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">match-escalation-threshold</span></code> configuration item in configuration
         
     | 
| 
       1279 
1280 
     | 
    
         
             
            file</li>
         
     | 
| 
       1280 
1281 
     | 
    
         
             
            </ul>
         
     | 
| 
       1281 
1282 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       1282 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
       1283 
     | 
    
         
            -
            first < 
     | 
| 
       1284 
     | 
    
         
            -
            parameter. The second < 
     | 
| 
      
 1283 
     | 
    
         
            +
            <p>Here is a simple <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code> usage example. The
         
     | 
| 
      
 1284 
     | 
    
         
            +
            first <code class="docutils literal"><span class="pre">select</span></code> doesn't have <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code>
         
     | 
| 
      
 1285 
     | 
    
         
            +
            parameter. The second <code class="docutils literal"><span class="pre">select</span></code> has <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code>
         
     | 
| 
       1285 
1286 
     | 
    
         
             
            parameter.</p>
         
     | 
| 
       1286 
1287 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1287 
1288 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query groo
         
     | 
| 
         @@ -1367,60 +1368,60 @@ select Entries --match_columns content --query groo --match_escalation_threshold 
     | 
|
| 
       1367 
1368 
     | 
    
         
             
            # ]
         
     | 
| 
       1368 
1369 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1369 
1370 
     | 
    
         
             
            </div>
         
     | 
| 
       1370 
     | 
    
         
            -
            <p>The first < 
     | 
| 
       1371 
     | 
    
         
            -
            < 
     | 
| 
       1372 
     | 
    
         
            -
            records are matched because the < 
     | 
| 
       1373 
     | 
    
         
            -
            < 
     | 
| 
       1374 
     | 
    
         
            -
            < 
     | 
| 
       1375 
     | 
    
         
            -
            < 
     | 
| 
       1376 
     | 
    
         
            -
            It means that < 
     | 
| 
       1377 
     | 
    
         
            -
            records are matched against < 
     | 
| 
      
 1371 
     | 
    
         
            +
            <p>The first <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain a word
         
     | 
| 
      
 1372 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">groo</span></code> in <code class="docutils literal"><span class="pre">content</span></code> column value from <code class="docutils literal"><span class="pre">Entries</span></code> table. But no
         
     | 
| 
      
 1373 
     | 
    
         
            +
            records are matched because the <code class="docutils literal"><span class="pre">TokenBigram</span></code> tokenizer tokenizes
         
     | 
| 
      
 1374 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">groonga</span></code> to <code class="docutils literal"><span class="pre">groonga</span></code> not <code class="docutils literal"><span class="pre">gr|ro|oo|on|ng|ga</span></code>. (The
         
     | 
| 
      
 1375 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">TokenBigramSplitSymbolAlpha</span></code> tokenizer tokenizes <code class="docutils literal"><span class="pre">groonga</span></code> to
         
     | 
| 
      
 1376 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">gr|ro|oo|on|ng|ga</span></code>. See <a class="reference internal" href="../tokenizers.html"><em>Tokenizers</em></a> for details.)
         
     | 
| 
      
 1377 
     | 
    
         
            +
            It means that <code class="docutils literal"><span class="pre">groonga</span></code> is indexed but <code class="docutils literal"><span class="pre">groo</span></code> isn't indexed. So no
         
     | 
| 
      
 1378 
     | 
    
         
            +
            records are matched against <code class="docutils literal"><span class="pre">groo</span></code> by exact match. In the case, the
         
     | 
| 
       1378 
1379 
     | 
    
         
             
            search storategy escalation is used because the number of matched
         
     | 
| 
       1379 
     | 
    
         
            -
            records (0) is equal to < 
     | 
| 
       1380 
     | 
    
         
            -
            is matched against < 
     | 
| 
       1381 
     | 
    
         
            -
            <p>The second < 
     | 
| 
       1382 
     | 
    
         
            -
            word < 
     | 
| 
      
 1380 
     | 
    
         
            +
            records (0) is equal to <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code> (0). One record
         
     | 
| 
      
 1381 
     | 
    
         
            +
            is matched against <code class="docutils literal"><span class="pre">groo</span></code> by unsplit search.</p>
         
     | 
| 
      
 1382 
     | 
    
         
            +
            <p>The second <code class="docutils literal"><span class="pre">select</span></code> command also searches records that contain a
         
     | 
| 
      
 1383 
     | 
    
         
            +
            word <code class="docutils literal"><span class="pre">groo</span></code> in <code class="docutils literal"><span class="pre">content</span></code> column value from <code class="docutils literal"><span class="pre">Entries</span></code> table. And
         
     | 
| 
       1383 
1384 
     | 
    
         
             
            it also doesn't found matched records. In this case, the search
         
     | 
| 
       1384 
1385 
     | 
    
         
             
            storategy escalation is not used because the number of matched
         
     | 
| 
       1385 
     | 
    
         
            -
            records (0) is larger than < 
     | 
| 
      
 1386 
     | 
    
         
            +
            records (0) is larger than <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code> (-1). So no
         
     | 
| 
       1386 
1387 
     | 
    
         
             
            more searches aren't executed. And no records are matched.</p>
         
     | 
| 
       1387 
1388 
     | 
    
         
             
            </div>
         
     | 
| 
       1388 
1389 
     | 
    
         
             
            <div class="section" id="query-expansion">
         
     | 
| 
       1389 
     | 
    
         
            -
            <span id=" 
     | 
| 
       1390 
     | 
    
         
            -
            <p>Deprecated. Use <a class="reference internal" href="#query-expander">< 
     | 
| 
      
 1390 
     | 
    
         
            +
            <span id="select-query-expansion"></span><h4>7.3.41.4.3.2. <code class="docutils literal"><span class="pre">query_expansion</span></code><a class="headerlink" href="#query-expansion" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 1391 
     | 
    
         
            +
            <p>Deprecated. Use <a class="reference internal" href="#select-query-expander"><span>query_expander</span></a> instead.</p>
         
     | 
| 
       1391 
1392 
     | 
    
         
             
            </div>
         
     | 
| 
       1392 
1393 
     | 
    
         
             
            <div class="section" id="query-flags">
         
     | 
| 
       1393 
     | 
    
         
            -
            <span id=" 
     | 
| 
       1394 
     | 
    
         
            -
            <p>It customs < 
     | 
| 
       1395 
     | 
    
         
            -
            by < 
     | 
| 
       1396 
     | 
    
         
            -
            < 
     | 
| 
       1397 
     | 
    
         
            -
            column value by < 
     | 
| 
      
 1394 
     | 
    
         
            +
            <span id="select-query-flags"></span><h4>7.3.41.4.3.3. <code class="docutils literal"><span class="pre">query_flags</span></code><a class="headerlink" href="#query-flags" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 1395 
     | 
    
         
            +
            <p>It customs <code class="docutils literal"><span class="pre">query</span></code> parameter syntax. You cannot update column value
         
     | 
| 
      
 1396 
     | 
    
         
            +
            by <code class="docutils literal"><span class="pre">query</span></code> parameter by default. But if you specify
         
     | 
| 
      
 1397 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">ALLOW_COLUMN|ALLOW_UPDATE</span></code> as <code class="docutils literal"><span class="pre">query_flags</span></code>, you can update
         
     | 
| 
      
 1398 
     | 
    
         
            +
            column value by <code class="docutils literal"><span class="pre">query</span></code>.</p>
         
     | 
| 
       1398 
1399 
     | 
    
         
             
            <p>Here are available values:</p>
         
     | 
| 
       1399 
1400 
     | 
    
         
             
            <ul class="simple">
         
     | 
| 
       1400 
     | 
    
         
            -
            <li>< 
     | 
| 
       1401 
     | 
    
         
            -
            <li>< 
     | 
| 
       1402 
     | 
    
         
            -
            <li>< 
     | 
| 
       1403 
     | 
    
         
            -
            <li>< 
     | 
| 
       1404 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 1401 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">ALLOW_PRAGMA</span></code></li>
         
     | 
| 
      
 1402 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">ALLOW_COLUMN</span></code></li>
         
     | 
| 
      
 1403 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">ALLOW_UPDATE</span></code></li>
         
     | 
| 
      
 1404 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">ALLOW_LEADING_NOT</span></code></li>
         
     | 
| 
      
 1405 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">NONE</span></code></li>
         
     | 
| 
       1405 
1406 
     | 
    
         
             
            </ul>
         
     | 
| 
       1406 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 1407 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">ALLOW_PRAGMA</span></code> enables pragma at the head of <code class="docutils literal"><span class="pre">query</span></code>. This is not
         
     | 
| 
       1407 
1408 
     | 
    
         
             
            implemented yet.</p>
         
     | 
| 
       1408 
     | 
    
         
            -
            <p>< 
     | 
| 
       1409 
     | 
    
         
            -
            in < 
     | 
| 
      
 1409 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">ALLOW_COLUMN</span></code> enables search againt columns that are not included
         
     | 
| 
      
 1410 
     | 
    
         
            +
            in <code class="docutils literal"><span class="pre">match_columns</span></code>. To specify column, there are <code class="docutils literal"><span class="pre">COLUMN:...</span></code>
         
     | 
| 
       1410 
1411 
     | 
    
         
             
            syntaxes.</p>
         
     | 
| 
       1411 
     | 
    
         
            -
            <p>< 
     | 
| 
       1412 
     | 
    
         
            -
            < 
     | 
| 
      
 1412 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">ALLOW_UPDATE</span></code> enables column update by <code class="docutils literal"><span class="pre">query</span></code> with
         
     | 
| 
      
 1413 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">COLUMN:=NEW_VALUE</span></code> syntax. <code class="docutils literal"><span class="pre">ALLOW_COLUMN</span></code> is also required to
         
     | 
| 
       1413 
1414 
     | 
    
         
             
            update column because the column update syntax specifies column.</p>
         
     | 
| 
       1414 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 1415 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">ALLOW_LEADING_NOT</span></code> enables leading NOT condition with <code class="docutils literal"><span class="pre">-WORD</span></code>
         
     | 
| 
       1415 
1416 
     | 
    
         
             
            syntax. The query searches records that doesn't match
         
     | 
| 
       1416 
     | 
    
         
            -
            < 
     | 
| 
      
 1417 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">WORD</span></code>. Leading NOT condition query is heavy query in many cases
         
     | 
| 
       1417 
1418 
     | 
    
         
             
            because it matches many records. So this flag is disabled by
         
     | 
| 
       1418 
1419 
     | 
    
         
             
            default. Be careful about it when you use the flag.</p>
         
     | 
| 
       1419 
     | 
    
         
            -
            <p>< 
     | 
| 
       1420 
     | 
    
         
            -
            <p>They can be combined by separated < 
     | 
| 
       1421 
     | 
    
         
            -
            < 
     | 
| 
       1422 
     | 
    
         
            -
            <p>The default value is < 
     | 
| 
       1423 
     | 
    
         
            -
            <p>Here is a usage example of < 
     | 
| 
      
 1420 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">NONE</span></code> is just ignores. You can use <code class="docutils literal"><span class="pre">NONE</span></code> for specifying no flags.</p>
         
     | 
| 
      
 1421 
     | 
    
         
            +
            <p>They can be combined by separated <code class="docutils literal"><span class="pre">|</span></code> such as
         
     | 
| 
      
 1422 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">ALLOW_COLUMN|ALLOW_UPDATE</span></code>.</p>
         
     | 
| 
      
 1423 
     | 
    
         
            +
            <p>The default value is <code class="docutils literal"><span class="pre">ALLOW_PRAGMA|ALLOW_COLUMN</span></code>.</p>
         
     | 
| 
      
 1424 
     | 
    
         
            +
            <p>Here is a usage example of <code class="docutils literal"><span class="pre">ALLOW_COLUMN</span></code>.</p>
         
     | 
| 
       1424 
1425 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1425 
1426 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --query content:@mroonga --query_flags ALLOW_COLUMN
         
     | 
| 
       1426 
1427 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -1468,9 +1469,9 @@ default. Be careful about it when you use the flag.</p> 
     | 
|
| 
       1468 
1469 
     | 
    
         
             
            # ]
         
     | 
| 
       1469 
1470 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1470 
1471 
     | 
    
         
             
            </div>
         
     | 
| 
       1471 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1472 
     | 
    
         
            -
            < 
     | 
| 
       1473 
     | 
    
         
            -
            <p>Here is a usage example of < 
     | 
| 
      
 1472 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain <code class="docutils literal"><span class="pre">mroonga</span></code> in
         
     | 
| 
      
 1473 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">content</span></code> column value from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
         
     | 
| 
      
 1474 
     | 
    
         
            +
            <p>Here is a usage example of <code class="docutils literal"><span class="pre">ALLOW_UPDATE</span></code>.</p>
         
     | 
| 
       1474 
1475 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1475 
1476 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>table_create Users TABLE_HASH_KEY ShortText
         
     | 
| 
       1476 
1477 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], true]
         
     | 
| 
         @@ -1562,10 +1563,10 @@ select Users 
     | 
|
| 
       1562 
1563 
     | 
    
         
             
            # ]
         
     | 
| 
       1563 
1564 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1564 
1565 
     | 
    
         
             
            </div>
         
     | 
| 
       1565 
     | 
    
         
            -
            <p>The first < 
     | 
| 
       1566 
     | 
    
         
            -
            to < 
     | 
| 
      
 1566 
     | 
    
         
            +
            <p>The first <code class="docutils literal"><span class="pre">select</span></code> command sets <code class="docutils literal"><span class="pre">age</span></code> column value of all records
         
     | 
| 
      
 1567 
     | 
    
         
            +
            to <code class="docutils literal"><span class="pre">19</span></code>. The second <code class="docutils literal"><span class="pre">select</span></code> command outputs updated <code class="docutils literal"><span class="pre">age</span></code>
         
     | 
| 
       1567 
1568 
     | 
    
         
             
            column values.</p>
         
     | 
| 
       1568 
     | 
    
         
            -
            <p>Here is a usage example of < 
     | 
| 
      
 1569 
     | 
    
         
            +
            <p>Here is a usage example of <code class="docutils literal"><span class="pre">ALLOW_LEADING_NOT</span></code>.</p>
         
     | 
| 
       1569 
1570 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1570 
1571 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query -mroonga --query_flags ALLOW_LEADING_NOT
         
     | 
| 
       1571 
1572 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -1634,9 +1635,9 @@ column values.</p> 
     | 
|
| 
       1634 
1635 
     | 
    
         
             
            # ]
         
     | 
| 
       1635 
1636 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1636 
1637 
     | 
    
         
             
            </div>
         
     | 
| 
       1637 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1638 
     | 
    
         
            -
            in < 
     | 
| 
       1639 
     | 
    
         
            -
            <p>Here is a usage example of < 
     | 
| 
      
 1638 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that don't contain <code class="docutils literal"><span class="pre">mroonga</span></code>
         
     | 
| 
      
 1639 
     | 
    
         
            +
            in <code class="docutils literal"><span class="pre">content</span></code> column value from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
         
     | 
| 
      
 1640 
     | 
    
         
            +
            <p>Here is a usage example of <code class="docutils literal"><span class="pre">NONE</span></code>.</p>
         
     | 
| 
       1640 
1641 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1641 
1642 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query 'mroonga OR _key:Groonga' --query_flags NONE
         
     | 
| 
       1642 
1643 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -1684,38 +1685,38 @@ in <tt class="docutils literal"><span class="pre">content</span></tt> column val 
     | 
|
| 
       1684 
1685 
     | 
    
         
             
            # ]
         
     | 
| 
       1685 
1686 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1686 
1687 
     | 
    
         
             
            </div>
         
     | 
| 
       1687 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1688 
     | 
    
         
            -
            < 
     | 
| 
       1689 
     | 
    
         
            -
            Note that < 
     | 
| 
       1690 
     | 
    
         
            -
            column is equal to < 
     | 
| 
      
 1688 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command searches records that contain one of two words
         
     | 
| 
      
 1689 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">mroonga</span></code> or <code class="docutils literal"><span class="pre">_key:Groonga</span></code> in <code class="docutils literal"><span class="pre">content</span></code> from <code class="docutils literal"><span class="pre">Entries</span></code> table.
         
     | 
| 
      
 1690 
     | 
    
         
            +
            Note that <code class="docutils literal"><span class="pre">_key:Groonga</span></code> doesn't mean that the value of <code class="docutils literal"><span class="pre">_key</span></code>
         
     | 
| 
      
 1691 
     | 
    
         
            +
            column is equal to <code class="docutils literal"><span class="pre">Groonga</span></code>. Because <code class="docutils literal"><span class="pre">ALLOW_COLUMN</span></code> flag is not
         
     | 
| 
       1691 
1692 
     | 
    
         
             
            specified.</p>
         
     | 
| 
       1692 
1693 
     | 
    
         
             
            <p>See also <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a>.</p>
         
     | 
| 
       1693 
1694 
     | 
    
         
             
            </div>
         
     | 
| 
       1694 
1695 
     | 
    
         
             
            <div class="section" id="query-expander">
         
     | 
| 
       1695 
     | 
    
         
            -
            <span id=" 
     | 
| 
      
 1696 
     | 
    
         
            +
            <span id="select-query-expander"></span><h4>7.3.41.4.3.4. <code class="docutils literal"><span class="pre">query_expander</span></code><a class="headerlink" href="#query-expander" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
       1696 
1697 
     | 
    
         
             
            <p>It's for query expansion. Query expansion substitutes specific words
         
     | 
| 
       1697 
1698 
     | 
    
         
             
            to another words in query. Nomally, it's used for synonym search.</p>
         
     | 
| 
       1698 
     | 
    
         
            -
            <p>It specifies a column that is used to substitute < 
     | 
| 
      
 1699 
     | 
    
         
            +
            <p>It specifies a column that is used to substitute <code class="docutils literal"><span class="pre">query</span></code> parameter
         
     | 
| 
       1699 
1700 
     | 
    
         
             
            value. The format of this parameter value is
         
     | 
| 
       1700 
     | 
    
         
            -
            "< 
     | 
| 
       1701 
     | 
    
         
            -
            < 
     | 
| 
      
 1701 
     | 
    
         
            +
            "<code class="docutils literal"><span class="pre">${TABLE}.${COLUMN}</span></code>". For example, "<code class="docutils literal"><span class="pre">Terms.synonym</span></code>" specifies
         
     | 
| 
      
 1702 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">synonym</span></code> column in <code class="docutils literal"><span class="pre">Terms</span></code> table.</p>
         
     | 
| 
       1702 
1703 
     | 
    
         
             
            <p>Table for query expansion is called "substitution table". Substitution
         
     | 
| 
       1703 
     | 
    
         
            -
            table's key must be < 
     | 
| 
      
 1704 
     | 
    
         
            +
            table's key must be <code class="docutils literal"><span class="pre">ShortText</span></code>. So array table (<code class="docutils literal"><span class="pre">TABLE_NO_KEY</span></code>)
         
     | 
| 
       1704 
1705 
     | 
    
         
             
            can't be used for query expansion. Because array table doesn't have
         
     | 
| 
       1705 
1706 
     | 
    
         
             
            key.</p>
         
     | 
| 
       1706 
1707 
     | 
    
         
             
            <p>Column for query expansion is called "substitution
         
     | 
| 
       1707 
1708 
     | 
    
         
             
            column". Substitution column's value type must be
         
     | 
| 
       1708 
     | 
    
         
            -
            < 
     | 
| 
      
 1709 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">ShortText</span></code>. Column type must be vector (<code class="docutils literal"><span class="pre">COLUMN_VECTOR</span></code>).</p>
         
     | 
| 
       1709 
1710 
     | 
    
         
             
            <p>Query expansion substitutes key of substitution table in query with
         
     | 
| 
       1710 
     | 
    
         
            -
            values in substitution column. If a word in < 
     | 
| 
      
 1711 
     | 
    
         
            +
            values in substitution column. If a word in <code class="docutils literal"><span class="pre">query</span></code> is a key of
         
     | 
| 
       1711 
1712 
     | 
    
         
             
            substitution table, the word is substituted with substitution column
         
     | 
| 
       1712 
1713 
     | 
    
         
             
            value that is associated with the key. Substition isn't performed
         
     | 
| 
       1713 
1714 
     | 
    
         
             
            recursively. It means that substitution target words in substituted
         
     | 
| 
       1714 
1715 
     | 
    
         
             
            query aren't substituted.</p>
         
     | 
| 
       1715 
1716 
     | 
    
         
             
            <p>Here is a sample substitution table to show a simple
         
     | 
| 
       1716 
     | 
    
         
            -
            < 
     | 
| 
      
 1717 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">query_expander</span></code> usage example.</p>
         
     | 
| 
       1717 
1718 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1718 
     | 
    
         
            -
            <div class="highlight-none"><div class="highlight"><pre>table_create Thesaurus TABLE_PAT_KEY 
     | 
| 
      
 1719 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>table_create Thesaurus TABLE_PAT_KEY ShortText --normalizer NormalizerAuto
         
     | 
| 
       1719 
1720 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], true]
         
     | 
| 
       1720 
1721 
     | 
    
         
             
            column_create Thesaurus synonym COLUMN_VECTOR ShortText
         
     | 
| 
       1721 
1722 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], true]
         
     | 
| 
         @@ -1727,22 +1728,24 @@ load --table Thesaurus 
     | 
|
| 
       1727 
1728 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], 2]
         
     | 
| 
       1728 
1729 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1729 
1730 
     | 
    
         
             
            </div>
         
     | 
| 
       1730 
     | 
    
         
            -
            <p>< 
     | 
| 
       1731 
     | 
    
         
            -
            < 
     | 
| 
       1732 
     | 
    
         
            -
            searches with < 
     | 
| 
       1733 
     | 
    
         
            -
            user searches with < 
     | 
| 
       1734 
     | 
    
         
            -
            <span class="pre">OR</span> <span class="pre">(senna))"</span></ 
     | 
| 
       1735 
     | 
    
         
            -
            < 
     | 
| 
       1736 
     | 
    
         
            -
             
     | 
| 
      
 1731 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">Thesaurus</span></code> substitution table has two synonyms, <code class="docutils literal"><span class="pre">"mroonga"</span></code> and
         
     | 
| 
      
 1732 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">"groonga"</span></code>. If an user searches with <code class="docutils literal"><span class="pre">"mroonga"</span></code>, Groonga
         
     | 
| 
      
 1733 
     | 
    
         
            +
            searches with <code 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></code>. If an
         
     | 
| 
      
 1734 
     | 
    
         
            +
            user searches with <code class="docutils literal"><span class="pre">"groonga"</span></code>, Groonga searches with <code class="docutils literal"><span class="pre">"((groonga)</span>
         
     | 
| 
      
 1735 
     | 
    
         
            +
            <span class="pre">OR</span> <span class="pre">(senna))"</span></code>.</p>
         
     | 
| 
      
 1736 
     | 
    
         
            +
            <p>Normally, it's good idea that substitution table uses a
         
     | 
| 
      
 1737 
     | 
    
         
            +
            normalizer. For example, if normalizer is used, substitute target word
         
     | 
| 
      
 1738 
     | 
    
         
            +
            is matched in case insensitive manner. See
         
     | 
| 
      
 1739 
     | 
    
         
            +
            <a class="reference internal" href="../normalizers.html"><em>Normalizers</em></a> for available normalizers.</p>
         
     | 
| 
       1737 
1740 
     | 
    
         
             
            <p>Note that those synonym values include the key value such as
         
     | 
| 
       1738 
     | 
    
         
            -
            < 
     | 
| 
      
 1741 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">"mroonga"</span></code> and <code class="docutils literal"><span class="pre">"groonga"</span></code>. It's recommended that you include the
         
     | 
| 
       1739 
1742 
     | 
    
         
             
            key value. If you don't include key value, substituted value doesn't
         
     | 
| 
       1740 
1743 
     | 
    
         
             
            include the original substitute target value. Normally, including the
         
     | 
| 
       1741 
1744 
     | 
    
         
             
            original value is better search result. If you have a word that you
         
     | 
| 
       1742 
1745 
     | 
    
         
             
            don't want to be searched, you should not include the original
         
     | 
| 
       1743 
1746 
     | 
    
         
             
            word. For example, you can implement "stop words" by an empty vector
         
     | 
| 
       1744 
1747 
     | 
    
         
             
            value.</p>
         
     | 
| 
       1745 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 1748 
     | 
    
         
            +
            <p>Here is a simple <code class="docutils literal"><span class="pre">query_expander</span></code> usage example.</p>
         
     | 
| 
       1746 
1749 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1747 
1750 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query "mroonga"
         
     | 
| 
       1748 
1751 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -1892,13 +1895,13 @@ select Entries --match_columns content --query "((mroonga) OR (tritonn) OR 
     | 
|
| 
       1892 
1895 
     | 
    
         
             
            # ]
         
     | 
| 
       1893 
1896 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1894 
1897 
     | 
    
         
             
            </div>
         
     | 
| 
       1895 
     | 
    
         
            -
            <p>The first < 
     | 
| 
       1896 
     | 
    
         
            -
            that has < 
     | 
| 
       1897 
     | 
    
         
            -
            query expansion. So a record that has < 
     | 
| 
       1898 
     | 
    
         
            -
            third < 
     | 
| 
       1899 
     | 
    
         
            -
            the second < 
     | 
| 
      
 1898 
     | 
    
         
            +
            <p>The first <code class="docutils literal"><span class="pre">select</span></code> command doesn't use query expansion. So a record
         
     | 
| 
      
 1899 
     | 
    
         
            +
            that has <code class="docutils literal"><span class="pre">"tritonn"</span></code> isn't found. The second <code class="docutils literal"><span class="pre">select</span></code> command uses
         
     | 
| 
      
 1900 
     | 
    
         
            +
            query expansion. So a record that has <code class="docutils literal"><span class="pre">"tritonn"</span></code> is found. The
         
     | 
| 
      
 1901 
     | 
    
         
            +
            third <code class="docutils literal"><span class="pre">select</span></code> command doesn't use query expansion but it is same as
         
     | 
| 
      
 1902 
     | 
    
         
            +
            the second <code class="docutils literal"><span class="pre">select</span></code> command. The third one uses expanded query.</p>
         
     | 
| 
       1900 
1903 
     | 
    
         
             
            <p>Each substitute value can contain any <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a> syntax
         
     | 
| 
       1901 
     | 
    
         
            -
            such as < 
     | 
| 
      
 1904 
     | 
    
         
            +
            such as <code class="docutils literal"><span class="pre">(...)</span></code> and <code class="docutils literal"><span class="pre">OR</span></code>. You can use complex substitution by
         
     | 
| 
       1902 
1905 
     | 
    
         
             
            using those syntax.</p>
         
     | 
| 
       1903 
1906 
     | 
    
         
             
            <p>Here is a complex substitution usage example that uses query syntax.</p>
         
     | 
| 
       1904 
1907 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
         @@ -1960,20 +1963,20 @@ select Entries --match_columns content --query "popular" --query_expan 
     | 
|
| 
       1960 
1963 
     | 
    
         
             
            # ]
         
     | 
| 
       1961 
1964 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       1962 
1965 
     | 
    
         
             
            </div>
         
     | 
| 
       1963 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1964 
     | 
    
         
            -
            substituted with < 
     | 
| 
      
 1966 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">load</span></code> command registers a new synonym <code class="docutils literal"><span class="pre">"popular"</span></code>. It is
         
     | 
| 
      
 1967 
     | 
    
         
            +
            substituted with <code class="docutils literal"><span class="pre">((popular)</span> <span class="pre">OR</span> <span class="pre">(n_likes:>=10))</span></code>. The substituted
         
     | 
| 
       1965 
1968 
     | 
    
         
             
            query means that "popular" is containing the word "popular" or 10 or
         
     | 
| 
       1966 
1969 
     | 
    
         
             
            more liked entries.</p>
         
     | 
| 
       1967 
     | 
    
         
            -
            <p>The < 
     | 
| 
       1968 
     | 
    
         
            -
            is equal to or more than < 
     | 
| 
      
 1970 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs records that <code class="docutils literal"><span class="pre">n_likes</span></code> column value
         
     | 
| 
      
 1971 
     | 
    
         
            +
            is equal to or more than <code class="docutils literal"><span class="pre">10</span></code> from <code class="docutils literal"><span class="pre">Entries</span></code> table.</p>
         
     | 
| 
       1969 
1972 
     | 
    
         
             
            </div>
         
     | 
| 
       1970 
1973 
     | 
    
         
             
            </div>
         
     | 
| 
       1971 
1974 
     | 
    
         
             
            <div class="section" id="output-related-parameters">
         
     | 
| 
       1972 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
      
 1975 
     | 
    
         
            +
            <h3>7.3.41.4.4. Output related parameters<a class="headerlink" href="#output-related-parameters" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       1973 
1976 
     | 
    
         
             
            <div class="section" id="output-columns">
         
     | 
| 
       1974 
     | 
    
         
            -
            <span id="select-output-columns"></span><h4>7.3. 
     | 
| 
       1975 
     | 
    
         
            -
            <p>Specifies output columns separated by < 
     | 
| 
       1976 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 1977 
     | 
    
         
            +
            <span id="select-output-columns"></span><h4>7.3.41.4.4.1. <code class="docutils literal"><span class="pre">output_columns</span></code><a class="headerlink" href="#output-columns" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 1978 
     | 
    
         
            +
            <p>Specifies output columns separated by <code class="docutils literal"><span class="pre">,</span></code>.</p>
         
     | 
| 
      
 1979 
     | 
    
         
            +
            <p>Here is a simple <code class="docutils literal"><span class="pre">output_columns</span></code> usage example.</p>
         
     | 
| 
       1977 
1980 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       1978 
1981 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --output_columns '_id, _key' --limit 1
         
     | 
| 
       1979 
1982 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2006,11 +2009,11 @@ is equal to or more than <tt class="docutils literal"><span class="pre">10</span 
     | 
|
| 
       2006 
2009 
     | 
    
         
             
            # ]
         
     | 
| 
       2007 
2010 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2008 
2011 
     | 
    
         
             
            </div>
         
     | 
| 
       2009 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 2012 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command just outputs <code class="docutils literal"><span class="pre">_id</span></code> and <code class="docutils literal"><span class="pre">_key</span></code> column
         
     | 
| 
       2010 
2013 
     | 
    
         
             
            values.</p>
         
     | 
| 
       2011 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 2014 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">*</span></code> is a special value. It means that all columns that are not
         
     | 
| 
       2012 
2015 
     | 
    
         
             
            <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a>.</p>
         
     | 
| 
       2013 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 2016 
     | 
    
         
            +
            <p>Here is a <code class="docutils literal"><span class="pre">*</span></code> usage example.</p>
         
     | 
| 
       2014 
2017 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2015 
2018 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --output_columns '_key, *' --limit 1
         
     | 
| 
       2016 
2019 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2053,17 +2056,17 @@ values.</p> 
     | 
|
| 
       2053 
2056 
     | 
    
         
             
            # ]
         
     | 
| 
       2054 
2057 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2055 
2058 
     | 
    
         
             
            </div>
         
     | 
| 
       2056 
     | 
    
         
            -
            <p>The < 
     | 
| 
       2057 
     | 
    
         
            -
            column and < 
     | 
| 
      
 2059 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs <code class="docutils literal"><span class="pre">_key</span></code> pseudo column, <code class="docutils literal"><span class="pre">content</span></code>
         
     | 
| 
      
 2060 
     | 
    
         
            +
            column and <code class="docutils literal"><span class="pre">n_likes</span></code> column values but doesn't output <code class="docutils literal"><span class="pre">_id</span></code> pseudo
         
     | 
| 
       2058 
2061 
     | 
    
         
             
            column value.</p>
         
     | 
| 
       2059 
     | 
    
         
            -
            <p>The default value is < 
     | 
| 
       2060 
     | 
    
         
            -
            values except < 
     | 
| 
      
 2062 
     | 
    
         
            +
            <p>The default value is <code class="docutils literal"><span class="pre">_id,</span> <span class="pre">_key,</span> <span class="pre">*</span></code>. It means that all column
         
     | 
| 
      
 2063 
     | 
    
         
            +
            values except <code class="docutils literal"><span class="pre">_score</span></code> are outputted.</p>
         
     | 
| 
       2061 
2064 
     | 
    
         
             
            </div>
         
     | 
| 
       2062 
2065 
     | 
    
         
             
            <div class="section" id="sortby">
         
     | 
| 
       2063 
     | 
    
         
            -
            <span id="select-sortby"></span><h4>7.3. 
     | 
| 
       2064 
     | 
    
         
            -
            <p>Specifies sort keys separated by < 
     | 
| 
      
 2066 
     | 
    
         
            +
            <span id="select-sortby"></span><h4>7.3.41.4.4.2. <code class="docutils literal"><span class="pre">sortby</span></code><a class="headerlink" href="#sortby" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 2067 
     | 
    
         
            +
            <p>Specifies sort keys separated by <code class="docutils literal"><span class="pre">,</span></code>. Each sort key is column
         
     | 
| 
       2065 
2068 
     | 
    
         
             
            name.</p>
         
     | 
| 
       2066 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 2069 
     | 
    
         
            +
            <p>Here is a simple <code class="docutils literal"><span class="pre">sortby</span></code> usage example.</p>
         
     | 
| 
       2067 
2070 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2068 
2071 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --sortby 'n_likes, _id'
         
     | 
| 
       2069 
2072 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2139,12 +2142,12 @@ name.</p> 
     | 
|
| 
       2139 
2142 
     | 
    
         
             
            # ]
         
     | 
| 
       2140 
2143 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2141 
2144 
     | 
    
         
             
            </div>
         
     | 
| 
       2142 
     | 
    
         
            -
            <p>The < 
     | 
| 
       2143 
     | 
    
         
            -
            order. For records that has the same < 
     | 
| 
       2144 
     | 
    
         
            -
            in ascending order. < 
     | 
| 
      
 2145 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command sorts by <code class="docutils literal"><span class="pre">n_likes</span></code> column value in ascending
         
     | 
| 
      
 2146 
     | 
    
         
            +
            order. For records that has the same <code class="docutils literal"><span class="pre">n_likes</span></code> are sorted by <code class="docutils literal"><span class="pre">_id</span></code>
         
     | 
| 
      
 2147 
     | 
    
         
            +
            in ascending order. <code class="docutils literal"><span class="pre">"Good-bye</span> <span class="pre">Senna"</span></code> and <code class="docutils literal"><span class="pre">"Good-bye</span> <span class="pre">Tritonn"</span></code>
         
     | 
| 
       2145 
2148 
     | 
    
         
             
            are the case.</p>
         
     | 
| 
       2146 
     | 
    
         
            -
            <p>If you want to sort in descending order, add < 
     | 
| 
       2147 
     | 
    
         
            -
            <p>Here is a descending order < 
     | 
| 
      
 2149 
     | 
    
         
            +
            <p>If you want to sort in descending order, add <code class="docutils literal"><span class="pre">-</span></code> before column name.</p>
         
     | 
| 
      
 2150 
     | 
    
         
            +
            <p>Here is a descending order <code class="docutils literal"><span class="pre">sortby</span></code> usage example.</p>
         
     | 
| 
       2148 
2151 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2149 
2152 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --sortby '-n_likes, _id'
         
     | 
| 
       2150 
2153 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2220,10 +2223,10 @@ are the case.</p> 
     | 
|
| 
       2220 
2223 
     | 
    
         
             
            # ]
         
     | 
| 
       2221 
2224 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2222 
2225 
     | 
    
         
             
            </div>
         
     | 
| 
       2223 
     | 
    
         
            -
            <p>The < 
     | 
| 
       2224 
     | 
    
         
            -
            order. But ascending order is used for sorting by < 
     | 
| 
       2225 
     | 
    
         
            -
            <p>You can use < 
     | 
| 
       2226 
     | 
    
         
            -
            < 
     | 
| 
      
 2226 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command sorts by <code class="docutils literal"><span class="pre">n_likes</span></code> column value in descending
         
     | 
| 
      
 2227 
     | 
    
         
            +
            order. But ascending order is used for sorting by <code class="docutils literal"><span class="pre">_id</span></code>.</p>
         
     | 
| 
      
 2228 
     | 
    
         
            +
            <p>You can use <code class="docutils literal"><span class="pre">_score</span></code> pseudo column in <code class="docutils literal"><span class="pre">sortby</span></code> if you use
         
     | 
| 
      
 2229 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">query</span></code> or <code class="docutils literal"><span class="pre">filter</span></code> parameter.</p>
         
     | 
| 
       2227 
2230 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2228 
2231 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --match_columns content --query fast --sortby -_score --output_columns '_key, _score'
         
     | 
| 
       2229 
2232 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2260,15 +2263,15 @@ order. But ascending order is used for sorting by <tt class="docutils literal">< 
     | 
|
| 
       2260 
2263 
     | 
    
         
             
            # ]
         
     | 
| 
       2261 
2264 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2262 
2265 
     | 
    
         
             
            </div>
         
     | 
| 
       2263 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 2266 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command sorts matched records by hit score in
         
     | 
| 
       2264 
2267 
     | 
    
         
             
            descending order and outputs record key and hit score.</p>
         
     | 
| 
       2265 
     | 
    
         
            -
            <p>If you use < 
     | 
| 
      
 2268 
     | 
    
         
            +
            <p>If you use <code class="docutils literal"><span class="pre">_score</span></code> without <code class="docutils literal"><span class="pre">query</span></code> nor <code class="docutils literal"><span class="pre">filter</span></code> parameters,
         
     | 
| 
       2266 
2269 
     | 
    
         
             
            it's just ignored but get a warning in log file.</p>
         
     | 
| 
       2267 
2270 
     | 
    
         
             
            </div>
         
     | 
| 
       2268 
2271 
     | 
    
         
             
            <div class="section" id="offset">
         
     | 
| 
       2269 
     | 
    
         
            -
            <span id="select-offset"></span><h4>7.3. 
     | 
| 
      
 2272 
     | 
    
         
            +
            <span id="select-offset"></span><h4>7.3.41.4.4.3. <code class="docutils literal"><span class="pre">offset</span></code><a class="headerlink" href="#offset" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
       2270 
2273 
     | 
    
         
             
            <p>Specifies offset to determine output records range. Offset is
         
     | 
| 
       2271 
     | 
    
         
            -
            zero-based. < 
     | 
| 
      
 2274 
     | 
    
         
            +
            zero-based. <code class="docutils literal"><span class="pre">--offset</span> <span class="pre">1</span></code> means output range is started from the 2nd
         
     | 
| 
       2272 
2275 
     | 
    
         
             
            record.</p>
         
     | 
| 
       2273 
2276 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2274 
2277 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --sortby _id --offset 3 --output_columns _key
         
     | 
| 
         @@ -2300,10 +2303,10 @@ record.</p> 
     | 
|
| 
       2300 
2303 
     | 
    
         
             
            # ]
         
     | 
| 
       2301 
2304 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2302 
2305 
     | 
    
         
             
            </div>
         
     | 
| 
       2303 
     | 
    
         
            -
            <p>The < 
     | 
| 
       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 
     | 
    
         
            -
            < 
     | 
| 
      
 2306 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs from the 4th record.</p>
         
     | 
| 
      
 2307 
     | 
    
         
            +
            <p>You can specify negative value. It means that <code class="docutils literal"><span class="pre">the</span> <span class="pre">number</span> <span class="pre">of</span> <span class="pre">matched</span>
         
     | 
| 
      
 2308 
     | 
    
         
            +
            <span class="pre">records</span> <span class="pre">+</span> <span class="pre">offset</span></code>. If you have 3 matched records and specify
         
     | 
| 
      
 2309 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">--offset</span> <span class="pre">-2</span></code>, you get records from the 2nd (<code class="docutils literal"><span class="pre">3</span> <span class="pre">+</span> <span class="pre">-2</span> <span class="pre">=</span> <span class="pre">1</span></code>. <code class="docutils literal"><span class="pre">1</span></code>
         
     | 
| 
       2307 
2310 
     | 
    
         
             
            means 2nd. Remember that offset is zero-based.) record to the 3rd
         
     | 
| 
       2308 
2311 
     | 
    
         
             
            record.</p>
         
     | 
| 
       2309 
2312 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
         @@ -2336,15 +2339,15 @@ record.</p> 
     | 
|
| 
       2336 
2339 
     | 
    
         
             
            # ]
         
     | 
| 
       2337 
2340 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2338 
2341 
     | 
    
         
             
            </div>
         
     | 
| 
       2339 
     | 
    
         
            -
            <p>The < 
     | 
| 
       2340 
     | 
    
         
            -
            number of records is < 
     | 
| 
       2341 
     | 
    
         
            -
            <p>The default value is < 
     | 
| 
      
 2342 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs from the 4th record because the total
         
     | 
| 
      
 2343 
     | 
    
         
            +
            number of records is <code class="docutils literal"><span class="pre">5</span></code>.</p>
         
     | 
| 
      
 2344 
     | 
    
         
            +
            <p>The default value is <code class="docutils literal"><span class="pre">0</span></code>.</p>
         
     | 
| 
       2342 
2345 
     | 
    
         
             
            </div>
         
     | 
| 
       2343 
2346 
     | 
    
         
             
            <div class="section" id="limit">
         
     | 
| 
       2344 
     | 
    
         
            -
            <h4>7.3. 
     | 
| 
      
 2347 
     | 
    
         
            +
            <span id="select-limit"></span><h4>7.3.41.4.4.4. <code class="docutils literal"><span class="pre">limit</span></code><a class="headerlink" href="#limit" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
       2345 
2348 
     | 
    
         
             
            <p>Specifies the max number of output records. If the number of
         
     | 
| 
       2346 
     | 
    
         
            -
            matched records is less than < 
     | 
| 
       2347 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 2349 
     | 
    
         
            +
            matched records is less than <code class="docutils literal"><span class="pre">limit</span></code>, all records are outputted.</p>
         
     | 
| 
      
 2350 
     | 
    
         
            +
            <p>Here is a simple <code class="docutils literal"><span class="pre">limit</span></code> usage example.</p>
         
     | 
| 
       2348 
2351 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2349 
2352 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --sortby _id --offset 2 --limit 3 --output_columns _key
         
     | 
| 
       2350 
2353 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2378,11 +2381,11 @@ matched records is less than <tt class="docutils literal"><span class="pre">limi 
     | 
|
| 
       2378 
2381 
     | 
    
         
             
            # ]
         
     | 
| 
       2379 
2382 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2380 
2383 
     | 
    
         
             
            </div>
         
     | 
| 
       2381 
     | 
    
         
            -
            <p>The < 
     | 
| 
       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></ 
     | 
| 
      
 2384 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs the 3rd, the 4th and the 5th records.</p>
         
     | 
| 
      
 2385 
     | 
    
         
            +
            <p>You can specify negative value. It means that <code class="docutils literal"><span class="pre">the</span> <span class="pre">number</span> <span class="pre">of</span> <span class="pre">matched</span>
         
     | 
| 
      
 2386 
     | 
    
         
            +
            <span class="pre">records</span> <span class="pre">+</span> <span class="pre">limit</span> <span class="pre">+</span> <span class="pre">1</span></code>. For example, <code class="docutils literal"><span class="pre">--limit</span> <span class="pre">-1</span></code> outputs all
         
     | 
| 
       2384 
2387 
     | 
    
         
             
            records. It's very useful value to show all records.</p>
         
     | 
| 
       2385 
     | 
    
         
            -
            <p>Here is a simple negative < 
     | 
| 
      
 2388 
     | 
    
         
            +
            <p>Here is a simple negative <code class="docutils literal"><span class="pre">limit</span></code> value usage example.</p>
         
     | 
| 
       2386 
2389 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2387 
2390 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries --limit -1
         
     | 
| 
       2388 
2391 
     | 
    
         
             
            # [
         
     | 
| 
         @@ -2458,27 +2461,27 @@ records. It's very useful value to show all records.</p> 
     | 
|
| 
       2458 
2461 
     | 
    
         
             
            # ]
         
     | 
| 
       2459 
2462 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2460 
2463 
     | 
    
         
             
            </div>
         
     | 
| 
       2461 
     | 
    
         
            -
            <p>The < 
     | 
| 
       2462 
     | 
    
         
            -
            <p>The default value is < 
     | 
| 
      
 2464 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs all records.</p>
         
     | 
| 
      
 2465 
     | 
    
         
            +
            <p>The default value is <code class="docutils literal"><span class="pre">10</span></code>.</p>
         
     | 
| 
       2463 
2466 
     | 
    
         
             
            </div>
         
     | 
| 
       2464 
2467 
     | 
    
         
             
            <div class="section" id="scorer">
         
     | 
| 
       2465 
     | 
    
         
            -
            <h4>7.3. 
     | 
| 
      
 2468 
     | 
    
         
            +
            <span id="select-scorer"></span><h4>7.3.41.4.4.5. <code class="docutils literal"><span class="pre">scorer</span></code><a class="headerlink" href="#scorer" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
       2466 
2469 
     | 
    
         
             
            <p>TODO: write in English and add example.</p>
         
     | 
| 
       2467 
2470 
     | 
    
         
             
            <p>検索条件にマッチする全てのレコードに対して適用するgrn_exprをscript形式で指定します。</p>
         
     | 
| 
       2468 
2471 
     | 
    
         
             
            <p>scorerは、検索処理が完了し、ソート処理が実行される前に呼び出されます。従って、各レコードのスコアを操作する式を指定しておけば、検索結果のソート順序をカスタマイズできるようになります。</p>
         
     | 
| 
       2469 
2472 
     | 
    
         
             
            </div>
         
     | 
| 
       2470 
2473 
     | 
    
         
             
            </div>
         
     | 
| 
       2471 
2474 
     | 
    
         
             
            <div class="section" id="drilldown-related-parameters">
         
     | 
| 
       2472 
     | 
    
         
            -
            <span id="select-drilldown-related-parameters"></span><h3>7.3. 
     | 
| 
      
 2475 
     | 
    
         
            +
            <span id="select-drilldown-related-parameters"></span><h3>7.3.41.4.5. Drilldown related parameters<a class="headerlink" href="#drilldown-related-parameters" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       2473 
2476 
     | 
    
         
             
            <p>This section describes basic drilldown related parameters. Advanced
         
     | 
| 
       2474 
2477 
     | 
    
         
             
            drilldown related parameters are described in another section.</p>
         
     | 
| 
       2475 
2478 
     | 
    
         
             
            <div class="section" id="select-drilldown">
         
     | 
| 
       2476 
     | 
    
         
            -
            <span id=" 
     | 
| 
       2477 
     | 
    
         
            -
            <p>Specifies keys for grouping separated by < 
     | 
| 
      
 2479 
     | 
    
         
            +
            <span id="id2"></span><h4>7.3.41.4.5.1. <code class="docutils literal"><span class="pre">drilldown</span></code><a class="headerlink" href="#select-drilldown" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 2480 
     | 
    
         
            +
            <p>Specifies keys for grouping separated by <code class="docutils literal"><span class="pre">,</span></code>.</p>
         
     | 
| 
       2478 
2481 
     | 
    
         
             
            <p>Matched records by specified search conditions are grouped by each
         
     | 
| 
       2479 
2482 
     | 
    
         
             
            key. If you specify no search condition, all records are grouped by
         
     | 
| 
       2480 
2483 
     | 
    
         
             
            each key.</p>
         
     | 
| 
       2481 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 2484 
     | 
    
         
            +
            <p>Here is a simple <code class="docutils literal"><span class="pre">drilldown</span></code> example:</p>
         
     | 
| 
       2482 
2485 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2483 
2486 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       2484 
2487 
     | 
    
         
             
              --output_columns _key,tag \
         
     | 
| 
         @@ -2556,7 +2559,7 @@ each key.</p> 
     | 
|
| 
       2556 
2559 
     | 
    
         
             
            # ]
         
     | 
| 
       2557 
2560 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2558 
2561 
     | 
    
         
             
            </div>
         
     | 
| 
       2559 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 2562 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs the following information:</p>
         
     | 
| 
       2560 
2563 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       2561 
2564 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       2562 
2565 
     | 
    
         
             
            <li>There is one record that has "Hello" tag.</li>
         
     | 
| 
         @@ -2564,7 +2567,7 @@ each key.</p> 
     | 
|
| 
       2564 
2567 
     | 
    
         
             
            <li>There is two records that has "Senna" tag.</li>
         
     | 
| 
       2565 
2568 
     | 
    
         
             
            </ul>
         
     | 
| 
       2566 
2569 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       2567 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 2570 
     | 
    
         
            +
            <p>Here is a <code class="docutils literal"><span class="pre">drilldown</span></code> with search condition example:</p>
         
     | 
| 
       2568 
2571 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2569 
2572 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       2570 
2573 
     | 
    
         
             
              --output_columns _key,tag \
         
     | 
| 
         @@ -2631,17 +2634,17 @@ each key.</p> 
     | 
|
| 
       2631 
2634 
     | 
    
         
             
            # ]
         
     | 
| 
       2632 
2635 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2633 
2636 
     | 
    
         
             
            </div>
         
     | 
| 
       2634 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 2637 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs the following information:</p>
         
     | 
| 
       2635 
2638 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       2636 
2639 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       2637 
     | 
    
         
            -
            <li>In records that have 5 or larger as < 
     | 
| 
      
 2640 
     | 
    
         
            +
            <li>In records that have 5 or larger as <code class="docutils literal"><span class="pre">n_likes</span></code> value:<ul>
         
     | 
| 
       2638 
2641 
     | 
    
         
             
            <li>There is one record that has "Hello" tag.</li>
         
     | 
| 
       2639 
2642 
     | 
    
         
             
            <li>There is two records that has "Groonga" tag.</li>
         
     | 
| 
       2640 
2643 
     | 
    
         
             
            </ul>
         
     | 
| 
       2641 
2644 
     | 
    
         
             
            </li>
         
     | 
| 
       2642 
2645 
     | 
    
         
             
            </ul>
         
     | 
| 
       2643 
2646 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       2644 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 2647 
     | 
    
         
            +
            <p>Here is a <code class="docutils literal"><span class="pre">drilldown</span></code> with multiple group keys example:</p>
         
     | 
| 
       2645 
2648 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2646 
2649 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       2647 
2650 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -2743,16 +2746,16 @@ each key.</p> 
     | 
|
| 
       2743 
2746 
     | 
    
         
             
            # ]
         
     | 
| 
       2744 
2747 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2745 
2748 
     | 
    
         
             
            </div>
         
     | 
| 
       2746 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 2749 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs the following information:</p>
         
     | 
| 
       2747 
2750 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       2748 
2751 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       2749 
     | 
    
         
            -
            <li>About < 
     | 
| 
      
 2752 
     | 
    
         
            +
            <li>About <code class="docutils literal"><span class="pre">tag</span></code>:<ul>
         
     | 
| 
       2750 
2753 
     | 
    
         
             
            <li>There is one record that has "Hello" tag.</li>
         
     | 
| 
       2751 
2754 
     | 
    
         
             
            <li>There is two records that has "Groonga" tag.</li>
         
     | 
| 
       2752 
2755 
     | 
    
         
             
            <li>There is two records that has "Senna" tag.</li>
         
     | 
| 
       2753 
2756 
     | 
    
         
             
            </ul>
         
     | 
| 
       2754 
2757 
     | 
    
         
             
            </li>
         
     | 
| 
       2755 
     | 
    
         
            -
            <li>About < 
     | 
| 
      
 2758 
     | 
    
         
            +
            <li>About <code class="docutils literal"><span class="pre">n_likes</span></code>:<ul>
         
     | 
| 
       2756 
2759 
     | 
    
         
             
            <li>There is one record that has "Hello" tag.</li>
         
     | 
| 
       2757 
2760 
     | 
    
         
             
            <li>There is two records that has "Groonga" tag.</li>
         
     | 
| 
       2758 
2761 
     | 
    
         
             
            <li>There is two records that has "Senna" tag.</li>
         
     | 
| 
         @@ -2762,12 +2765,12 @@ each key.</p> 
     | 
|
| 
       2762 
2765 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       2763 
2766 
     | 
    
         
             
            </div>
         
     | 
| 
       2764 
2767 
     | 
    
         
             
            <div class="section" id="drilldown-sortby">
         
     | 
| 
       2765 
     | 
    
         
            -
            <span id="select-drilldown-sortby"></span><h4>7.3. 
     | 
| 
       2766 
     | 
    
         
            -
            <p>Specifies sort keys for drilldown outputs separated by < 
     | 
| 
      
 2768 
     | 
    
         
            +
            <span id="select-drilldown-sortby"></span><h4>7.3.41.4.5.2. <code class="docutils literal"><span class="pre">drilldown_sortby</span></code><a class="headerlink" href="#drilldown-sortby" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 2769 
     | 
    
         
            +
            <p>Specifies sort keys for drilldown outputs separated by <code class="docutils literal"><span class="pre">,</span></code>. Each
         
     | 
| 
       2767 
2770 
     | 
    
         
             
            sort key is column name.</p>
         
     | 
| 
       2768 
     | 
    
         
            -
            <p>You can refer the number of grouped records by < 
     | 
| 
      
 2771 
     | 
    
         
            +
            <p>You can refer the number of grouped records by <code class="docutils literal"><span class="pre">_nsubrecs</span></code>
         
     | 
| 
       2769 
2772 
     | 
    
         
             
            <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a>.</p>
         
     | 
| 
       2770 
     | 
    
         
            -
            <p>Here is a simple < 
     | 
| 
      
 2773 
     | 
    
         
            +
            <p>Here is a simple <code class="docutils literal"><span class="pre">drilldown_sortby</span></code> example:</p>
         
     | 
| 
       2771 
2774 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2772 
2775 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       2773 
2776 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -2871,10 +2874,10 @@ sort key is column name.</p> 
     | 
|
| 
       2871 
2874 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2872 
2875 
     | 
    
         
             
            </div>
         
     | 
| 
       2873 
2876 
     | 
    
         
             
            <p>Drilldown result is sorted by the number of grouped records (=
         
     | 
| 
       2874 
     | 
    
         
            -
            < 
     | 
| 
      
 2877 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">_nsubrecs</span></code> ) in descending order. If there are grouped results that
         
     | 
| 
       2875 
2878 
     | 
    
         
             
            the number of records in the group are the same, these grouped results
         
     | 
| 
       2876 
     | 
    
         
            -
            are sorted by grouped key (= < 
     | 
| 
       2877 
     | 
    
         
            -
            <p>The sort keys are used in all group keys specified in < 
     | 
| 
      
 2879 
     | 
    
         
            +
            are sorted by grouped key (= <code class="docutils literal"><span class="pre">_key</span></code> ) in ascending order.</p>
         
     | 
| 
      
 2880 
     | 
    
         
            +
            <p>The sort keys are used in all group keys specified in <code class="docutils literal"><span class="pre">drilldown</span></code>:</p>
         
     | 
| 
       2878 
2881 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2879 
2882 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       2880 
2883 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -2977,15 +2980,15 @@ are sorted by grouped key (= <tt class="docutils literal"><span class="pre">_key 
     | 
|
| 
       2977 
2980 
     | 
    
         
             
            # ]
         
     | 
| 
       2978 
2981 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       2979 
2982 
     | 
    
         
             
            </div>
         
     | 
| 
       2980 
     | 
    
         
            -
            <p>The same sort keys are used in < 
     | 
| 
      
 2983 
     | 
    
         
            +
            <p>The same sort keys are used in <code class="docutils literal"><span class="pre">tag</span></code> drilldown and <code class="docutils literal"><span class="pre">n_likes</span></code>
         
     | 
| 
       2981 
2984 
     | 
    
         
             
            drilldown.</p>
         
     | 
| 
       2982 
2985 
     | 
    
         
             
            <p>If you want to use different sort keys for each drilldown, use
         
     | 
| 
       2983 
     | 
    
         
            -
            <a class="reference internal" href="#select-advanced-drilldown-related-parameters">< 
     | 
| 
      
 2986 
     | 
    
         
            +
            <a class="reference internal" href="#select-advanced-drilldown-related-parameters"><span>Advanced drilldown related parameters</span></a>.</p>
         
     | 
| 
       2984 
2987 
     | 
    
         
             
            </div>
         
     | 
| 
       2985 
2988 
     | 
    
         
             
            <div class="section" id="drilldown-output-columns">
         
     | 
| 
       2986 
     | 
    
         
            -
            <span id="select-drilldown-output-columns"></span><h4>7.3. 
     | 
| 
       2987 
     | 
    
         
            -
            <p>Specifies output columns for drilldown separated by < 
     | 
| 
       2988 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 2989 
     | 
    
         
            +
            <span id="select-drilldown-output-columns"></span><h4>7.3.41.4.5.3. <code class="docutils literal"><span class="pre">drilldown_output_columns</span></code><a class="headerlink" href="#drilldown-output-columns" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 2990 
     | 
    
         
            +
            <p>Specifies output columns for drilldown separated by <code class="docutils literal"><span class="pre">,</span></code>.</p>
         
     | 
| 
      
 2991 
     | 
    
         
            +
            <p>Here is a <code class="docutils literal"><span class="pre">drilldown_output_columns</span></code> example:</p>
         
     | 
| 
       2989 
2992 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       2990 
2993 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       2991 
2994 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -3050,7 +3053,7 @@ drilldown.</p> 
     | 
|
| 
       3050 
3053 
     | 
    
         
             
            # ]
         
     | 
| 
       3051 
3054 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3052 
3055 
     | 
    
         
             
            </div>
         
     | 
| 
       3053 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 3056 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command just outputs grouped key.</p>
         
     | 
| 
       3054 
3057 
     | 
    
         
             
            <p>If grouped key is a referenced type column (= column that its type is
         
     | 
| 
       3055 
3058 
     | 
    
         
             
            a table), you can access column of the table referenced by the
         
     | 
| 
       3056 
3059 
     | 
    
         
             
            referenced type column.</p>
         
     | 
| 
         @@ -3082,10 +3085,10 @@ load --table Items 
     | 
|
| 
       3082 
3085 
     | 
    
         
             
            # [[0, 1337566253.89858, 0.000355720520019531], 3]
         
     | 
| 
       3083 
3086 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3084 
3087 
     | 
    
         
             
            </div>
         
     | 
| 
       3085 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 3088 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">Tags</span></code> table is a referenced table. <code class="docutils literal"><span class="pre">Items.tag</span></code> is a referenced
         
     | 
| 
       3086 
3089 
     | 
    
         
             
            type column.</p>
         
     | 
| 
       3087 
     | 
    
         
            -
            <p>You can refer < 
     | 
| 
       3088 
     | 
    
         
            -
            < 
     | 
| 
      
 3090 
     | 
    
         
            +
            <p>You can refer <code class="docutils literal"><span class="pre">Tags.label</span></code> by <code class="docutils literal"><span class="pre">label</span></code> in
         
     | 
| 
      
 3091 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown_output_columns</span></code>:</p>
         
     | 
| 
       3089 
3092 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3090 
3093 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Items \
         
     | 
| 
       3091 
3094 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -3145,7 +3148,7 @@ type column.</p> 
     | 
|
| 
       3145 
3148 
     | 
    
         
             
            # ]
         
     | 
| 
       3146 
3149 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3147 
3150 
     | 
    
         
             
            </div>
         
     | 
| 
       3148 
     | 
    
         
            -
            <p>You can use < 
     | 
| 
      
 3151 
     | 
    
         
            +
            <p>You can use <code class="docutils literal"><span class="pre">*</span></code> to refer all columns in referenced table (= <code class="docutils literal"><span class="pre">Tags</span></code>):</p>
         
     | 
| 
       3149 
3152 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3150 
3153 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Items \
         
     | 
| 
       3151 
3154 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -3211,21 +3214,21 @@ type column.</p> 
     | 
|
| 
       3211 
3214 
     | 
    
         
             
            # ]
         
     | 
| 
       3212 
3215 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3213 
3216 
     | 
    
         
             
            </div>
         
     | 
| 
       3214 
     | 
    
         
            -
            <p>< 
     | 
| 
       3215 
     | 
    
         
            -
            <p>The default value of < 
     | 
| 
       3216 
     | 
    
         
            -
            <span class="pre">_nsubrecs</span></ 
     | 
| 
      
 3217 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">*</span></code> is expanded to <code class="docutils literal"><span class="pre">label,</span> <span class="pre">priority</span></code>.</p>
         
     | 
| 
      
 3218 
     | 
    
         
            +
            <p>The default value of <code class="docutils literal"><span class="pre">drilldown_output_columns</span></code> is <code class="docutils literal"><span class="pre">_key,</span>
         
     | 
| 
      
 3219 
     | 
    
         
            +
            <span class="pre">_nsubrecs</span></code>. It means that grouped key and the number of records in
         
     | 
| 
       3217 
3220 
     | 
    
         
             
            the group are output.</p>
         
     | 
| 
       3218 
3221 
     | 
    
         
             
            <p>You can use more <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> in
         
     | 
| 
       3219 
     | 
    
         
            -
            < 
     | 
| 
       3220 
     | 
    
         
            -
            < 
     | 
| 
       3221 
     | 
    
         
            -
            < 
     | 
| 
      
 3222 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown_output_columns</span></code> such as <code class="docutils literal"><span class="pre">_max</span></code>, <code class="docutils literal"><span class="pre">_min</span></code>, <code class="docutils literal"><span class="pre">_sum</span></code> and
         
     | 
| 
      
 3223 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">_avg</span></code> when you use <a class="reference internal" href="#select-drilldown-calc-types"><span>drilldown_calc_types</span></a>. See
         
     | 
| 
      
 3224 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown_calc_types</span></code> document for details.</p>
         
     | 
| 
       3222 
3225 
     | 
    
         
             
            </div>
         
     | 
| 
       3223 
3226 
     | 
    
         
             
            <div class="section" id="drilldown-offset">
         
     | 
| 
       3224 
     | 
    
         
            -
            <span id="select-drilldown-offset"></span><h4>7.3. 
     | 
| 
      
 3227 
     | 
    
         
            +
            <span id="select-drilldown-offset"></span><h4>7.3.41.4.5.4. <code class="docutils literal"><span class="pre">drilldown_offset</span></code><a class="headerlink" href="#drilldown-offset" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
       3225 
3228 
     | 
    
         
             
            <p>Specifies offset to determine range of drilldown output
         
     | 
| 
       3226 
     | 
    
         
            -
            records. Offset is zero-based. < 
     | 
| 
      
 3229 
     | 
    
         
            +
            records. Offset is zero-based. <code class="docutils literal"><span class="pre">--drilldown_offset</span> <span class="pre">1</span></code> means output
         
     | 
| 
       3227 
3230 
     | 
    
         
             
            range is started from the 2nd record.</p>
         
     | 
| 
       3228 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 3231 
     | 
    
         
            +
            <p>Here is a <code class="docutils literal"><span class="pre">drilldown_offset</span></code> example:</p>
         
     | 
| 
       3229 
3232 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3230 
3233 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3231 
3234 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -3294,11 +3297,11 @@ range is started from the 2nd record.</p> 
     | 
|
| 
       3294 
3297 
     | 
    
         
             
            # ]
         
     | 
| 
       3295 
3298 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3296 
3299 
     | 
    
         
             
            </div>
         
     | 
| 
       3297 
     | 
    
         
            -
            <p>The < 
     | 
| 
       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 
     | 
    
         
            -
            (< 
     | 
| 
      
 3300 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs from the 2nd record.</p>
         
     | 
| 
      
 3301 
     | 
    
         
            +
            <p>You can specify negative value. It means that <code class="docutils literal"><span class="pre">the</span> <span class="pre">number</span> <span class="pre">of</span> <span class="pre">grouped</span>
         
     | 
| 
      
 3302 
     | 
    
         
            +
            <span class="pre">results</span> <span class="pre">+</span> <span class="pre">offset</span></code>. If you have 3 grouped results and specify
         
     | 
| 
      
 3303 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">--drilldown_offset</span> <span class="pre">-2</span></code>, you get grouped results from the 2st
         
     | 
| 
      
 3304 
     | 
    
         
            +
            (<code class="docutils literal"><span class="pre">3</span> <span class="pre">+</span> <span class="pre">-2</span> <span class="pre">=</span> <span class="pre">1</span></code>. <code class="docutils literal"><span class="pre">1</span></code> means 2nd. Remember that offset is zero-based.)
         
     | 
| 
       3302 
3305 
     | 
    
         
             
            grouped result to the 3rd grouped result.</p>
         
     | 
| 
       3303 
3306 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3304 
3307 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
         @@ -3368,15 +3371,15 @@ grouped result to the 3rd grouped result.</p> 
     | 
|
| 
       3368 
3371 
     | 
    
         
             
            # ]
         
     | 
| 
       3369 
3372 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3370 
3373 
     | 
    
         
             
            </div>
         
     | 
| 
       3371 
     | 
    
         
            -
            <p>The < 
     | 
| 
       3372 
     | 
    
         
            -
            total number of grouped results is < 
     | 
| 
       3373 
     | 
    
         
            -
            <p>The default value of < 
     | 
| 
      
 3374 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs from the 2nd grouped result because the
         
     | 
| 
      
 3375 
     | 
    
         
            +
            total number of grouped results is <code class="docutils literal"><span class="pre">3</span></code>.</p>
         
     | 
| 
      
 3376 
     | 
    
         
            +
            <p>The default value of <code class="docutils literal"><span class="pre">drilldown_offset</span></code> is <code class="docutils literal"><span class="pre">0</span></code>.</p>
         
     | 
| 
       3374 
3377 
     | 
    
         
             
            </div>
         
     | 
| 
       3375 
3378 
     | 
    
         
             
            <div class="section" id="drilldown-limit">
         
     | 
| 
       3376 
     | 
    
         
            -
            <span id="select-drilldown-limit"></span><h4>7.3. 
     | 
| 
      
 3379 
     | 
    
         
            +
            <span id="select-drilldown-limit"></span><h4>7.3.41.4.5.5. <code class="docutils literal"><span class="pre">drilldown_limit</span></code><a class="headerlink" href="#drilldown-limit" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
       3377 
3380 
     | 
    
         
             
            <p>Specifies the max number of groups in a drilldown. If the number of
         
     | 
| 
       3378 
     | 
    
         
            -
            groups is less than < 
     | 
| 
       3379 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 3381 
     | 
    
         
            +
            groups is less than <code class="docutils literal"><span class="pre">drilldown_limit</span></code>, all groups are outputted.</p>
         
     | 
| 
      
 3382 
     | 
    
         
            +
            <p>Here is a <code class="docutils literal"><span class="pre">drilldown_limit</span></code> example:</p>
         
     | 
| 
       3380 
3383 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3381 
3384 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3382 
3385 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -3446,11 +3449,11 @@ groups is less than <tt class="docutils literal"><span class="pre">drilldown_lim 
     | 
|
| 
       3446 
3449 
     | 
    
         
             
            # ]
         
     | 
| 
       3447 
3450 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3448 
3451 
     | 
    
         
             
            </div>
         
     | 
| 
       3449 
     | 
    
         
            -
            <p>The < 
     | 
| 
       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></ 
     | 
| 
      
 3452 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs the 2rd and the 3rd groups.</p>
         
     | 
| 
      
 3453 
     | 
    
         
            +
            <p>You can specify negative value. It means that <code class="docutils literal"><span class="pre">the</span> <span class="pre">number</span> <span class="pre">of</span> <span class="pre">groups</span> <span class="pre">+</span>
         
     | 
| 
      
 3454 
     | 
    
         
            +
            <span class="pre">drilldown_limit</span> <span class="pre">+</span> <span class="pre">1</span></code>. For example, <code class="docutils literal"><span class="pre">--drilldown_limit</span> <span class="pre">-1</span></code> outputs
         
     | 
| 
       3452 
3455 
     | 
    
         
             
            all groups. It's very useful value to show all groups.</p>
         
     | 
| 
       3453 
     | 
    
         
            -
            <p>Here is a negative < 
     | 
| 
      
 3456 
     | 
    
         
            +
            <p>Here is a negative <code class="docutils literal"><span class="pre">drilldown_limit</span></code> value example.</p>
         
     | 
| 
       3454 
3457 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3455 
3458 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3456 
3459 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -3523,19 +3526,19 @@ all groups. It's very useful value to show all groups.</p> 
     | 
|
| 
       3523 
3526 
     | 
    
         
             
            # ]
         
     | 
| 
       3524 
3527 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3525 
3528 
     | 
    
         
             
            </div>
         
     | 
| 
       3526 
     | 
    
         
            -
            <p>The < 
     | 
| 
       3527 
     | 
    
         
            -
            <p>The default value of < 
     | 
| 
      
 3529 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command outputs all groups.</p>
         
     | 
| 
      
 3530 
     | 
    
         
            +
            <p>The default value of <code class="docutils literal"><span class="pre">drilldown_limit</span></code> is <code class="docutils literal"><span class="pre">10</span></code>.</p>
         
     | 
| 
       3528 
3531 
     | 
    
         
             
            </div>
         
     | 
| 
       3529 
3532 
     | 
    
         
             
            <div class="section" id="drilldown-calc-types">
         
     | 
| 
       3530 
     | 
    
         
            -
            <span id="select-drilldown-calc-types"></span><h4>7.3. 
     | 
| 
      
 3533 
     | 
    
         
            +
            <span id="select-drilldown-calc-types"></span><h4>7.3.41.4.5.6. <code class="docutils literal"><span class="pre">drilldown_calc_types</span></code><a class="headerlink" href="#drilldown-calc-types" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
       3531 
3534 
     | 
    
         
             
            <p>Specifies how to calculate (aggregate) values in grouped records by
         
     | 
| 
       3532 
3535 
     | 
    
         
             
            a drilldown. You can specify multiple calculation types separated by
         
     | 
| 
       3533 
     | 
    
         
            -
            "< 
     | 
| 
      
 3536 
     | 
    
         
            +
            "<code class="docutils literal"><span class="pre">,</span></code>". For example, <code class="docutils literal"><span class="pre">MAX,MIN</span></code>.</p>
         
     | 
| 
       3534 
3537 
     | 
    
         
             
            <p>Calculation target values are read from a column of grouped
         
     | 
| 
       3535 
3538 
     | 
    
         
             
            records. The column is specified by
         
     | 
| 
       3536 
     | 
    
         
            -
            <a class="reference internal" href="#select-drilldown-calc-target">< 
     | 
| 
      
 3539 
     | 
    
         
            +
            <a class="reference internal" href="#select-drilldown-calc-target"><span>drilldown_calc_target</span></a>.</p>
         
     | 
| 
       3537 
3540 
     | 
    
         
             
            <p>You can read calculated value by <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> such
         
     | 
| 
       3538 
     | 
    
         
            -
            as < 
     | 
| 
      
 3541 
     | 
    
         
            +
            as <code class="docutils literal"><span class="pre">_max</span></code> and <code class="docutils literal"><span class="pre">_min</span></code> in <a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a>.</p>
         
     | 
| 
       3539 
3542 
     | 
    
         
             
            <p>You can use the following calculation types:</p>
         
     | 
| 
       3540 
3543 
     | 
    
         
             
            <table border="1" class="docutils">
         
     | 
| 
       3541 
3544 
     | 
    
         
             
            <colgroup>
         
     | 
| 
         @@ -3547,47 +3550,47 @@ as <tt class="docutils literal"><span class="pre">_max</span></tt> and <tt class 
     | 
|
| 
       3547 
3550 
     | 
    
         
             
            <thead valign="bottom">
         
     | 
| 
       3548 
3551 
     | 
    
         
             
            <tr class="row-odd"><th class="head">Type name</th>
         
     | 
| 
       3549 
3552 
     | 
    
         
             
            <th class="head"><a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> name</th>
         
     | 
| 
       3550 
     | 
    
         
            -
            <th class="head">Need <a class="reference internal" href="#select-drilldown-calc-target">< 
     | 
| 
      
 3553 
     | 
    
         
            +
            <th class="head">Need <a class="reference internal" href="#select-drilldown-calc-target"><span>drilldown_calc_target</span></a></th>
         
     | 
| 
       3551 
3554 
     | 
    
         
             
            <th class="head">Description</th>
         
     | 
| 
       3552 
3555 
     | 
    
         
             
            </tr>
         
     | 
| 
       3553 
3556 
     | 
    
         
             
            </thead>
         
     | 
| 
       3554 
3557 
     | 
    
         
             
            <tbody valign="top">
         
     | 
| 
       3555 
     | 
    
         
            -
            <tr class="row-even"><td>< 
     | 
| 
      
 3558 
     | 
    
         
            +
            <tr class="row-even"><td><code class="docutils literal"><span class="pre">NONE</span></code></td>
         
     | 
| 
       3556 
3559 
     | 
    
         
             
            <td>Nothing.</td>
         
     | 
| 
       3557 
3560 
     | 
    
         
             
            <td>Not needs.</td>
         
     | 
| 
       3558 
3561 
     | 
    
         
             
            <td>Just ignored.</td>
         
     | 
| 
       3559 
3562 
     | 
    
         
             
            </tr>
         
     | 
| 
       3560 
     | 
    
         
            -
            <tr class="row-odd"><td>< 
     | 
| 
       3561 
     | 
    
         
            -
            <td>< 
     | 
| 
      
 3563 
     | 
    
         
            +
            <tr class="row-odd"><td><code class="docutils literal"><span class="pre">COUNT</span></code></td>
         
     | 
| 
      
 3564 
     | 
    
         
            +
            <td><code class="docutils literal"><span class="pre">_nsubrecs</span></code></td>
         
     | 
| 
       3562 
3565 
     | 
    
         
             
            <td>Not needs.</td>
         
     | 
| 
       3563 
3566 
     | 
    
         
             
            <td>Counting grouped records. It's always enabled. So you don't
         
     | 
| 
       3564 
     | 
    
         
            -
            specify it.</td>
         
     | 
| 
      
 3567 
     | 
    
         
            +
            need to specify it.</td>
         
     | 
| 
       3565 
3568 
     | 
    
         
             
            </tr>
         
     | 
| 
       3566 
     | 
    
         
            -
            <tr class="row-even"><td>< 
     | 
| 
       3567 
     | 
    
         
            -
            <td>< 
     | 
| 
      
 3569 
     | 
    
         
            +
            <tr class="row-even"><td><code class="docutils literal"><span class="pre">MAX</span></code></td>
         
     | 
| 
      
 3570 
     | 
    
         
            +
            <td><code class="docutils literal"><span class="pre">_max</span></code></td>
         
     | 
| 
       3568 
3571 
     | 
    
         
             
            <td>Needs.</td>
         
     | 
| 
       3569 
3572 
     | 
    
         
             
            <td>Finding the maximum integer value from integer values in
         
     | 
| 
       3570 
3573 
     | 
    
         
             
            grouped records.</td>
         
     | 
| 
       3571 
3574 
     | 
    
         
             
            </tr>
         
     | 
| 
       3572 
     | 
    
         
            -
            <tr class="row-odd"><td>< 
     | 
| 
       3573 
     | 
    
         
            -
            <td>< 
     | 
| 
      
 3575 
     | 
    
         
            +
            <tr class="row-odd"><td><code class="docutils literal"><span class="pre">MIN</span></code></td>
         
     | 
| 
      
 3576 
     | 
    
         
            +
            <td><code class="docutils literal"><span class="pre">_min</span></code></td>
         
     | 
| 
       3574 
3577 
     | 
    
         
             
            <td>Needs.</td>
         
     | 
| 
       3575 
3578 
     | 
    
         
             
            <td>Finding the minimum integer value from integer values in
         
     | 
| 
       3576 
3579 
     | 
    
         
             
            grouped records.</td>
         
     | 
| 
       3577 
3580 
     | 
    
         
             
            </tr>
         
     | 
| 
       3578 
     | 
    
         
            -
            <tr class="row-even"><td>< 
     | 
| 
       3579 
     | 
    
         
            -
            <td>< 
     | 
| 
      
 3581 
     | 
    
         
            +
            <tr class="row-even"><td><code class="docutils literal"><span class="pre">SUM</span></code></td>
         
     | 
| 
      
 3582 
     | 
    
         
            +
            <td><code class="docutils literal"><span class="pre">_sum</span></code></td>
         
     | 
| 
       3580 
3583 
     | 
    
         
             
            <td>Needs.</td>
         
     | 
| 
       3581 
3584 
     | 
    
         
             
            <td>Summing integer values in grouped records.</td>
         
     | 
| 
       3582 
3585 
     | 
    
         
             
            </tr>
         
     | 
| 
       3583 
     | 
    
         
            -
            <tr class="row-odd"><td>< 
     | 
| 
       3584 
     | 
    
         
            -
            <td>< 
     | 
| 
      
 3586 
     | 
    
         
            +
            <tr class="row-odd"><td><code class="docutils literal"><span class="pre">AVG</span></code></td>
         
     | 
| 
      
 3587 
     | 
    
         
            +
            <td><code class="docutils literal"><span class="pre">_avg</span></code></td>
         
     | 
| 
       3585 
3588 
     | 
    
         
             
            <td>Needs.</td>
         
     | 
| 
       3586 
3589 
     | 
    
         
             
            <td>Averaging integer/float values in grouped records.</td>
         
     | 
| 
       3587 
3590 
     | 
    
         
             
            </tr>
         
     | 
| 
       3588 
3591 
     | 
    
         
             
            </tbody>
         
     | 
| 
       3589 
3592 
     | 
    
         
             
            </table>
         
     | 
| 
       3590 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 3593 
     | 
    
         
            +
            <p>Here is a <code class="docutils literal"><span class="pre">MAX</span></code> example:</p>
         
     | 
| 
       3591 
3594 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3592 
3595 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3593 
3596 
     | 
    
         
             
              --limit -1 \
         
     | 
| 
         @@ -3696,12 +3699,12 @@ grouped records.</td> 
     | 
|
| 
       3696 
3699 
     | 
    
         
             
            # ]
         
     | 
| 
       3697 
3700 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3698 
3701 
     | 
    
         
             
            </div>
         
     | 
| 
       3699 
     | 
    
         
            -
            <p>The < 
     | 
| 
       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 < 
     | 
| 
      
 3702 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command groups all records by <code class="docutils literal"><span class="pre">tag</span></code> column value,
         
     | 
| 
      
 3703 
     | 
    
         
            +
            finding the maximum <code class="docutils literal"><span class="pre">n_likes</span></code> column value for each group and
         
     | 
| 
      
 3704 
     | 
    
         
            +
            outputs pairs of grouped key and the maximum <code class="docutils literal"><span class="pre">n_likes</span></code> column value
         
     | 
| 
      
 3705 
     | 
    
         
            +
            for the group. It uses <code class="docutils literal"><span class="pre">_max</span></code> <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to
         
     | 
| 
      
 3706 
     | 
    
         
            +
            read the maximum <code class="docutils literal"><span class="pre">n_likes</span></code> column value.</p>
         
     | 
| 
      
 3707 
     | 
    
         
            +
            <p>Here is a <code class="docutils literal"><span class="pre">MIN</span></code> example:</p>
         
     | 
| 
       3705 
3708 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3706 
3709 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3707 
3710 
     | 
    
         
             
              --limit -1 \
         
     | 
| 
         @@ -3810,12 +3813,12 @@ read the maximum <tt class="docutils literal"><span class="pre">n_likes</span></ 
     | 
|
| 
       3810 
3813 
     | 
    
         
             
            # ]
         
     | 
| 
       3811 
3814 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3812 
3815 
     | 
    
         
             
            </div>
         
     | 
| 
       3813 
     | 
    
         
            -
            <p>The < 
     | 
| 
       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 < 
     | 
| 
      
 3816 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command groups all records by <code class="docutils literal"><span class="pre">tag</span></code> column value,
         
     | 
| 
      
 3817 
     | 
    
         
            +
            finding the minimum <code class="docutils literal"><span class="pre">n_likes</span></code> column value for each group and
         
     | 
| 
      
 3818 
     | 
    
         
            +
            outputs pairs of grouped key and the minimum <code class="docutils literal"><span class="pre">n_likes</span></code> column value
         
     | 
| 
      
 3819 
     | 
    
         
            +
            for the group. It uses <code class="docutils literal"><span class="pre">_min</span></code> <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to
         
     | 
| 
      
 3820 
     | 
    
         
            +
            read the minimum <code class="docutils literal"><span class="pre">n_likes</span></code> column value.</p>
         
     | 
| 
      
 3821 
     | 
    
         
            +
            <p>Here is a <code class="docutils literal"><span class="pre">SUM</span></code> example:</p>
         
     | 
| 
       3819 
3822 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3820 
3823 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3821 
3824 
     | 
    
         
             
              --limit -1 \
         
     | 
| 
         @@ -3924,12 +3927,12 @@ read the minimum <tt class="docutils literal"><span class="pre">n_likes</span></ 
     | 
|
| 
       3924 
3927 
     | 
    
         
             
            # ]
         
     | 
| 
       3925 
3928 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       3926 
3929 
     | 
    
         
             
            </div>
         
     | 
| 
       3927 
     | 
    
         
            -
            <p>The < 
     | 
| 
       3928 
     | 
    
         
            -
            sums all < 
     | 
| 
       3929 
     | 
    
         
            -
            of grouped key and the summed < 
     | 
| 
       3930 
     | 
    
         
            -
            group. It uses < 
     | 
| 
       3931 
     | 
    
         
            -
            summed < 
     | 
| 
       3932 
     | 
    
         
            -
            <p>Here is a < 
     | 
| 
      
 3930 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command groups all records by <code class="docutils literal"><span class="pre">tag</span></code> column value,
         
     | 
| 
      
 3931 
     | 
    
         
            +
            sums all <code class="docutils literal"><span class="pre">n_likes</span></code> column values for each group and outputs pairs
         
     | 
| 
      
 3932 
     | 
    
         
            +
            of grouped key and the summed <code class="docutils literal"><span class="pre">n_likes</span></code> column values for the
         
     | 
| 
      
 3933 
     | 
    
         
            +
            group. It uses <code class="docutils literal"><span class="pre">_sum</span></code> <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to read the
         
     | 
| 
      
 3934 
     | 
    
         
            +
            summed <code class="docutils literal"><span class="pre">n_likes</span></code> column values.</p>
         
     | 
| 
      
 3935 
     | 
    
         
            +
            <p>Here is a <code class="docutils literal"><span class="pre">AVG</span></code> example:</p>
         
     | 
| 
       3933 
3936 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       3934 
3937 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       3935 
3938 
     | 
    
         
             
              --limit -1 \
         
     | 
| 
         @@ -4038,11 +4041,11 @@ summed <tt class="docutils literal"><span class="pre">n_likes</span></tt> column 
     | 
|
| 
       4038 
4041 
     | 
    
         
             
            # ]
         
     | 
| 
       4039 
4042 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4040 
4043 
     | 
    
         
             
            </div>
         
     | 
| 
       4041 
     | 
    
         
            -
            <p>The < 
     | 
| 
       4042 
     | 
    
         
            -
            averages all < 
     | 
| 
       4043 
     | 
    
         
            -
            pairs of grouped key and the averaged < 
     | 
| 
       4044 
     | 
    
         
            -
            the group. It uses < 
     | 
| 
       4045 
     | 
    
         
            -
            the averaged < 
     | 
| 
      
 4044 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command groups all records by <code class="docutils literal"><span class="pre">tag</span></code> column value,
         
     | 
| 
      
 4045 
     | 
    
         
            +
            averages all <code class="docutils literal"><span class="pre">n_likes</span></code> column values for each group and outputs
         
     | 
| 
      
 4046 
     | 
    
         
            +
            pairs of grouped key and the averaged <code class="docutils literal"><span class="pre">n_likes</span></code> column values for
         
     | 
| 
      
 4047 
     | 
    
         
            +
            the group. It uses <code class="docutils literal"><span class="pre">_avg</span></code> <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to read
         
     | 
| 
      
 4048 
     | 
    
         
            +
            the averaged <code class="docutils literal"><span class="pre">n_likes</span></code> column values.</p>
         
     | 
| 
       4046 
4049 
     | 
    
         
             
            <p>Here is an example that uses all calculation types:</p>
         
     | 
| 
       4047 
4050 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4048 
4051 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
         @@ -4180,107 +4183,112 @@ the averaged <tt class="docutils literal"><span class="pre">n_likes</span></tt> 
     | 
|
| 
       4180 
4183 
     | 
    
         
             
            # ]
         
     | 
| 
       4181 
4184 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4182 
4185 
     | 
    
         
             
            </div>
         
     | 
| 
       4183 
     | 
    
         
            -
            <p>The < 
     | 
| 
       4184 
     | 
    
         
            -
            by "< 
     | 
| 
      
 4186 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command specifies multiple calculation types separated
         
     | 
| 
      
 4187 
     | 
    
         
            +
            by "<code class="docutils literal"><span class="pre">,</span></code>" like <code class="docutils literal"><span class="pre">MAX,MIN,SUM,AVG</span></code>. You can use <code class="docutils literal"><span class="pre">_nsubrecs</span></code>
         
     | 
| 
       4185 
4188 
     | 
    
         
             
            <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> in
         
     | 
| 
       4186 
     | 
    
         
            -
            <a class="reference internal" href="#select-drilldown-output-columns">< 
     | 
| 
       4187 
     | 
    
         
            -
            < 
     | 
| 
       4188 
     | 
    
         
            -
            <p>The default value of < 
     | 
| 
       4189 
     | 
    
         
            -
            that only < 
     | 
| 
       4190 
     | 
    
         
            -
            < 
     | 
| 
      
 4189 
     | 
    
         
            +
            <a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a> without specifying <code class="docutils literal"><span class="pre">COUNT</span></code> in
         
     | 
| 
      
 4190 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown_calc_types</span></code>. Because <code class="docutils literal"><span class="pre">COUNT</span></code> is always enabled.</p>
         
     | 
| 
      
 4191 
     | 
    
         
            +
            <p>The default value of <code class="docutils literal"><span class="pre">drilldown_calc_types</span></code> is <code class="docutils literal"><span class="pre">NONE</span></code>. It means
         
     | 
| 
      
 4192 
     | 
    
         
            +
            that only <code class="docutils literal"><span class="pre">COUNT</span></code> is enabled. Because <code class="docutils literal"><span class="pre">NONE</span></code> is just ignored and
         
     | 
| 
      
 4193 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">COUNT</span></code> is always enabled.</p>
         
     | 
| 
       4191 
4194 
     | 
    
         
             
            </div>
         
     | 
| 
       4192 
4195 
     | 
    
         
             
            <div class="section" id="drilldown-calc-target">
         
     | 
| 
       4193 
     | 
    
         
            -
            <span id="select-drilldown-calc-target"></span><h4>7.3. 
     | 
| 
       4194 
     | 
    
         
            -
            <p>Specifies the target column for <a class="reference internal" href="#select-drilldown-calc-types">< 
     | 
| 
      
 4196 
     | 
    
         
            +
            <span id="select-drilldown-calc-target"></span><h4>7.3.41.4.5.7. <code class="docutils literal"><span class="pre">drilldown_calc_target</span></code><a class="headerlink" href="#drilldown-calc-target" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 4197 
     | 
    
         
            +
            <p>Specifies the target column for <a class="reference internal" href="#select-drilldown-calc-types"><span>drilldown_calc_types</span></a>.</p>
         
     | 
| 
       4195 
4198 
     | 
    
         
             
            <p>If you specify a calculation type that needs a target column such as
         
     | 
| 
       4196 
     | 
    
         
            -
            < 
     | 
| 
       4197 
     | 
    
         
            -
            < 
     | 
| 
       4198 
     | 
    
         
            -
            <p>You can specify only one column name like < 
     | 
| 
       4199 
     | 
    
         
            -
            <span class="pre">n_likes</span></ 
     | 
| 
       4200 
     | 
    
         
            -
            < 
     | 
| 
      
 4199 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">MAX</span></code> in <a class="reference internal" href="#select-drilldown-calc-types"><span>drilldown_calc_types</span></a> but you omit
         
     | 
| 
      
 4200 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown_calc_target</span></code>, the calculation result is always <code class="docutils literal"><span class="pre">0</span></code>.</p>
         
     | 
| 
      
 4201 
     | 
    
         
            +
            <p>You can specify only one column name like <code class="docutils literal"><span class="pre">--drilldown_calc_target</span>
         
     | 
| 
      
 4202 
     | 
    
         
            +
            <span class="pre">n_likes</span></code>. You can't specify multiple column name like
         
     | 
| 
      
 4203 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">--drilldown_calc_target</span> <span class="pre">_key,n_likes</span></code>.</p>
         
     | 
| 
       4201 
4204 
     | 
    
         
             
            <p>You can use referenced value from the target record by combining
         
     | 
| 
       4202 
     | 
    
         
            -
            "< 
     | 
| 
       4203 
     | 
    
         
            -
            <span class="pre">reference_column.nested_reference_column.value</span></ 
     | 
| 
       4204 
     | 
    
         
            -
            <p>See <a class="reference internal" href="#select-drilldown-calc-types">< 
     | 
| 
       4205 
     | 
    
         
            -
            < 
     | 
| 
       4206 
     | 
    
         
            -
            <p>The default value of < 
     | 
| 
      
 4205 
     | 
    
         
            +
            "<code class="docutils literal"><span class="pre">.</span></code>" like <code class="docutils literal"><span class="pre">--drilldown_calc_target</span>
         
     | 
| 
      
 4206 
     | 
    
         
            +
            <span class="pre">reference_column.nested_reference_column.value</span></code>.</p>
         
     | 
| 
      
 4207 
     | 
    
         
            +
            <p>See <a class="reference internal" href="#select-drilldown-calc-types"><span>drilldown_calc_types</span></a> to know how to use
         
     | 
| 
      
 4208 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown_calc_target</span></code>.</p>
         
     | 
| 
      
 4209 
     | 
    
         
            +
            <p>The default value of <code class="docutils literal"><span class="pre">drilldown_calc_target</span></code> is <code class="docutils literal"><span class="pre">null</span></code>. It means
         
     | 
| 
       4207 
4210 
     | 
    
         
             
            that no calculation target column is specified.</p>
         
     | 
| 
       4208 
4211 
     | 
    
         
             
            </div>
         
     | 
| 
       4209 
4212 
     | 
    
         
             
            </div>
         
     | 
| 
       4210 
4213 
     | 
    
         
             
            <div class="section" id="advanced-drilldown-related-parameters">
         
     | 
| 
       4211 
     | 
    
         
            -
            <span id="select-advanced-drilldown-related-parameters"></span><h3>7.3. 
     | 
| 
      
 4214 
     | 
    
         
            +
            <span id="select-advanced-drilldown-related-parameters"></span><h3>7.3.41.4.6. Advanced drilldown related parameters<a class="headerlink" href="#advanced-drilldown-related-parameters" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       4212 
4215 
     | 
    
         
             
            <p>You can get multiple drilldown results by specifying multiple group
         
     | 
| 
       4213 
     | 
    
         
            -
            keys by <a class="reference internal" href="#select-drilldown">< 
     | 
| 
      
 4216 
     | 
    
         
            +
            keys by <a class="reference internal" href="#select-drilldown"><span>drilldown</span></a>. But you need to use the same
         
     | 
| 
       4214 
4217 
     | 
    
         
             
            configuration for all drilldowns. For example,
         
     | 
| 
       4215 
     | 
    
         
            -
            <a class="reference internal" href="#select-drilldown-output-columns">< 
     | 
| 
      
 4218 
     | 
    
         
            +
            <a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a> is used by all drilldowns.</p>
         
     | 
| 
       4216 
4219 
     | 
    
         
             
            <p>You can use a configuration for each drilldown by the following
         
     | 
| 
       4217 
4220 
     | 
    
         
             
            parameters:</p>
         
     | 
| 
       4218 
4221 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4219 
4222 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4220 
     | 
    
         
            -
            <li>< 
     | 
| 
       4221 
     | 
    
         
            -
            <li>< 
     | 
| 
       4222 
     | 
    
         
            -
            <li>< 
     | 
| 
       4223 
     | 
    
         
            -
            <li>< 
     | 
| 
       4224 
     | 
    
         
            -
            <li>< 
     | 
| 
       4225 
     | 
    
         
            -
            <li>< 
     | 
| 
       4226 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 4223 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code></li>
         
     | 
| 
      
 4224 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].sortby</span></code></li>
         
     | 
| 
      
 4225 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code></li>
         
     | 
| 
      
 4226 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].offset</span></code></li>
         
     | 
| 
      
 4227 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].limit</span></code></li>
         
     | 
| 
      
 4228 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_types</span></code></li>
         
     | 
| 
      
 4229 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_target</span></code></li>
         
     | 
| 
       4227 
4230 
     | 
    
         
             
            </ul>
         
     | 
| 
       4228 
4231 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4229 
     | 
    
         
            -
            <p>< 
     | 
| 
       4230 
     | 
    
         
            -
            < 
     | 
| 
      
 4232 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">${LABEL}</span></code> is a variable. You can use the following characters for
         
     | 
| 
      
 4233 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">${LABEL}</span></code>:</p>
         
     | 
| 
       4231 
4234 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4232 
4235 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4233 
4236 
     | 
    
         
             
            <li>Alphabets</li>
         
     | 
| 
       4234 
4237 
     | 
    
         
             
            <li>Digits</li>
         
     | 
| 
       4235 
     | 
    
         
            -
            <li>< 
     | 
| 
       4236 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 4238 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">.</span></code></li>
         
     | 
| 
      
 4239 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">_</span></code></li>
         
     | 
| 
       4237 
4240 
     | 
    
         
             
            </ul>
         
     | 
| 
       4238 
4241 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4239 
     | 
    
         
            -
            < 
     | 
| 
      
 4242 
     | 
    
         
            +
            <div class="admonition note">
         
     | 
| 
      
 4243 
     | 
    
         
            +
            <p class="first admonition-title">Note</p>
         
     | 
| 
      
 4244 
     | 
    
         
            +
            <p class="last">You can use more characters but it's better that you use only these
         
     | 
| 
      
 4245 
     | 
    
         
            +
            characters.</p>
         
     | 
| 
      
 4246 
     | 
    
         
            +
            </div>
         
     | 
| 
      
 4247 
     | 
    
         
            +
            <p>Parameters that has the same <code class="docutils literal"><span class="pre">${LABEL}</span></code> value are grouped. Grouped
         
     | 
| 
       4240 
4248 
     | 
    
         
             
            parameters are used for one drilldown.</p>
         
     | 
| 
       4241 
4249 
     | 
    
         
             
            <p>For example, there are 2 groups for the following parameters:</p>
         
     | 
| 
       4242 
4250 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4243 
4251 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4244 
     | 
    
         
            -
            <li>< 
     | 
| 
       4245 
     | 
    
         
            -
            <li>< 
     | 
| 
       4246 
     | 
    
         
            -
            <li>< 
     | 
| 
       4247 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 4252 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">--drilldown[label1].keys</span> <span class="pre">_key</span></code></li>
         
     | 
| 
      
 4253 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">--drilldown[label1].output_columns</span> <span class="pre">_nsubrecs</span></code></li>
         
     | 
| 
      
 4254 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">--drilldown[label2].keys</span> <span class="pre">tag</span></code></li>
         
     | 
| 
      
 4255 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">--drilldown[label2].output_columns</span> <span class="pre">_key,_nsubrecs</span></code></li>
         
     | 
| 
       4248 
4256 
     | 
    
         
             
            </ul>
         
     | 
| 
       4249 
4257 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4250 
     | 
    
         
            -
            <p>< 
     | 
| 
       4251 
     | 
    
         
            -
            are grouped. < 
     | 
| 
       4252 
     | 
    
         
            -
            < 
     | 
| 
       4253 
     | 
    
         
            -
            <p>In < 
     | 
| 
      
 4258 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">drilldown[label1].keys</span></code> and <code class="docutils literal"><span class="pre">drilldown[label1].output_columns</span></code>
         
     | 
| 
      
 4259 
     | 
    
         
            +
            are grouped. <code class="docutils literal"><span class="pre">drilldown[label2].keys</span></code> and
         
     | 
| 
      
 4260 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown[label2].output_columns</span></code> are also grouped.</p>
         
     | 
| 
      
 4261 
     | 
    
         
            +
            <p>In <code class="docutils literal"><span class="pre">label1</span></code> group, <code class="docutils literal"><span class="pre">_key</span></code> is used for group key and <code class="docutils literal"><span class="pre">_nsubrecs</span></code>
         
     | 
| 
       4254 
4262 
     | 
    
         
             
            is used for output columns.</p>
         
     | 
| 
       4255 
     | 
    
         
            -
            <p>In < 
     | 
| 
       4256 
     | 
    
         
            -
            < 
     | 
| 
       4257 
     | 
    
         
            -
            <p>See document for corresponding < 
     | 
| 
      
 4263 
     | 
    
         
            +
            <p>In <code class="docutils literal"><span class="pre">label2</span></code> group, <code class="docutils literal"><span class="pre">tag</span></code> is used for group key and
         
     | 
| 
      
 4264 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">_key,_nsubrecs</span></code> is used for output columns.</p>
         
     | 
| 
      
 4265 
     | 
    
         
            +
            <p>See document for corresponding <code class="docutils literal"><span class="pre">drilldown_XXX</span></code> parameter to know how
         
     | 
| 
       4258 
4266 
     | 
    
         
             
            to use it for the following parameters:</p>
         
     | 
| 
       4259 
4267 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4260 
4268 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4261 
     | 
    
         
            -
            <li>< 
     | 
| 
       4262 
     | 
    
         
            -
            <li>< 
     | 
| 
       4263 
     | 
    
         
            -
            <li>< 
     | 
| 
       4264 
     | 
    
         
            -
            <li>< 
     | 
| 
       4265 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 4269 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].sortby</span></code>: <a class="reference internal" href="#select-drilldown-sortby"><span>drilldown_sortby</span></a></li>
         
     | 
| 
      
 4270 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].offset</span></code>: <a class="reference internal" href="#select-drilldown-offset"><span>drilldown_offset</span></a></li>
         
     | 
| 
      
 4271 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].limit</span></code>: <a class="reference internal" href="#select-drilldown-limit"><span>drilldown_limit</span></a></li>
         
     | 
| 
      
 4272 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_types</span></code>: <a class="reference internal" href="#select-drilldown-calc-types"><span>drilldown_calc_types</span></a></li>
         
     | 
| 
      
 4273 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].calc_target</span></code>: <a class="reference internal" href="#select-drilldown-calc-target"><span>drilldown_calc_target</span></a></li>
         
     | 
| 
       4266 
4274 
     | 
    
         
             
            </ul>
         
     | 
| 
       4267 
4275 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4268 
4276 
     | 
    
         
             
            <p>The following parameters are needed more description:</p>
         
     | 
| 
       4269 
4277 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4270 
4278 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4271 
     | 
    
         
            -
            <li>< 
     | 
| 
       4272 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 4279 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code></li>
         
     | 
| 
      
 4280 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code></li>
         
     | 
| 
       4273 
4281 
     | 
    
         
             
            </ul>
         
     | 
| 
       4274 
4282 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4275 
4283 
     | 
    
         
             
            <p>Output format is different a bit. It's also needed more description.</p>
         
     | 
| 
       4276 
4284 
     | 
    
         
             
            <div class="section" id="drilldown-label-keys">
         
     | 
| 
       4277 
     | 
    
         
            -
            <span id="select-drilldown-label-keys"></span><h4>7.3. 
     | 
| 
       4278 
     | 
    
         
            -
            <p><a class="reference internal" href="#select-drilldown">< 
     | 
| 
      
 4285 
     | 
    
         
            +
            <span id="select-drilldown-label-keys"></span><h4>7.3.41.4.6.1. <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code><a class="headerlink" href="#drilldown-label-keys" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 4286 
     | 
    
         
            +
            <p><a class="reference internal" href="#select-drilldown"><span>drilldown</span></a> can specify multiple keys for multiple
         
     | 
| 
       4279 
4287 
     | 
    
         
             
            drilldowns. But it can't specify multiple keys for one drilldown.</p>
         
     | 
| 
       4280 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4288 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> can't specify multiple keys for multiple
         
     | 
| 
       4281 
4289 
     | 
    
         
             
            drilldowns. But it can specify multiple keys for one drilldown.</p>
         
     | 
| 
       4282 
     | 
    
         
            -
            <p>You can specify multiple keys separated by "< 
     | 
| 
       4283 
     | 
    
         
            -
            <p>Here is an example to group by multiple keys, < 
     | 
| 
      
 4290 
     | 
    
         
            +
            <p>You can specify multiple keys separated by "<code class="docutils literal"><span class="pre">,</span></code>".</p>
         
     | 
| 
      
 4291 
     | 
    
         
            +
            <p>Here is an example to group by multiple keys, <code class="docutils literal"><span class="pre">tag</span></code> and <code class="docutils literal"><span class="pre">n_likes</span></code>
         
     | 
| 
       4284 
4292 
     | 
    
         
             
            column values:</p>
         
     | 
| 
       4285 
4293 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4286 
4294 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
         @@ -4402,27 +4410,27 @@ column values:</p> 
     | 
|
| 
       4402 
4410 
     | 
    
         
             
            # ]
         
     | 
| 
       4403 
4411 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4404 
4412 
     | 
    
         
             
            </div>
         
     | 
| 
       4405 
     | 
    
         
            -
            <p>< 
     | 
| 
       4406 
     | 
    
         
            -
            group. You can refer grouped keys by < 
     | 
| 
       4407 
     | 
    
         
            -
            <a class="reference internal" href="#select-drilldown-label-output-columns">< 
     | 
| 
       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></ 
     | 
| 
       4413 
     | 
    
         
            -
            <a class="reference internal" href="#select-drilldown-output-columns">< 
     | 
| 
      
 4413 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">tag.n_likes</span></code> is used as the label for the drilldown parameters
         
     | 
| 
      
 4414 
     | 
    
         
            +
            group. You can refer grouped keys by <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax in
         
     | 
| 
      
 4415 
     | 
    
         
            +
            <a class="reference internal" href="#select-drilldown-label-output-columns"><span>drilldown[${LABEL}].output_columns</span></a>. <code class="docutils literal"><span class="pre">${KEY_NAME}</span></code> is a
         
     | 
| 
      
 4416 
     | 
    
         
            +
            column name to be used by group key. <code class="docutils literal"><span class="pre">tag</span></code> and <code class="docutils literal"><span class="pre">n_likes</span></code> are
         
     | 
| 
      
 4417 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">${KEY_NAME}</span></code> in this case.</p>
         
     | 
| 
      
 4418 
     | 
    
         
            +
            <p>Note that you can't use <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax when you just
         
     | 
| 
      
 4419 
     | 
    
         
            +
            specify one key as <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> like <code class="docutils literal"><span class="pre">--drilldown[tag].keys</span>
         
     | 
| 
      
 4420 
     | 
    
         
            +
            <span class="pre">tag</span></code>. You should use <code class="docutils literal"><span class="pre">_key</span></code> for the case. It's the same rule in
         
     | 
| 
      
 4421 
     | 
    
         
            +
            <a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a>.</p>
         
     | 
| 
       4414 
4422 
     | 
    
         
             
            </div>
         
     | 
| 
       4415 
4423 
     | 
    
         
             
            <div class="section" id="drilldown-label-output-columns">
         
     | 
| 
       4416 
     | 
    
         
            -
            <span id="select-drilldown-label-output-columns"></span><h4>7.3. 
     | 
| 
       4417 
     | 
    
         
            -
            <p>It's almost same as <a class="reference internal" href="#select-drilldown-output-columns">< 
     | 
| 
       4418 
     | 
    
         
            -
            difference between <a class="reference internal" href="#select-drilldown-output-columns">< 
     | 
| 
       4419 
     | 
    
         
            -
            < 
     | 
| 
       4420 
     | 
    
         
            -
            <p><a class="reference internal" href="#select-drilldown-output-columns">< 
     | 
| 
      
 4424 
     | 
    
         
            +
            <span id="select-drilldown-label-output-columns"></span><h4>7.3.41.4.6.2. <code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code><a class="headerlink" href="#drilldown-label-output-columns" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 4425 
     | 
    
         
            +
            <p>It's almost same as <a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a>. The
         
     | 
| 
      
 4426 
     | 
    
         
            +
            difference between <a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a> and
         
     | 
| 
      
 4427 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code> is how to refer group keys.</p>
         
     | 
| 
      
 4428 
     | 
    
         
            +
            <p><a class="reference internal" href="#select-drilldown-output-columns"><span>drilldown_output_columns</span></a> uses <code class="docutils literal"><span class="pre">_key</span></code>
         
     | 
| 
       4421 
4429 
     | 
    
         
             
            <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to refer group
         
     | 
| 
       4422 
     | 
    
         
            -
            key. < 
     | 
| 
      
 4430 
     | 
    
         
            +
            key. <code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code> also uses <code class="docutils literal"><span class="pre">_key</span></code>
         
     | 
| 
       4423 
4431 
     | 
    
         
             
            <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> to refer group key when you specify
         
     | 
| 
       4424 
     | 
    
         
            -
            only one group key by <a class="reference internal" href="#select-drilldown-label-keys">< 
     | 
| 
       4425 
     | 
    
         
            -
            <p>Here is an example to refer single group key by < 
     | 
| 
      
 4432 
     | 
    
         
            +
            only one group key by <a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a>.</p>
         
     | 
| 
      
 4433 
     | 
    
         
            +
            <p>Here is an example to refer single group key by <code class="docutils literal"><span class="pre">_key</span></code>
         
     | 
| 
       4426 
4434 
     | 
    
         
             
            <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a>:</p>
         
     | 
| 
       4427 
4435 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4428 
4436 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
         @@ -4501,13 +4509,13 @@ only one group key by <a class="reference internal" href="#select-drilldown-labe 
     | 
|
| 
       4501 
4509 
     | 
    
         
             
            # ]
         
     | 
| 
       4502 
4510 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4503 
4511 
     | 
    
         
             
            </div>
         
     | 
| 
       4504 
     | 
    
         
            -
            <p>But you can't refer each group key by < 
     | 
| 
      
 4512 
     | 
    
         
            +
            <p>But you can't refer each group key by <code class="docutils literal"><span class="pre">_key</span></code>
         
     | 
| 
       4505 
4513 
     | 
    
         
             
            <a class="reference internal" href="../columns/pseudo.html"><em>Pseudo column</em></a> in
         
     | 
| 
       4506 
     | 
    
         
            -
            < 
     | 
| 
       4507 
     | 
    
         
            -
            < 
     | 
| 
       4508 
     | 
    
         
            -
            used for group key in <a class="reference internal" href="#select-drilldown-label-keys">< 
     | 
| 
      
 4514 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code>. You need to use
         
     | 
| 
      
 4515 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax. <code class="docutils literal"><span class="pre">${KEY_NAME}</span></code> is a column name that is
         
     | 
| 
      
 4516 
     | 
    
         
            +
            used for group key in <a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a>.</p>
         
     | 
| 
       4509 
4517 
     | 
    
         
             
            <p>Here is an example to refer each group key in multiple group keys by
         
     | 
| 
       4510 
     | 
    
         
            -
            < 
     | 
| 
      
 4518 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax:</p>
         
     | 
| 
       4511 
4519 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4512 
4520 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       4513 
4521 
     | 
    
         
             
              --limit 0 \
         
     | 
| 
         @@ -4587,29 +4595,29 @@ used for group key in <a class="reference internal" href="#select-drilldown-labe 
     | 
|
| 
       4587 
4595 
     | 
    
         
             
            </div>
         
     | 
| 
       4588 
4596 
     | 
    
         
             
            <div class="admonition tip">
         
     | 
| 
       4589 
4597 
     | 
    
         
             
            <p class="first admonition-title">Tip</p>
         
     | 
| 
       4590 
     | 
    
         
            -
            <p>Why < 
     | 
| 
      
 4598 
     | 
    
         
            +
            <p>Why <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax?</p>
         
     | 
| 
       4591 
4599 
     | 
    
         
             
            <p>It's implementation specific information.</p>
         
     | 
| 
       4592 
     | 
    
         
            -
            <p>< 
     | 
| 
      
 4600 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">_key</span></code> is a vector value. The vector value is consists of all
         
     | 
| 
       4593 
4601 
     | 
    
         
             
            group keys. You can see byte sequence of the vector value by
         
     | 
| 
       4594 
     | 
    
         
            -
            referring < 
     | 
| 
       4595 
     | 
    
         
            -
            <p>There is one grouped record in < 
     | 
| 
      
 4602 
     | 
    
         
            +
            referring <code class="docutils literal"><span class="pre">_key</span></code> in <code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code>.</p>
         
     | 
| 
      
 4603 
     | 
    
         
            +
            <p>There is one grouped record in <code class="docutils literal"><span class="pre">_value</span></code> to refer each grouped
         
     | 
| 
       4596 
4604 
     | 
    
         
             
            values when you specify multiple group keys to
         
     | 
| 
       4597 
     | 
    
         
            -
            <a class="reference internal" href="#select-drilldown-label-keys">< 
     | 
| 
       4598 
     | 
    
         
            -
            by < 
     | 
| 
       4599 
     | 
    
         
            -
            <p class="last">On the other hand, there is no grouped record in < 
     | 
| 
      
 4605 
     | 
    
         
            +
            <a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a>. So you can refer each group key
         
     | 
| 
      
 4606 
     | 
    
         
            +
            by <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax.</p>
         
     | 
| 
      
 4607 
     | 
    
         
            +
            <p class="last">On the other hand, there is no grouped record in <code class="docutils literal"><span class="pre">_value</span></code> when
         
     | 
| 
       4600 
4608 
     | 
    
         
             
            you specify only one group key to
         
     | 
| 
       4601 
     | 
    
         
            -
            <a class="reference internal" href="#select-drilldown-label-keys">< 
     | 
| 
       4602 
     | 
    
         
            -
            < 
     | 
| 
      
 4609 
     | 
    
         
            +
            <a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a>. So you can't refer group key by
         
     | 
| 
      
 4610 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">_value.${KEY_NAME}</span></code> syntax.</p>
         
     | 
| 
       4603 
4611 
     | 
    
         
             
            </div>
         
     | 
| 
       4604 
4612 
     | 
    
         
             
            </div>
         
     | 
| 
       4605 
4613 
     | 
    
         
             
            <div class="section" id="output-format-for-drilldown-label-style">
         
     | 
| 
       4606 
     | 
    
         
            -
            <span id="select-drilldown-label-output-format"></span><h4>7.3. 
     | 
| 
       4607 
     | 
    
         
            -
            <p>There is a difference in output format between <a class="reference internal" href="#select-drilldown">< 
     | 
| 
       4608 
     | 
    
         
            -
            and <a class="reference internal" href="#select-drilldown-label-keys">< 
     | 
| 
      
 4614 
     | 
    
         
            +
            <span id="select-drilldown-label-output-format"></span><h4>7.3.41.4.6.3. Output format for <code class="docutils literal"><span class="pre">drilldown[${LABEL}]</span></code> style<a class="headerlink" href="#output-format-for-drilldown-label-style" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 4615 
     | 
    
         
            +
            <p>There is a difference in output format between <a class="reference internal" href="#select-drilldown"><span>drilldown</span></a>
         
     | 
| 
      
 4616 
     | 
    
         
            +
            and <a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a>. <a class="reference internal" href="#select-drilldown"><span>drilldown</span></a> uses
         
     | 
| 
       4609 
4617 
     | 
    
         
             
            array to output multiple drilldown results.
         
     | 
| 
       4610 
     | 
    
         
            -
            <a class="reference internal" href="#select-drilldown-label-keys">< 
     | 
| 
      
 4618 
     | 
    
         
            +
            <a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a> uses pairs of label and drilldown
         
     | 
| 
       4611 
4619 
     | 
    
         
             
            result.</p>
         
     | 
| 
       4612 
     | 
    
         
            -
            <p><a class="reference internal" href="#select-drilldown">< 
     | 
| 
      
 4620 
     | 
    
         
            +
            <p><a class="reference internal" href="#select-drilldown"><span>drilldown</span></a> uses the following output format:</p>
         
     | 
| 
       4613 
4621 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>[
         
     | 
| 
       4614 
4622 
     | 
    
         
             
              HEADER,
         
     | 
| 
       4615 
4623 
     | 
    
         
             
              [
         
     | 
| 
         @@ -4621,7 +4629,7 @@ result.</p> 
     | 
|
| 
       4621 
4629 
     | 
    
         
             
            ]
         
     | 
| 
       4622 
4630 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4623 
4631 
     | 
    
         
             
            </div>
         
     | 
| 
       4624 
     | 
    
         
            -
            <p><a class="reference internal" href="#select-drilldown-label-keys">< 
     | 
| 
      
 4632 
     | 
    
         
            +
            <p><a class="reference internal" href="#select-drilldown-label-keys"><span>drilldown[${LABEL}].keys</span></a> uses the following output format:</p>
         
     | 
| 
       4625 
4633 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>[
         
     | 
| 
       4626 
4634 
     | 
    
         
             
              HEADER,
         
     | 
| 
       4627 
4635 
     | 
    
         
             
              [
         
     | 
| 
         @@ -4638,46 +4646,143 @@ result.</p> 
     | 
|
| 
       4638 
4646 
     | 
    
         
             
            </div>
         
     | 
| 
       4639 
4647 
     | 
    
         
             
            </div>
         
     | 
| 
       4640 
4648 
     | 
    
         
             
            <div class="section" id="cache-related-parameter">
         
     | 
| 
       4641 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
      
 4649 
     | 
    
         
            +
            <h3>7.3.41.4.7. Cache related parameter<a class="headerlink" href="#cache-related-parameter" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
       4642 
4650 
     | 
    
         
             
            <div class="section" id="cache">
         
     | 
| 
       4643 
     | 
    
         
            -
            <h4>7.3. 
     | 
| 
       4644 
     | 
    
         
            -
            <p> 
     | 
| 
       4645 
     | 
    
         
            -
            <p 
     | 
| 
       4646 
     | 
    
         
            -
             
     | 
| 
       4647 
     | 
    
         
            -
            < 
     | 
| 
       4648 
     | 
    
         
            -
            < 
     | 
| 
      
 4651 
     | 
    
         
            +
            <span id="select-cache"></span><h4>7.3.41.4.7.1. <code class="docutils literal"><span class="pre">cache</span></code><a class="headerlink" href="#cache" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
      
 4652 
     | 
    
         
            +
            <p>Specifies whether caching the result of this query or not.</p>
         
     | 
| 
      
 4653 
     | 
    
         
            +
            <p>If the result of this query is cached, the next same query returns
         
     | 
| 
      
 4654 
     | 
    
         
            +
            response quickly by using the cache.</p>
         
     | 
| 
      
 4655 
     | 
    
         
            +
            <p>It doesn't control whether existing cached result is used or not.</p>
         
     | 
| 
      
 4656 
     | 
    
         
            +
            <p>Here are available values:</p>
         
     | 
| 
      
 4657 
     | 
    
         
            +
            <table border="1" class="docutils">
         
     | 
| 
      
 4658 
     | 
    
         
            +
            <colgroup>
         
     | 
| 
      
 4659 
     | 
    
         
            +
            <col width="50%" />
         
     | 
| 
      
 4660 
     | 
    
         
            +
            <col width="50%" />
         
     | 
| 
      
 4661 
     | 
    
         
            +
            </colgroup>
         
     | 
| 
      
 4662 
     | 
    
         
            +
            <thead valign="bottom">
         
     | 
| 
      
 4663 
     | 
    
         
            +
            <tr class="row-odd"><th class="head">Value</th>
         
     | 
| 
      
 4664 
     | 
    
         
            +
            <th class="head">Description</th>
         
     | 
| 
      
 4665 
     | 
    
         
            +
            </tr>
         
     | 
| 
      
 4666 
     | 
    
         
            +
            </thead>
         
     | 
| 
      
 4667 
     | 
    
         
            +
            <tbody valign="top">
         
     | 
| 
      
 4668 
     | 
    
         
            +
            <tr class="row-even"><td><code class="docutils literal"><span class="pre">no</span></code></td>
         
     | 
| 
      
 4669 
     | 
    
         
            +
            <td>Don't cache the output of this query.</td>
         
     | 
| 
      
 4670 
     | 
    
         
            +
            </tr>
         
     | 
| 
      
 4671 
     | 
    
         
            +
            <tr class="row-odd"><td><code class="docutils literal"><span class="pre">yes</span></code></td>
         
     | 
| 
      
 4672 
     | 
    
         
            +
            <td>Cache the output of this query.
         
     | 
| 
      
 4673 
     | 
    
         
            +
            It's the default value.</td>
         
     | 
| 
      
 4674 
     | 
    
         
            +
            </tr>
         
     | 
| 
      
 4675 
     | 
    
         
            +
            </tbody>
         
     | 
| 
      
 4676 
     | 
    
         
            +
            </table>
         
     | 
| 
      
 4677 
     | 
    
         
            +
            <p>Here is an example to disable caching the result of this query:</p>
         
     | 
| 
      
 4678 
     | 
    
         
            +
            <p>Execution example:</p>
         
     | 
| 
      
 4679 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>select Entries --cache no
         
     | 
| 
      
 4680 
     | 
    
         
            +
            # [
         
     | 
| 
      
 4681 
     | 
    
         
            +
            #   [
         
     | 
| 
      
 4682 
     | 
    
         
            +
            #     0,
         
     | 
| 
      
 4683 
     | 
    
         
            +
            #     1337566253.89858,
         
     | 
| 
      
 4684 
     | 
    
         
            +
            #     0.000355720520019531
         
     | 
| 
      
 4685 
     | 
    
         
            +
            #   ],
         
     | 
| 
      
 4686 
     | 
    
         
            +
            #   [
         
     | 
| 
      
 4687 
     | 
    
         
            +
            #     [
         
     | 
| 
      
 4688 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4689 
     | 
    
         
            +
            #         5
         
     | 
| 
      
 4690 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 4691 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4692 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4693 
     | 
    
         
            +
            #           "_id",
         
     | 
| 
      
 4694 
     | 
    
         
            +
            #           "UInt32"
         
     | 
| 
      
 4695 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 4696 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4697 
     | 
    
         
            +
            #           "_key",
         
     | 
| 
      
 4698 
     | 
    
         
            +
            #           "ShortText"
         
     | 
| 
      
 4699 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 4700 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4701 
     | 
    
         
            +
            #           "content",
         
     | 
| 
      
 4702 
     | 
    
         
            +
            #           "Text"
         
     | 
| 
      
 4703 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 4704 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4705 
     | 
    
         
            +
            #           "n_likes",
         
     | 
| 
      
 4706 
     | 
    
         
            +
            #           "UInt32"
         
     | 
| 
      
 4707 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 4708 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4709 
     | 
    
         
            +
            #           "tag",
         
     | 
| 
      
 4710 
     | 
    
         
            +
            #           "ShortText"
         
     | 
| 
      
 4711 
     | 
    
         
            +
            #         ]
         
     | 
| 
      
 4712 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 4713 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4714 
     | 
    
         
            +
            #         1,
         
     | 
| 
      
 4715 
     | 
    
         
            +
            #         "The first post!",
         
     | 
| 
      
 4716 
     | 
    
         
            +
            #         "Welcome! This is my first post!",
         
     | 
| 
      
 4717 
     | 
    
         
            +
            #         5,
         
     | 
| 
      
 4718 
     | 
    
         
            +
            #         "Hello"
         
     | 
| 
      
 4719 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 4720 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4721 
     | 
    
         
            +
            #         2,
         
     | 
| 
      
 4722 
     | 
    
         
            +
            #         "Groonga",
         
     | 
| 
      
 4723 
     | 
    
         
            +
            #         "I started to use Groonga. It's very fast!",
         
     | 
| 
      
 4724 
     | 
    
         
            +
            #         10,
         
     | 
| 
      
 4725 
     | 
    
         
            +
            #         "Groonga"
         
     | 
| 
      
 4726 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 4727 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4728 
     | 
    
         
            +
            #         3,
         
     | 
| 
      
 4729 
     | 
    
         
            +
            #         "Mroonga",
         
     | 
| 
      
 4730 
     | 
    
         
            +
            #         "I also started to use Mroonga. It's also very fast! Really fast!",
         
     | 
| 
      
 4731 
     | 
    
         
            +
            #         15,
         
     | 
| 
      
 4732 
     | 
    
         
            +
            #         "Groonga"
         
     | 
| 
      
 4733 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 4734 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4735 
     | 
    
         
            +
            #         4,
         
     | 
| 
      
 4736 
     | 
    
         
            +
            #         "Good-bye Senna",
         
     | 
| 
      
 4737 
     | 
    
         
            +
            #         "I migrated all Senna system!",
         
     | 
| 
      
 4738 
     | 
    
         
            +
            #         3,
         
     | 
| 
      
 4739 
     | 
    
         
            +
            #         "Senna"
         
     | 
| 
      
 4740 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 4741 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4742 
     | 
    
         
            +
            #         5,
         
     | 
| 
      
 4743 
     | 
    
         
            +
            #         "Good-bye Tritonn",
         
     | 
| 
      
 4744 
     | 
    
         
            +
            #         "I also migrated all Tritonn system!",
         
     | 
| 
      
 4745 
     | 
    
         
            +
            #         3,
         
     | 
| 
      
 4746 
     | 
    
         
            +
            #         "Senna"
         
     | 
| 
      
 4747 
     | 
    
         
            +
            #       ]
         
     | 
| 
      
 4748 
     | 
    
         
            +
            #     ]
         
     | 
| 
      
 4749 
     | 
    
         
            +
            #   ]
         
     | 
| 
      
 4750 
     | 
    
         
            +
            # ]
         
     | 
| 
      
 4751 
     | 
    
         
            +
            </pre></div>
         
     | 
| 
      
 4752 
     | 
    
         
            +
            </div>
         
     | 
| 
      
 4753 
     | 
    
         
            +
            <p>The default value is <code class="docutils literal"><span class="pre">yes</span></code>.</p>
         
     | 
| 
       4649 
4754 
     | 
    
         
             
            </div>
         
     | 
| 
       4650 
4755 
     | 
    
         
             
            </div>
         
     | 
| 
       4651 
4756 
     | 
    
         
             
            <div class="section" id="score-related-parameters">
         
     | 
| 
       4652 
     | 
    
         
            -
            <h3>7.3. 
     | 
| 
       4653 
     | 
    
         
            -
            <p>There is a score related parameter, < 
     | 
| 
      
 4757 
     | 
    
         
            +
            <h3>7.3.41.4.8. Score related parameters<a class="headerlink" href="#score-related-parameters" title="Permalink to this headline">¶</a></h3>
         
     | 
| 
      
 4758 
     | 
    
         
            +
            <p>There is a score related parameter, <code class="docutils literal"><span class="pre">adjuster</span></code>.</p>
         
     | 
| 
       4654 
4759 
     | 
    
         
             
            <div class="section" id="adjuster">
         
     | 
| 
       4655 
     | 
    
         
            -
            <span id="select-adjuster"></span><h4>7.3. 
     | 
| 
      
 4760 
     | 
    
         
            +
            <span id="select-adjuster"></span><h4>7.3.41.4.8.1. <code class="docutils literal"><span class="pre">adjuster</span></code><a class="headerlink" href="#adjuster" title="Permalink to this headline">¶</a></h4>
         
     | 
| 
       4656 
4761 
     | 
    
         
             
            <p>Specifies one or more score adjust expressions. You need to use
         
     | 
| 
       4657 
     | 
    
         
            -
            < 
     | 
| 
      
 4762 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">adjuster</span></code> with <code class="docutils literal"><span class="pre">query</span></code> or <code class="docutils literal"><span class="pre">filter</span></code>. <code class="docutils literal"><span class="pre">adjuster</span></code> doesn't work
         
     | 
| 
       4658 
4763 
     | 
    
         
             
            with not searched request.</p>
         
     | 
| 
       4659 
     | 
    
         
            -
            <p>You can increase score of specific records by < 
     | 
| 
       4660 
     | 
    
         
            -
            use < 
     | 
| 
       4661 
     | 
    
         
            -
            <p>For example, you can use < 
     | 
| 
       4662 
     | 
    
         
            -
            that have < 
     | 
| 
      
 4764 
     | 
    
         
            +
            <p>You can increase score of specific records by <code class="docutils literal"><span class="pre">adjuster</span></code>. You can
         
     | 
| 
      
 4765 
     | 
    
         
            +
            use <code class="docutils literal"><span class="pre">adjuster</span></code> to set high score for important records.</p>
         
     | 
| 
      
 4766 
     | 
    
         
            +
            <p>For example, you can use <code class="docutils literal"><span class="pre">adjuster</span></code> to increase score of records
         
     | 
| 
      
 4767 
     | 
    
         
            +
            that have <code class="docutils literal"><span class="pre">groonga</span></code> tag.</p>
         
     | 
| 
       4663 
4768 
     | 
    
         
             
            <p>Here is the syntax:</p>
         
     | 
| 
       4664 
4769 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>--adjuster "SCORE_ADJUST_EXPRESSION1 + SCORE_ADJUST_EXPRESSION2 + ..."
         
     | 
| 
       4665 
4770 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4666 
4771 
     | 
    
         
             
            </div>
         
     | 
| 
       4667 
     | 
    
         
            -
            <p>Here is the < 
     | 
| 
      
 4772 
     | 
    
         
            +
            <p>Here is the <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> syntax:</p>
         
     | 
| 
       4668 
4773 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>COLUMN @ "KEYWORD" * FACTOR
         
     | 
| 
       4669 
4774 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4670 
4775 
     | 
    
         
             
            </div>
         
     | 
| 
       4671 
4776 
     | 
    
         
             
            <p>Note the following:</p>
         
     | 
| 
       4672 
4777 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4673 
4778 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4674 
     | 
    
         
            -
            <li>< 
     | 
| 
       4675 
     | 
    
         
            -
            <li>< 
     | 
| 
       4676 
     | 
    
         
            -
            <li>< 
     | 
| 
      
 4779 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">COLUMN</span></code> must be indexed.</li>
         
     | 
| 
      
 4780 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">"KEYWORD"</span></code> must be a string.</li>
         
     | 
| 
      
 4781 
     | 
    
         
            +
            <li><code class="docutils literal"><span class="pre">FACTOR</span></code> must be a positive integer.</li>
         
     | 
| 
       4677 
4782 
     | 
    
         
             
            </ul>
         
     | 
| 
       4678 
4783 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
       4679 
     | 
    
         
            -
            <p>Here is a sample < 
     | 
| 
       4680 
     | 
    
         
            -
            < 
     | 
| 
      
 4784 
     | 
    
         
            +
            <p>Here is a sample <code class="docutils literal"><span class="pre">adjuster</span></code> usage example that uses just one
         
     | 
| 
      
 4785 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code>:</p>
         
     | 
| 
       4681 
4786 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4682 
4787 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       4683 
4788 
     | 
    
         
             
              --filter true \
         
     | 
| 
         @@ -4738,13 +4843,13 @@ that have <tt class="docutils literal"><span class="pre">groonga</span></tt> tag 
     | 
|
| 
       4738 
4843 
     | 
    
         
             
            # ]
         
     | 
| 
       4739 
4844 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4740 
4845 
     | 
    
         
             
            </div>
         
     | 
| 
       4741 
     | 
    
         
            -
            <p>The < 
     | 
| 
       4742 
     | 
    
         
            -
            < 
     | 
| 
       4743 
     | 
    
         
            -
            < 
     | 
| 
       4744 
     | 
    
         
            -
            record that has < 
     | 
| 
       4745 
     | 
    
         
            -
            record that its key is < 
     | 
| 
       4746 
     | 
    
         
            -
            <p>You can omit < 
     | 
| 
       4747 
     | 
    
         
            -
            <p>Here is a sample < 
     | 
| 
      
 4846 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">select</span></code> command matches all records. Then it applies
         
     | 
| 
      
 4847 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">adjuster</span></code>. The adjuster increases score of records that have
         
     | 
| 
      
 4848 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">"groonga"</span></code> in <code class="docutils literal"><span class="pre">Entries.content</span></code> column by 5. There is only one
         
     | 
| 
      
 4849 
     | 
    
         
            +
            record that has <code class="docutils literal"><span class="pre">"groonga"</span></code> in <code class="docutils literal"><span class="pre">Entries.content</span></code> column.  So the
         
     | 
| 
      
 4850 
     | 
    
         
            +
            record that its key is <code class="docutils literal"><span class="pre">"Groonga"</span></code> has score 6 (<code class="docutils literal"><span class="pre">=</span> <span class="pre">1</span> <span class="pre">+</span> <span class="pre">5</span></code>).</p>
         
     | 
| 
      
 4851 
     | 
    
         
            +
            <p>You can omit <code class="docutils literal"><span class="pre">FACTOR</span></code>. If you omit <code class="docutils literal"><span class="pre">FACTOR</span></code>, it is treated as 1.</p>
         
     | 
| 
      
 4852 
     | 
    
         
            +
            <p>Here is a sample <code class="docutils literal"><span class="pre">adjuster</span></code> usage example that omits <code class="docutils literal"><span class="pre">FACTOR</span></code>:</p>
         
     | 
| 
       4748 
4853 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4749 
4854 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       4750 
4855 
     | 
    
         
             
              --filter true \
         
     | 
| 
         @@ -4805,12 +4910,12 @@ record that its key is <tt class="docutils literal"><span class="pre">"Groo 
     | 
|
| 
       4805 
4910 
     | 
    
         
             
            # ]
         
     | 
| 
       4806 
4911 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4807 
4912 
     | 
    
         
             
            </div>
         
     | 
| 
       4808 
     | 
    
         
            -
            <p>The < 
     | 
| 
      
 4913 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">adjuster</span></code> in the <code class="docutils literal"><span class="pre">select</span></code> command doesn't have <code class="docutils literal"><span class="pre">FACTOR</span></code>. So
         
     | 
| 
       4809 
4914 
     | 
    
         
             
            the factor is treated as 1. There is only one record that has
         
     | 
| 
       4810 
     | 
    
         
            -
            < 
     | 
| 
       4811 
     | 
    
         
            -
            key is < 
     | 
| 
       4812 
     | 
    
         
            -
            <p>Here is a sample < 
     | 
| 
       4813 
     | 
    
         
            -
            < 
     | 
| 
      
 4915 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">"groonga"</span></code> in <code class="docutils literal"><span class="pre">Entries.content</span></code> column. So the record that its
         
     | 
| 
      
 4916 
     | 
    
         
            +
            key is <code class="docutils literal"><span class="pre">"Groonga"</span></code> has score 2 (<code class="docutils literal"><span class="pre">=</span> <span class="pre">1</span> <span class="pre">+</span> <span class="pre">1</span></code>).</p>
         
     | 
| 
      
 4917 
     | 
    
         
            +
            <p>Here is a sample <code class="docutils literal"><span class="pre">adjuster</span></code> usage example that uses multiple
         
     | 
| 
      
 4918 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code>:</p>
         
     | 
| 
       4814 
4919 
     | 
    
         
             
            <p>Execution example:</p>
         
     | 
| 
       4815 
4920 
     | 
    
         
             
            <div class="highlight-none"><div class="highlight"><pre>select Entries \
         
     | 
| 
       4816 
4921 
     | 
    
         
             
              --filter true \
         
     | 
| 
         @@ -4871,83 +4976,227 @@ key is <tt class="docutils literal"><span class="pre">"Groonga"</span> 
     | 
|
| 
       4871 
4976 
     | 
    
         
             
            # ]
         
     | 
| 
       4872 
4977 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4873 
4978 
     | 
    
         
             
            </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 < 
     | 
| 
      
 4979 
     | 
    
         
            +
            <p>The <code class="docutils literal"><span class="pre">adjuster</span></code> in the <code class="docutils literal"><span class="pre">select</span></code> command has two
         
     | 
| 
      
 4980 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> s. The final increased score is sum of
         
     | 
| 
      
 4981 
     | 
    
         
            +
            scores of these <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> s. All
         
     | 
| 
      
 4982 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> s in the <code class="docutils literal"><span class="pre">select</span></code> command are applied to
         
     | 
| 
      
 4983 
     | 
    
         
            +
            a record that its key is <code class="docutils literal"><span class="pre">"Groonga"</span></code>. So the final increased score
         
     | 
| 
      
 4984 
     | 
    
         
            +
            of the record is sum of scores of all <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> s.</p>
         
     | 
| 
      
 4985 
     | 
    
         
            +
            <p>The first <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> is <code class="docutils literal"><span class="pre">content</span> <span class="pre">@</span> <span class="pre">"groonga"</span> <span class="pre">*</span> <span class="pre">5</span></code>.
         
     | 
| 
       4881 
4986 
     | 
    
         
             
            It increases score by 5.</p>
         
     | 
| 
       4882 
     | 
    
         
            -
            <p>The second < 
     | 
| 
      
 4987 
     | 
    
         
            +
            <p>The second <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> is <code class="docutils literal"><span class="pre">content</span> <span class="pre">@</span> <span class="pre">"started"</span> <span class="pre">*</span> <span class="pre">3</span></code>.
         
     | 
| 
       4883 
4988 
     | 
    
         
             
            It increases score by 3.</p>
         
     | 
| 
       4884 
     | 
    
         
            -
            <p>The final increased score is 9 (< 
     | 
| 
       4885 
     | 
    
         
            -
            <p>A < 
     | 
| 
       4886 
     | 
    
         
            -
            means that increased scores of all records that has < 
     | 
| 
      
 4989 
     | 
    
         
            +
            <p>The final increased score is 9 (<code class="docutils literal"><span class="pre">=</span> <span class="pre">1</span> <span class="pre">+</span> <span class="pre">5</span> <span class="pre">+</span> <span class="pre">3</span></code>).</p>
         
     | 
| 
      
 4990 
     | 
    
         
            +
            <p>A <code class="docutils literal"><span class="pre">SCORE_ADJUST_EXPRESSION</span></code> has a factor for <code class="docutils literal"><span class="pre">"KEYWORD"</span></code>. This
         
     | 
| 
      
 4991 
     | 
    
         
            +
            means that increased scores of all records that has <code class="docutils literal"><span class="pre">"KEYWORD"</span></code> are
         
     | 
| 
       4887 
4992 
     | 
    
         
             
            the same value. You can change increase score for each record that has
         
     | 
| 
       4888 
     | 
    
         
            -
            the same < 
     | 
| 
       4889 
     | 
    
         
            -
            <a class="reference internal" href="../columns/vector.html#weight-vector-column">< 
     | 
| 
      
 4993 
     | 
    
         
            +
            the same <code class="docutils literal"><span class="pre">"KEYWORD"</span></code>. It is useful to tune search score. See
         
     | 
| 
      
 4994 
     | 
    
         
            +
            <a class="reference internal" href="../columns/vector.html#weight-vector-column"><span>Weight vector column</span></a> for details.</p>
         
     | 
| 
       4890 
4995 
     | 
    
         
             
            </div>
         
     | 
| 
       4891 
4996 
     | 
    
         
             
            </div>
         
     | 
| 
       4892 
4997 
     | 
    
         
             
            </div>
         
     | 
| 
       4893 
     | 
    
         
            -
            <div class="section" id=" 
     | 
| 
       4894 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
       4895 
     | 
    
         
            -
            <p> 
     | 
| 
       4896 
     | 
    
         
            -
            < 
     | 
| 
       4897 
     | 
    
         
            -
             
     | 
| 
      
 4998 
     | 
    
         
            +
            <div class="section" id="return-value">
         
     | 
| 
      
 4999 
     | 
    
         
            +
            <span id="select-return-value"></span><h2>7.3.41.5. Return value<a class="headerlink" href="#return-value" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
      
 5000 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">select</span></code> returns response with the following format:</p>
         
     | 
| 
      
 5001 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>[
         
     | 
| 
      
 5002 
     | 
    
         
            +
              HEADER,
         
     | 
| 
      
 5003 
     | 
    
         
            +
              [
         
     | 
| 
      
 5004 
     | 
    
         
            +
                SEARCH_RESULT,
         
     | 
| 
      
 5005 
     | 
    
         
            +
                DRILLDOWN_RESULT_1,
         
     | 
| 
      
 5006 
     | 
    
         
            +
                DRILLDOWN_RESULT_2,
         
     | 
| 
      
 5007 
     | 
    
         
            +
                ...,
         
     | 
| 
      
 5008 
     | 
    
         
            +
                DRILLDOWN_RESULT_N
         
     | 
| 
      
 5009 
     | 
    
         
            +
              ]
         
     | 
| 
      
 5010 
     | 
    
         
            +
            ]
         
     | 
| 
       4898 
5011 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4899 
5012 
     | 
    
         
             
            </div>
         
     | 
| 
       4900 
     | 
    
         
            -
            <p>< 
     | 
| 
       4901 
     | 
    
         
            -
            < 
     | 
| 
       4902 
     | 
    
         
            -
            < 
     | 
| 
       4903 
     | 
    
         
            -
             
     | 
| 
       4904 
     | 
    
         
            -
             
     | 
| 
       4905 
     | 
    
         
            -
            < 
     | 
| 
       4906 
     | 
    
         
            -
             
     | 
| 
       4907 
     | 
    
         
            -
             
     | 
| 
       4908 
     | 
    
         
            -
             
     | 
| 
       4909 
     | 
    
         
            -
             
     | 
| 
       4910 
     | 
    
         
            -
             
     | 
| 
       4911 
     | 
    
         
            -
            <blockquote>
         
     | 
| 
       4912 
     | 
    
         
            -
            <div><p>drilldown条件が実行される前の検索結果が以下のように出力されます。:</p>
         
     | 
| 
       4913 
     | 
    
         
            -
            <div class="highlight-none"><div class="highlight"><pre>[[ヒット数], [[カラム名1,カラム型1],..], 検索結果1,..]
         
     | 
| 
      
 5013 
     | 
    
         
            +
            <p>If <code class="docutils literal"><span class="pre">select</span></code> fails, error details are in <code class="docutils literal"><span class="pre">HEADER</span></code>.</p>
         
     | 
| 
      
 5014 
     | 
    
         
            +
            <p>See <a class="reference internal" href="../command/output_format.html"><em>Output format</em></a> for <code class="docutils literal"><span class="pre">HEADER</span></code>.</p>
         
     | 
| 
      
 5015 
     | 
    
         
            +
            <p>There are zero or more <code class="docutils literal"><span class="pre">DRILLDOWN_RESULT</span></code>. If no <code class="docutils literal"><span class="pre">drilldown</span></code> and
         
     | 
| 
      
 5016 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> are specified, they are omitted like the
         
     | 
| 
      
 5017 
     | 
    
         
            +
            following:</p>
         
     | 
| 
      
 5018 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>[
         
     | 
| 
      
 5019 
     | 
    
         
            +
              HEADER,
         
     | 
| 
      
 5020 
     | 
    
         
            +
              [
         
     | 
| 
      
 5021 
     | 
    
         
            +
                SEARCH_RESULT
         
     | 
| 
      
 5022 
     | 
    
         
            +
              ]
         
     | 
| 
      
 5023 
     | 
    
         
            +
            ]
         
     | 
| 
       4914 
5024 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4915 
5025 
     | 
    
         
             
            </div>
         
     | 
| 
       4916 
     | 
    
         
            -
            <p 
     | 
| 
       4917 
     | 
    
         
            -
            < 
     | 
| 
       4918 
     | 
    
         
            -
            <div 
     | 
| 
       4919 
     | 
    
         
            -
             
     | 
| 
       4920 
     | 
    
         
            -
             
     | 
| 
       4921 
     | 
    
         
            -
             
     | 
| 
       4922 
     | 
    
         
            -
             
     | 
| 
       4923 
     | 
    
         
            -
             
     | 
| 
       4924 
     | 
    
         
            -
             
     | 
| 
       4925 
     | 
    
         
            -
             
     | 
| 
       4926 
     | 
    
         
            -
             
     | 
| 
       4927 
     | 
    
         
            -
            <div>output_columns, offset, limitによって指定された条件に従って各レコードの値が出力されます。</div></blockquote>
         
     | 
| 
       4928 
     | 
    
         
            -
            </div></blockquote>
         
     | 
| 
       4929 
     | 
    
         
            -
            <p><tt class="docutils literal"><span class="pre">drilldown結果</span></tt></p>
         
     | 
| 
       4930 
     | 
    
         
            -
            <blockquote>
         
     | 
| 
       4931 
     | 
    
         
            -
            <div><p>drilldown処理の結果が以下のように出力されます。:</p>
         
     | 
| 
       4932 
     | 
    
         
            -
            <div class="highlight-none"><div class="highlight"><pre>[[[件数], [[カラム名1,カラム型1],..], 検索結果1,..],..]
         
     | 
| 
      
 5026 
     | 
    
         
            +
            <p>If <code class="docutils literal"><span class="pre">drilldown</span></code> has two or more keys like <code class="docutils literal"><span class="pre">--drilldown</span> <span class="pre">"_key,</span>
         
     | 
| 
      
 5027 
     | 
    
         
            +
            <span class="pre">column1,</span> <span class="pre">column2"</span></code>, multiple <code class="docutils literal"><span class="pre">DRILLDOWN_RESULT</span></code> exist:</p>
         
     | 
| 
      
 5028 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>[
         
     | 
| 
      
 5029 
     | 
    
         
            +
              HEADER,
         
     | 
| 
      
 5030 
     | 
    
         
            +
              [
         
     | 
| 
      
 5031 
     | 
    
         
            +
                SEARCH_RESULT,
         
     | 
| 
      
 5032 
     | 
    
         
            +
                DRILLDOWN_RESULT_FOR_KEY,
         
     | 
| 
      
 5033 
     | 
    
         
            +
                DRILLDOWN_RESULT_FOR_COLUMN1,
         
     | 
| 
      
 5034 
     | 
    
         
            +
                DRILLDOWN_RESULT_FOR_COLUMN2
         
     | 
| 
      
 5035 
     | 
    
         
            +
              ]
         
     | 
| 
      
 5036 
     | 
    
         
            +
            ]
         
     | 
| 
       4933 
5037 
     | 
    
         
             
            </pre></div>
         
     | 
| 
       4934 
5038 
     | 
    
         
             
            </div>
         
     | 
| 
       4935 
     | 
    
         
            -
            <p>< 
     | 
| 
       4936 
     | 
    
         
            -
             
     | 
| 
       4937 
     | 
    
         
            -
            <div 
     | 
| 
       4938 
     | 
    
         
            -
             
     | 
| 
       4939 
     | 
    
         
            -
             
     | 
| 
       4940 
     | 
    
         
            -
             
     | 
| 
       4941 
     | 
    
         
            -
             
     | 
| 
       4942 
     | 
    
         
            -
             
     | 
| 
       4943 
     | 
    
         
            -
             
     | 
| 
       4944 
     | 
    
         
            -
             
     | 
| 
      
 5039 
     | 
    
         
            +
            <p>If <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> is used, only one <code class="docutils literal"><span class="pre">DRILLDOWN_RESULT</span></code>
         
     | 
| 
      
 5040 
     | 
    
         
            +
            exist:</p>
         
     | 
| 
      
 5041 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>[
         
     | 
| 
      
 5042 
     | 
    
         
            +
              HEADER,
         
     | 
| 
      
 5043 
     | 
    
         
            +
              [
         
     | 
| 
      
 5044 
     | 
    
         
            +
                SEARCH_RESULT,
         
     | 
| 
      
 5045 
     | 
    
         
            +
                DRILLDOWN_RESULT_FOR_LABELED_DRILLDOWN
         
     | 
| 
      
 5046 
     | 
    
         
            +
              ]
         
     | 
| 
      
 5047 
     | 
    
         
            +
            ]
         
     | 
| 
      
 5048 
     | 
    
         
            +
            </pre></div>
         
     | 
| 
      
 5049 
     | 
    
         
            +
            </div>
         
     | 
| 
      
 5050 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">DRILLDOWN_RESULT</span></code> format is different between <code class="docutils literal"><span class="pre">drilldown</span></code> and
         
     | 
| 
      
 5051 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code>. It's described later.</p>
         
     | 
| 
      
 5052 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">SEARCH_RESULT</span></code> is the following format:</p>
         
     | 
| 
      
 5053 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>[
         
     | 
| 
      
 5054 
     | 
    
         
            +
              [N_HITS],
         
     | 
| 
      
 5055 
     | 
    
         
            +
              COLUMNS,
         
     | 
| 
      
 5056 
     | 
    
         
            +
              RECORDS
         
     | 
| 
      
 5057 
     | 
    
         
            +
            ]
         
     | 
| 
      
 5058 
     | 
    
         
            +
            </pre></div>
         
     | 
| 
      
 5059 
     | 
    
         
            +
            </div>
         
     | 
| 
      
 5060 
     | 
    
         
            +
            <p>See <a class="reference internal" href="#select-simple-usage"><span>Simple usage</span></a> for concrete example of the format.</p>
         
     | 
| 
      
 5061 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">N_HITS</span></code> is the number of matched records before <a class="reference internal" href="#select-limit"><span>limit</span></a>
         
     | 
| 
      
 5062 
     | 
    
         
            +
            is applied.</p>
         
     | 
| 
      
 5063 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">COLUMNS</span></code> describes about output columns specified by
         
     | 
| 
      
 5064 
     | 
    
         
            +
            <a class="reference internal" href="#select-output-columns"><span>output_columns</span></a>. It uses the following format:</p>
         
     | 
| 
      
 5065 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>[
         
     | 
| 
      
 5066 
     | 
    
         
            +
              [COLUMN_NAME_1, COLUMN_TYPE_1],
         
     | 
| 
      
 5067 
     | 
    
         
            +
              [COLUMN_NAME_2, COLUMN_TYPE_2],
         
     | 
| 
      
 5068 
     | 
    
         
            +
              ...,
         
     | 
| 
      
 5069 
     | 
    
         
            +
              [COLUMN_NAME_N, COLUMN_TYPE_N]
         
     | 
| 
      
 5070 
     | 
    
         
            +
            ]
         
     | 
| 
      
 5071 
     | 
    
         
            +
            </pre></div>
         
     | 
| 
      
 5072 
     | 
    
         
            +
            </div>
         
     | 
| 
      
 5073 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">COLUMNS</span></code> includes one or more output column information. Each
         
     | 
| 
      
 5074 
     | 
    
         
            +
            output column information includes the followings:</p>
         
     | 
| 
       4945 
5075 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4946 
     | 
    
         
            -
            <div 
     | 
| 
      
 5076 
     | 
    
         
            +
            <div><ul class="simple">
         
     | 
| 
      
 5077 
     | 
    
         
            +
            <li>Column name as string</li>
         
     | 
| 
      
 5078 
     | 
    
         
            +
            <li>Column type as string or <code class="docutils literal"><span class="pre">null</span></code></li>
         
     | 
| 
      
 5079 
     | 
    
         
            +
            </ul>
         
     | 
| 
       4947 
5080 
     | 
    
         
             
            </div></blockquote>
         
     | 
| 
      
 5081 
     | 
    
         
            +
            <p>Column name is extracted from value specified as
         
     | 
| 
      
 5082 
     | 
    
         
            +
            <a class="reference internal" href="#select-output-columns"><span>output_columns</span></a>.</p>
         
     | 
| 
      
 5083 
     | 
    
         
            +
            <p>Column type is Groonga's type name or <code class="docutils literal"><span class="pre">null</span></code>. It doesn't describe
         
     | 
| 
      
 5084 
     | 
    
         
            +
            whether the column value is vector or scalar. You need to determine it
         
     | 
| 
      
 5085 
     | 
    
         
            +
            by whether real column value is array or not.</p>
         
     | 
| 
      
 5086 
     | 
    
         
            +
            <p>See <a class="reference internal" href="../types.html"><em>Data types</em></a> for type details.</p>
         
     | 
| 
      
 5087 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">null</span></code> is used when column value type isn't determined. For example,
         
     | 
| 
      
 5088 
     | 
    
         
            +
            function call in <a class="reference internal" href="#select-output-columns"><span>output_columns</span></a> such as
         
     | 
| 
      
 5089 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">--output_columns</span> <span class="pre">"snippet_html(content)"</span></code> uses <code class="docutils literal"><span class="pre">null</span></code>.</p>
         
     | 
| 
      
 5090 
     | 
    
         
            +
            <p>Here is an example of <code class="docutils literal"><span class="pre">COLUMNS</span></code>:</p>
         
     | 
| 
      
 5091 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>[
         
     | 
| 
      
 5092 
     | 
    
         
            +
              ["_id",     "UInt32"],
         
     | 
| 
      
 5093 
     | 
    
         
            +
              ["_key",    "ShortText"],
         
     | 
| 
      
 5094 
     | 
    
         
            +
              ["n_likes", "UInt32"],
         
     | 
| 
      
 5095 
     | 
    
         
            +
            ]
         
     | 
| 
      
 5096 
     | 
    
         
            +
            </pre></div>
         
     | 
| 
      
 5097 
     | 
    
         
            +
            </div>
         
     | 
| 
      
 5098 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">RECORDS</span></code> includes column values for each matched record. Included
         
     | 
| 
      
 5099 
     | 
    
         
            +
            records are selected by <a class="reference internal" href="#select-offset"><span>offset</span></a> and
         
     | 
| 
      
 5100 
     | 
    
         
            +
            <a class="reference internal" href="#select-limit"><span>limit</span></a>. It uses the following format:</p>
         
     | 
| 
      
 5101 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>[
         
     | 
| 
      
 5102 
     | 
    
         
            +
              [
         
     | 
| 
      
 5103 
     | 
    
         
            +
                RECORD_1_COLUMN_1,
         
     | 
| 
      
 5104 
     | 
    
         
            +
                RECORD_1_COLUMN_2,
         
     | 
| 
      
 5105 
     | 
    
         
            +
                ...,
         
     | 
| 
      
 5106 
     | 
    
         
            +
                RECORD_1_COLUMN_N
         
     | 
| 
      
 5107 
     | 
    
         
            +
              ],
         
     | 
| 
      
 5108 
     | 
    
         
            +
              [
         
     | 
| 
      
 5109 
     | 
    
         
            +
                RECORD_2_COLUMN_1,
         
     | 
| 
      
 5110 
     | 
    
         
            +
                RECORD_2_COLUMN_2,
         
     | 
| 
      
 5111 
     | 
    
         
            +
                ...,
         
     | 
| 
      
 5112 
     | 
    
         
            +
                RECORD_2_COLUMN_N
         
     | 
| 
      
 5113 
     | 
    
         
            +
              ],
         
     | 
| 
      
 5114 
     | 
    
         
            +
              ...
         
     | 
| 
      
 5115 
     | 
    
         
            +
              [
         
     | 
| 
      
 5116 
     | 
    
         
            +
                RECORD_N_COLUMN_1,
         
     | 
| 
      
 5117 
     | 
    
         
            +
                RECORD_N_COLUMN_2,
         
     | 
| 
      
 5118 
     | 
    
         
            +
                ...,
         
     | 
| 
      
 5119 
     | 
    
         
            +
                RECORD_N_COLUMN_N
         
     | 
| 
      
 5120 
     | 
    
         
            +
              ]
         
     | 
| 
      
 5121 
     | 
    
         
            +
            ]
         
     | 
| 
      
 5122 
     | 
    
         
            +
            </pre></div>
         
     | 
| 
      
 5123 
     | 
    
         
            +
            </div>
         
     | 
| 
      
 5124 
     | 
    
         
            +
            <p>Here is an example <code class="docutils literal"><span class="pre">RECORDS</span></code>:</p>
         
     | 
| 
      
 5125 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>[
         
     | 
| 
      
 5126 
     | 
    
         
            +
              [
         
     | 
| 
      
 5127 
     | 
    
         
            +
                1,
         
     | 
| 
      
 5128 
     | 
    
         
            +
                "The first post!",
         
     | 
| 
      
 5129 
     | 
    
         
            +
                5
         
     | 
| 
      
 5130 
     | 
    
         
            +
              ],
         
     | 
| 
      
 5131 
     | 
    
         
            +
              [
         
     | 
| 
      
 5132 
     | 
    
         
            +
                2,
         
     | 
| 
      
 5133 
     | 
    
         
            +
                "Groonga",
         
     | 
| 
      
 5134 
     | 
    
         
            +
                10
         
     | 
| 
      
 5135 
     | 
    
         
            +
              ],
         
     | 
| 
      
 5136 
     | 
    
         
            +
              [
         
     | 
| 
      
 5137 
     | 
    
         
            +
                3,
         
     | 
| 
      
 5138 
     | 
    
         
            +
                "Mroonga",
         
     | 
| 
      
 5139 
     | 
    
         
            +
                15
         
     | 
| 
      
 5140 
     | 
    
         
            +
              ]
         
     | 
| 
      
 5141 
     | 
    
         
            +
            ]
         
     | 
| 
      
 5142 
     | 
    
         
            +
            </pre></div>
         
     | 
| 
      
 5143 
     | 
    
         
            +
            </div>
         
     | 
| 
      
 5144 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">DRILLDOWN_RESULT</span></code> format is different between <code class="docutils literal"><span class="pre">drilldown</span></code> and
         
     | 
| 
      
 5145 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code>.</p>
         
     | 
| 
      
 5146 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">drilldown</span></code> uses the same format as <code class="docutils literal"><span class="pre">SEARCH_RESULT</span></code>:</p>
         
     | 
| 
      
 5147 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>[
         
     | 
| 
      
 5148 
     | 
    
         
            +
              [N_HITS],
         
     | 
| 
      
 5149 
     | 
    
         
            +
              COLUMNS,
         
     | 
| 
      
 5150 
     | 
    
         
            +
              RECORDS
         
     | 
| 
      
 5151 
     | 
    
         
            +
            ]
         
     | 
| 
      
 5152 
     | 
    
         
            +
            </pre></div>
         
     | 
| 
      
 5153 
     | 
    
         
            +
            </div>
         
     | 
| 
      
 5154 
     | 
    
         
            +
            <p>And <code class="docutils literal"><span class="pre">drilldown</span></code> generates one or more <code class="docutils literal"><span class="pre">DRILLDOWN_RESULT</span></code> when
         
     | 
| 
      
 5155 
     | 
    
         
            +
            <a class="reference internal" href="#select-drilldown"><span>drilldown</span></a> has one ore more keys.</p>
         
     | 
| 
      
 5156 
     | 
    
         
            +
            <p><code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> uses the following format. Multiple
         
     | 
| 
      
 5157 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> are mapped to one object (key-value
         
     | 
| 
      
 5158 
     | 
    
         
            +
            pairs):</p>
         
     | 
| 
      
 5159 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>{
         
     | 
| 
      
 5160 
     | 
    
         
            +
              "LABEL_1": [
         
     | 
| 
      
 5161 
     | 
    
         
            +
                [N_HITS],
         
     | 
| 
      
 5162 
     | 
    
         
            +
                COLUMNS,
         
     | 
| 
      
 5163 
     | 
    
         
            +
                RECORDS
         
     | 
| 
      
 5164 
     | 
    
         
            +
              ],
         
     | 
| 
      
 5165 
     | 
    
         
            +
              "LABEL_2": [
         
     | 
| 
      
 5166 
     | 
    
         
            +
                [N_HITS],
         
     | 
| 
      
 5167 
     | 
    
         
            +
                COLUMNS,
         
     | 
| 
      
 5168 
     | 
    
         
            +
                RECORDS
         
     | 
| 
      
 5169 
     | 
    
         
            +
              ],
         
     | 
| 
      
 5170 
     | 
    
         
            +
              ...,
         
     | 
| 
      
 5171 
     | 
    
         
            +
              "LABEL_N": [
         
     | 
| 
      
 5172 
     | 
    
         
            +
                [N_HITS],
         
     | 
| 
      
 5173 
     | 
    
         
            +
                COLUMNS,
         
     | 
| 
      
 5174 
     | 
    
         
            +
                RECORDS
         
     | 
| 
      
 5175 
     | 
    
         
            +
              ]
         
     | 
| 
      
 5176 
     | 
    
         
            +
            }
         
     | 
| 
      
 5177 
     | 
    
         
            +
            </pre></div>
         
     | 
| 
      
 5178 
     | 
    
         
            +
            </div>
         
     | 
| 
      
 5179 
     | 
    
         
            +
            <p>Each <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code> corresponds to the following:</p>
         
     | 
| 
      
 5180 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>"LABEL": [
         
     | 
| 
      
 5181 
     | 
    
         
            +
              [N_HITS],
         
     | 
| 
      
 5182 
     | 
    
         
            +
              COLUMNS,
         
     | 
| 
      
 5183 
     | 
    
         
            +
              RECORDS
         
     | 
| 
      
 5184 
     | 
    
         
            +
            ]
         
     | 
| 
      
 5185 
     | 
    
         
            +
            </pre></div>
         
     | 
| 
      
 5186 
     | 
    
         
            +
            </div>
         
     | 
| 
      
 5187 
     | 
    
         
            +
            <p>The following value part is the same format as <code class="docutils literal"><span class="pre">SEARCH_RESULT</span></code>:</p>
         
     | 
| 
      
 5188 
     | 
    
         
            +
            <div class="highlight-none"><div class="highlight"><pre>[
         
     | 
| 
      
 5189 
     | 
    
         
            +
              [N_HITS],
         
     | 
| 
      
 5190 
     | 
    
         
            +
              COLUMNS,
         
     | 
| 
      
 5191 
     | 
    
         
            +
              RECORDS
         
     | 
| 
      
 5192 
     | 
    
         
            +
            ]
         
     | 
| 
      
 5193 
     | 
    
         
            +
            </pre></div>
         
     | 
| 
      
 5194 
     | 
    
         
            +
            </div>
         
     | 
| 
      
 5195 
     | 
    
         
            +
            <p>See also <a class="reference internal" href="#select-drilldown-label-output-format"><span>Output format for drilldown[${LABEL}] style</span></a> for
         
     | 
| 
      
 5196 
     | 
    
         
            +
            <code class="docutils literal"><span class="pre">drilldown[${LABEL}]</span></code> style drilldown output format.</p>
         
     | 
| 
       4948 
5197 
     | 
    
         
             
            </div>
         
     | 
| 
       4949 
5198 
     | 
    
         
             
            <div class="section" id="see-also">
         
     | 
| 
       4950 
     | 
    
         
            -
            <h2>7.3. 
     | 
| 
      
 5199 
     | 
    
         
            +
            <h2>7.3.41.6. See also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
         
     | 
| 
       4951 
5200 
     | 
    
         
             
            <blockquote>
         
     | 
| 
       4952 
5201 
     | 
    
         
             
            <div><ul class="simple">
         
     | 
| 
       4953 
5202 
     | 
    
         
             
            <li><a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a></li>
         
     | 
| 
         @@ -4961,95 +5210,97 @@ the same <tt class="docutils literal"><span class="pre">"KEYWORD"</spa 
     | 
|
| 
       4961 
5210 
     | 
    
         
             
                      </div>
         
     | 
| 
       4962 
5211 
     | 
    
         
             
                    </div>
         
     | 
| 
       4963 
5212 
     | 
    
         
             
                  </div>
         
     | 
| 
       4964 
     | 
    
         
            -
                  <div class="sphinxsidebar">
         
     | 
| 
      
 5213 
     | 
    
         
            +
                  <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
         
     | 
| 
       4965 
5214 
     | 
    
         
             
                    <div class="sphinxsidebarwrapper">
         
     | 
| 
       4966 
5215 
     | 
    
         
             
              <h3><a href="../../index.html">Table Of Contents</a></h3>
         
     | 
| 
       4967 
5216 
     | 
    
         
             
              <ul>
         
     | 
| 
       4968 
     | 
    
         
            -
            <li><a class="reference internal" href="#">7.3. 
     | 
| 
       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. 
     | 
| 
      
 5217 
     | 
    
         
            +
            <li><a class="reference internal" href="#">7.3.41. <code class="docutils literal"><span class="pre">select</span></code></a><ul>
         
     | 
| 
      
 5218 
     | 
    
         
            +
            <li><a class="reference internal" href="#summary">7.3.41.1. Summary</a></li>
         
     | 
| 
      
 5219 
     | 
    
         
            +
            <li><a class="reference internal" href="#syntax">7.3.41.2. Syntax</a></li>
         
     | 
| 
      
 5220 
     | 
    
         
            +
            <li><a class="reference internal" href="#usage">7.3.41.3. Usage</a><ul>
         
     | 
| 
      
 5221 
     | 
    
         
            +
            <li><a class="reference internal" href="#simple-usage">7.3.41.3.1. Simple usage</a></li>
         
     | 
| 
      
 5222 
     | 
    
         
            +
            <li><a class="reference internal" href="#search-conditions">7.3.41.3.2. Search conditions</a><ul>
         
     | 
| 
      
 5223 
     | 
    
         
            +
            <li><a class="reference internal" href="#search-condition-query">7.3.41.3.2.1. Search condition: <code class="docutils literal"><span class="pre">query</span></code></a></li>
         
     | 
| 
      
 5224 
     | 
    
         
            +
            <li><a class="reference internal" href="#search-condition-filter">7.3.41.3.2.2. Search condition: <code class="docutils literal"><span class="pre">filter</span></code></a></li>
         
     | 
| 
       4976 
5225 
     | 
    
         
             
            </ul>
         
     | 
| 
       4977 
5226 
     | 
    
         
             
            </li>
         
     | 
| 
       4978 
     | 
    
         
            -
            <li><a class="reference internal" href="#paging">7.3. 
     | 
| 
       4979 
     | 
    
         
            -
            <li><a class="reference internal" href="#the-total-number-of-records">7.3. 
     | 
| 
       4980 
     | 
    
         
            -
            <li><a class="reference internal" href="#drilldown">7.3. 
     | 
| 
      
 5227 
     | 
    
         
            +
            <li><a class="reference internal" href="#paging">7.3.41.3.3. Paging</a></li>
         
     | 
| 
      
 5228 
     | 
    
         
            +
            <li><a class="reference internal" href="#the-total-number-of-records">7.3.41.3.4. The total number of records</a></li>
         
     | 
| 
      
 5229 
     | 
    
         
            +
            <li><a class="reference internal" href="#drilldown">7.3.41.3.5. Drilldown</a></li>
         
     | 
| 
       4981 
5230 
     | 
    
         
             
            </ul>
         
     | 
| 
       4982 
5231 
     | 
    
         
             
            </li>
         
     | 
| 
       4983 
     | 
    
         
            -
            <li><a class="reference internal" href="#parameters">7.3. 
     | 
| 
       4984 
     | 
    
         
            -
            <li><a class="reference internal" href="#required-parameter">7.3. 
     | 
| 
       4985 
     | 
    
         
            -
            <li><a class="reference internal" href="#table">7.3. 
     | 
| 
      
 5232 
     | 
    
         
            +
            <li><a class="reference internal" href="#parameters">7.3.41.4. Parameters</a><ul>
         
     | 
| 
      
 5233 
     | 
    
         
            +
            <li><a class="reference internal" href="#required-parameter">7.3.41.4.1. Required parameter</a><ul>
         
     | 
| 
      
 5234 
     | 
    
         
            +
            <li><a class="reference internal" href="#table">7.3.41.4.1.1. <code class="docutils literal"><span class="pre">table</span></code></a></li>
         
     | 
| 
       4986 
5235 
     | 
    
         
             
            </ul>
         
     | 
| 
       4987 
5236 
     | 
    
         
             
            </li>
         
     | 
| 
       4988 
     | 
    
         
            -
            <li><a class="reference internal" href="#search-related-parameters">7.3. 
     | 
| 
       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. 
     | 
| 
      
 5237 
     | 
    
         
            +
            <li><a class="reference internal" href="#search-related-parameters">7.3.41.4.2. Search related parameters</a><ul>
         
     | 
| 
      
 5238 
     | 
    
         
            +
            <li><a class="reference internal" href="#match-columns">7.3.41.4.2.1. <code class="docutils literal"><span class="pre">match_columns</span></code></a></li>
         
     | 
| 
      
 5239 
     | 
    
         
            +
            <li><a class="reference internal" href="#query">7.3.41.4.2.2. <code class="docutils literal"><span class="pre">query</span></code></a></li>
         
     | 
| 
      
 5240 
     | 
    
         
            +
            <li><a class="reference internal" href="#filter">7.3.41.4.2.3. <code class="docutils literal"><span class="pre">filter</span></code></a></li>
         
     | 
| 
       4992 
5241 
     | 
    
         
             
            </ul>
         
     | 
| 
       4993 
5242 
     | 
    
         
             
            </li>
         
     | 
| 
       4994 
     | 
    
         
            -
            <li><a class="reference internal" href="#advanced-search-parameters">7.3. 
     | 
| 
       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. 
     | 
| 
      
 5243 
     | 
    
         
            +
            <li><a class="reference internal" href="#advanced-search-parameters">7.3.41.4.3. Advanced search parameters</a><ul>
         
     | 
| 
      
 5244 
     | 
    
         
            +
            <li><a class="reference internal" href="#match-escalation-threshold">7.3.41.4.3.1. <code class="docutils literal"><span class="pre">match_escalation_threshold</span></code></a></li>
         
     | 
| 
      
 5245 
     | 
    
         
            +
            <li><a class="reference internal" href="#query-expansion">7.3.41.4.3.2. <code class="docutils literal"><span class="pre">query_expansion</span></code></a></li>
         
     | 
| 
      
 5246 
     | 
    
         
            +
            <li><a class="reference internal" href="#query-flags">7.3.41.4.3.3. <code class="docutils literal"><span class="pre">query_flags</span></code></a></li>
         
     | 
| 
      
 5247 
     | 
    
         
            +
            <li><a class="reference internal" href="#query-expander">7.3.41.4.3.4. <code class="docutils literal"><span class="pre">query_expander</span></code></a></li>
         
     | 
| 
       4999 
5248 
     | 
    
         
             
            </ul>
         
     | 
| 
       5000 
5249 
     | 
    
         
             
            </li>
         
     | 
| 
       5001 
     | 
    
         
            -
            <li><a class="reference internal" href="#output-related-parameters">7.3. 
     | 
| 
       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. 
     | 
| 
      
 5250 
     | 
    
         
            +
            <li><a class="reference internal" href="#output-related-parameters">7.3.41.4.4. Output related parameters</a><ul>
         
     | 
| 
      
 5251 
     | 
    
         
            +
            <li><a class="reference internal" href="#output-columns">7.3.41.4.4.1. <code class="docutils literal"><span class="pre">output_columns</span></code></a></li>
         
     | 
| 
      
 5252 
     | 
    
         
            +
            <li><a class="reference internal" href="#sortby">7.3.41.4.4.2. <code class="docutils literal"><span class="pre">sortby</span></code></a></li>
         
     | 
| 
      
 5253 
     | 
    
         
            +
            <li><a class="reference internal" href="#offset">7.3.41.4.4.3. <code class="docutils literal"><span class="pre">offset</span></code></a></li>
         
     | 
| 
      
 5254 
     | 
    
         
            +
            <li><a class="reference internal" href="#limit">7.3.41.4.4.4. <code class="docutils literal"><span class="pre">limit</span></code></a></li>
         
     | 
| 
      
 5255 
     | 
    
         
            +
            <li><a class="reference internal" href="#scorer">7.3.41.4.4.5. <code class="docutils literal"><span class="pre">scorer</span></code></a></li>
         
     | 
| 
       5007 
5256 
     | 
    
         
             
            </ul>
         
     | 
| 
       5008 
5257 
     | 
    
         
             
            </li>
         
     | 
| 
       5009 
     | 
    
         
            -
            <li><a class="reference internal" href="#drilldown-related-parameters">7.3. 
     | 
| 
       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. 
     | 
| 
      
 5258 
     | 
    
         
            +
            <li><a class="reference internal" href="#drilldown-related-parameters">7.3.41.4.5. Drilldown related parameters</a><ul>
         
     | 
| 
      
 5259 
     | 
    
         
            +
            <li><a class="reference internal" href="#select-drilldown">7.3.41.4.5.1. <code class="docutils literal"><span class="pre">drilldown</span></code></a></li>
         
     | 
| 
      
 5260 
     | 
    
         
            +
            <li><a class="reference internal" href="#drilldown-sortby">7.3.41.4.5.2. <code class="docutils literal"><span class="pre">drilldown_sortby</span></code></a></li>
         
     | 
| 
      
 5261 
     | 
    
         
            +
            <li><a class="reference internal" href="#drilldown-output-columns">7.3.41.4.5.3. <code class="docutils literal"><span class="pre">drilldown_output_columns</span></code></a></li>
         
     | 
| 
      
 5262 
     | 
    
         
            +
            <li><a class="reference internal" href="#drilldown-offset">7.3.41.4.5.4. <code class="docutils literal"><span class="pre">drilldown_offset</span></code></a></li>
         
     | 
| 
      
 5263 
     | 
    
         
            +
            <li><a class="reference internal" href="#drilldown-limit">7.3.41.4.5.5. <code class="docutils literal"><span class="pre">drilldown_limit</span></code></a></li>
         
     | 
| 
      
 5264 
     | 
    
         
            +
            <li><a class="reference internal" href="#drilldown-calc-types">7.3.41.4.5.6. <code class="docutils literal"><span class="pre">drilldown_calc_types</span></code></a></li>
         
     | 
| 
      
 5265 
     | 
    
         
            +
            <li><a class="reference internal" href="#drilldown-calc-target">7.3.41.4.5.7. <code class="docutils literal"><span class="pre">drilldown_calc_target</span></code></a></li>
         
     | 
| 
       5017 
5266 
     | 
    
         
             
            </ul>
         
     | 
| 
       5018 
5267 
     | 
    
         
             
            </li>
         
     | 
| 
       5019 
     | 
    
         
            -
            <li><a class="reference internal" href="#advanced-drilldown-related-parameters">7.3. 
     | 
| 
       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. 
     | 
| 
      
 5268 
     | 
    
         
            +
            <li><a class="reference internal" href="#advanced-drilldown-related-parameters">7.3.41.4.6. Advanced drilldown related parameters</a><ul>
         
     | 
| 
      
 5269 
     | 
    
         
            +
            <li><a class="reference internal" href="#drilldown-label-keys">7.3.41.4.6.1. <code class="docutils literal"><span class="pre">drilldown[${LABEL}].keys</span></code></a></li>
         
     | 
| 
      
 5270 
     | 
    
         
            +
            <li><a class="reference internal" href="#drilldown-label-output-columns">7.3.41.4.6.2. <code class="docutils literal"><span class="pre">drilldown[${LABEL}].output_columns</span></code></a></li>
         
     | 
| 
      
 5271 
     | 
    
         
            +
            <li><a class="reference internal" href="#output-format-for-drilldown-label-style">7.3.41.4.6.3. Output format for <code class="docutils literal"><span class="pre">drilldown[${LABEL}]</span></code> style</a></li>
         
     | 
| 
       5023 
5272 
     | 
    
         
             
            </ul>
         
     | 
| 
       5024 
5273 
     | 
    
         
             
            </li>
         
     | 
| 
       5025 
     | 
    
         
            -
            <li><a class="reference internal" href="#cache-related-parameter">7.3. 
     | 
| 
       5026 
     | 
    
         
            -
            <li><a class="reference internal" href="#cache">7.3. 
     | 
| 
      
 5274 
     | 
    
         
            +
            <li><a class="reference internal" href="#cache-related-parameter">7.3.41.4.7. Cache related parameter</a><ul>
         
     | 
| 
      
 5275 
     | 
    
         
            +
            <li><a class="reference internal" href="#cache">7.3.41.4.7.1. <code class="docutils literal"><span class="pre">cache</span></code></a></li>
         
     | 
| 
       5027 
5276 
     | 
    
         
             
            </ul>
         
     | 
| 
       5028 
5277 
     | 
    
         
             
            </li>
         
     | 
| 
       5029 
     | 
    
         
            -
            <li><a class="reference internal" href="#score-related-parameters">7.3. 
     | 
| 
       5030 
     | 
    
         
            -
            <li><a class="reference internal" href="#adjuster">7.3. 
     | 
| 
      
 5278 
     | 
    
         
            +
            <li><a class="reference internal" href="#score-related-parameters">7.3.41.4.8. Score related parameters</a><ul>
         
     | 
| 
      
 5279 
     | 
    
         
            +
            <li><a class="reference internal" href="#adjuster">7.3.41.4.8.1. <code class="docutils literal"><span class="pre">adjuster</span></code></a></li>
         
     | 
| 
       5031 
5280 
     | 
    
         
             
            </ul>
         
     | 
| 
       5032 
5281 
     | 
    
         
             
            </li>
         
     | 
| 
       5033 
5282 
     | 
    
         
             
            </ul>
         
     | 
| 
       5034 
5283 
     | 
    
         
             
            </li>
         
     | 
| 
       5035 
     | 
    
         
            -
            <li><a class="reference internal" href="# 
     | 
| 
       5036 
     | 
    
         
            -
            <li><a class="reference internal" href="#see-also">7.3. 
     | 
| 
      
 5284 
     | 
    
         
            +
            <li><a class="reference internal" href="#return-value">7.3.41.5. Return value</a></li>
         
     | 
| 
      
 5285 
     | 
    
         
            +
            <li><a class="reference internal" href="#see-also">7.3.41.6. See also</a></li>
         
     | 
| 
       5037 
5286 
     | 
    
         
             
            </ul>
         
     | 
| 
       5038 
5287 
     | 
    
         
             
            </li>
         
     | 
| 
       5039 
5288 
     | 
    
         
             
            </ul>
         
     | 
| 
       5040 
5289 
     | 
    
         | 
| 
       5041 
5290 
     | 
    
         
             
              <h4>Previous topic</h4>
         
     | 
| 
       5042 
5291 
     | 
    
         
             
              <p class="topless"><a href="ruby_load.html"
         
     | 
| 
       5043 
     | 
    
         
            -
                                    title="previous chapter">7.3. 
     | 
| 
      
 5292 
     | 
    
         
            +
                                    title="previous chapter">7.3.40. <code class="docutils literal"><span class="pre">ruby_load</span></code></a></p>
         
     | 
| 
       5044 
5293 
     | 
    
         
             
              <h4>Next topic</h4>
         
     | 
| 
       5045 
5294 
     | 
    
         
             
              <p class="topless"><a href="shutdown.html"
         
     | 
| 
       5046 
     | 
    
         
            -
                                    title="next chapter">7.3. 
     | 
| 
       5047 
     | 
    
         
            -
              < 
     | 
| 
       5048 
     | 
    
         
            -
             
     | 
| 
       5049 
     | 
    
         
            -
                < 
     | 
| 
       5050 
     | 
    
         
            -
             
     | 
| 
       5051 
     | 
    
         
            -
             
     | 
| 
       5052 
     | 
    
         
            -
             
     | 
| 
      
 5295 
     | 
    
         
            +
                                    title="next chapter">7.3.42. <code class="docutils literal"><span class="pre">shutdown</span></code></a></p>
         
     | 
| 
      
 5296 
     | 
    
         
            +
              <div role="note" aria-label="source link">
         
     | 
| 
      
 5297 
     | 
    
         
            +
                <h3>This Page</h3>
         
     | 
| 
      
 5298 
     | 
    
         
            +
                <ul class="this-page-menu">
         
     | 
| 
      
 5299 
     | 
    
         
            +
                  <li><a href="../../_sources/reference/commands/select.txt"
         
     | 
| 
      
 5300 
     | 
    
         
            +
                        rel="nofollow">Show Source</a></li>
         
     | 
| 
      
 5301 
     | 
    
         
            +
                </ul>
         
     | 
| 
      
 5302 
     | 
    
         
            +
               </div>
         
     | 
| 
      
 5303 
     | 
    
         
            +
            <div id="searchbox" style="display: none" role="search">
         
     | 
| 
       5053 
5304 
     | 
    
         
             
              <h3>Quick search</h3>
         
     | 
| 
       5054 
5305 
     | 
    
         
             
                <form class="search" action="../../search.html" method="get">
         
     | 
| 
       5055 
5306 
     | 
    
         
             
                  <input type="text" name="q" />
         
     | 
| 
         @@ -5066,24 +5317,24 @@ the same <tt class="docutils literal"><span class="pre">"KEYWORD"</spa 
     | 
|
| 
       5066 
5317 
     | 
    
         
             
                  </div>
         
     | 
| 
       5067 
5318 
     | 
    
         
             
                  <div class="clearer"></div>
         
     | 
| 
       5068 
5319 
     | 
    
         
             
                </div>
         
     | 
| 
       5069 
     | 
    
         
            -
                <div class="related">
         
     | 
| 
      
 5320 
     | 
    
         
            +
                <div class="related" role="navigation" aria-label="related navigation">
         
     | 
| 
       5070 
5321 
     | 
    
         
             
                  <h3>Navigation</h3>
         
     | 
| 
       5071 
5322 
     | 
    
         
             
                  <ul>
         
     | 
| 
       5072 
5323 
     | 
    
         
             
                    <li class="right" style="margin-right: 10px">
         
     | 
| 
       5073 
5324 
     | 
    
         
             
                      <a href="../../genindex.html" title="General Index"
         
     | 
| 
       5074 
5325 
     | 
    
         
             
                         >index</a></li>
         
     | 
| 
       5075 
5326 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       5076 
     | 
    
         
            -
                      <a href="shutdown.html" title="7.3. 
     | 
| 
      
 5327 
     | 
    
         
            +
                      <a href="shutdown.html" title="7.3.42. shutdown"
         
     | 
| 
       5077 
5328 
     | 
    
         
             
                         >next</a> |</li>
         
     | 
| 
       5078 
5329 
     | 
    
         
             
                    <li class="right" >
         
     | 
| 
       5079 
     | 
    
         
            -
                      <a href="ruby_load.html" title="7.3. 
     | 
| 
      
 5330 
     | 
    
         
            +
                      <a href="ruby_load.html" title="7.3.40. ruby_load"
         
     | 
| 
       5080 
5331 
     | 
    
         
             
                         >previous</a> |</li>
         
     | 
| 
       5081 
     | 
    
         
            -
                    <li><a href="../../index.html">Groonga v5.0. 
     | 
| 
       5082 
     | 
    
         
            -
                      <li><a href="../../reference.html" >7. Reference manual</a> »</li>
         
     | 
| 
       5083 
     | 
    
         
            -
                      <li><a href="../command.html" >7.3. Command</a> »</li> 
         
     | 
| 
      
 5332 
     | 
    
         
            +
                    <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.6-226-gd7da7e7 documentation</a> »</li>
         
     | 
| 
      
 5333 
     | 
    
         
            +
                      <li class="nav-item nav-item-1"><a href="../../reference.html" >7. Reference manual</a> »</li>
         
     | 
| 
      
 5334 
     | 
    
         
            +
                      <li class="nav-item nav-item-2"><a href="../command.html" >7.3. Command</a> »</li> 
         
     | 
| 
       5084 
5335 
     | 
    
         
             
                  </ul>
         
     | 
| 
       5085 
5336 
     | 
    
         
             
                </div>
         
     | 
| 
       5086 
     | 
    
         
            -
                <div class="footer">
         
     | 
| 
      
 5337 
     | 
    
         
            +
                <div class="footer" role="contentinfo">
         
     | 
| 
       5087 
5338 
     | 
    
         
             
                    © Copyright 2009-2015, Brazil, Inc.
         
     | 
| 
       5088 
5339 
     | 
    
         
             
                </div>
         
     | 
| 
       5089 
5340 
     | 
    
         
             
              </body>
         
     |