rroonga 6.1.3-x86-mingw32 → 7.0.2-x86-mingw32

data/vendor/local/share/doc/groonga/en/html/_sources/reference.txt

@@ -23,6 +23,7 @@ Reference manual
    reference/grn_expr
    reference/regular_expression
    reference/function
+   reference/window_function
    reference/operations
    reference/configuration
    reference/alias

data/vendor/local/share/doc/groonga/en/html/_sources/reference/command/request_timeout.txt

@@ -60,7 +60,7 @@ Enable request timeout by default
 
 :doc:`/reference/executables/groonga` supports enabling request
 timeout by default. You can specify the default request timeout by
-:option:`--default-request-timeout`.
+:option:`groonga --default-request-timeout`.
 
 If the default request timeout is larger than 0 second, the default
 request timeout is used as request timeout for all requests.

data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/log_level.txt

@@ -8,11 +8,7 @@
 Summary
 -------
 
-log_level - ログ出力レベルの設定
-
-Groonga組込コマンドの一つであるlog_levelについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
-
-log_levelは、ログ出力レベルを設定します。
+``log_level`` command sets log level of Groonga.
 
 Syntax
 ------
@@ -32,27 +28,57 @@ Parameters
 
 ``level``
 
-  設定するログ出力レベルの値を以下のいずれかで指定します。
-
-     EMERG
-     ALERT
-     CRIT
-     error
-     warning
-     notice
-     info
-     debug
+  Specify log level with a character or string which means log level.
+
+  .. list-table::
+     :header-rows: 1
+
+     * - Value
+       - Alias
+     * - ``E``
+       - ``emerge`` or ``emergency``
+     * - ``A``
+       - ``alert``
+     * - ``C``
+       - ``crit`` or ``critical``
+     * - ``e``
+       - ``error``
+     * - ``w``
+       - ``warn`` or ``warning``
+     * - ``n``
+       - ``notice``
+     * - ``i``
+       - ``info``
+     * - ``d``
+       - ``debug``
+     * - ``-``
+       - ``dump``
+
+  Example::
+
+       emergency
+       alert
+       critical
+       error
+       warning
+       notice
+       info
+       debug
 
 Return value
 ------------
 
-::
+``log_level`` command returns whether log level configuration is succeeded or not::
+
+  [HEADER, SUCCEEDED_OR_NOT]
+
+``HEADER``
 
- [成功かどうかのフラグ]
+  See :doc:`/reference/command/output_format` about ``HEADER``.
 
-``成功かどうかのフラグ``
+``SUCCEEDED_OR_NOT``
 
-  エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
+  If command succeeded, it returns true, otherwise it returns false on error.
 
 See also
 --------

data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_select.txt

@@ -46,17 +46,69 @@ parameters are optional::
                  [drilldown_limit=10]
                  [drilldown_calc_types=NONE]
                  [drilldown_calc_target=null]
+                 [sort_keys=null]
+                 [drilldown_sort_keys=null]
+                 [match_columns=null]
+                 [query=null]
+                 [drilldown_filter=null]
 
-``logical_select`` has the following named parameters for advanced
+This command has the following named parameters for dynamic columns:
+
+   * ``columns[${NAME}].stage=null``
+   * ``columns[${NAME}].flags=COLUMN_SCALAR``
+   * ``columns[${NAME}].type=null``
+   * ``columns[${NAME}].value=null``
+   * ``columns[${NAME}].window.sort_keys=null``
+   * ``columns[${NAME}].window.group_keys=null``
+
+You can use one or more alphabets, digits, ``_`` for ``${NAME}``. For
+example, ``column1`` is a valid ``${NAME}``. This is the same rule as
+normal column. See also :ref:`column-create-name`.
+
+Parameters that have the same ``${NAME}`` are grouped.
+
+For example, the following parameters specify one dynamic column:
+
+  * ``--columns[name].stage initial``
+  * ``--columns[name].type UInt32``
+  * ``--columns[name].value 29``
+
+The following parameters specify two dynamic columns:
+
+  * ``--columns[name1].stage initial``
+  * ``--columns[name1].type UInt32``
+  * ``--columns[name1].value 29``
+  * ``--columns[name2].stage filtered``
+  * ``--columns[name2].type Float``
+  * ``--columns[name2].value '_score * 0.1'``
+
+This command has the following named parameters for advanced
 drilldown:
 
-  * ``drilldown[${LABEL}].keys=null``
-  * ``drilldown[${LABEL}].sortby=null``
-  * ``drilldown[${LABEL}].output_columns="_key, _nsubrecs"``
-  * ``drilldown[${LABEL}].offset=0``
-  * ``drilldown[${LABEL}].limit=10``
-  * ``drilldown[${LABEL}].calc_types=NONE``
-  * ``drilldown[${LABEL}].calc_target=null``
+  * ``drilldowns[${LABEL}].keys=null``
+  * ``drilldowns[${LABEL}].sort_keys=null``
+  * ``drilldowns[${LABEL}].output_columns="_key, _nsubrecs"``
+  * ``drilldowns[${LABEL}].offset=0``
+  * ``drilldowns[${LABEL}].limit=10``
+  * ``drilldowns[${LABEL}].calc_types=NONE``
+  * ``drilldowns[${LABEL}].calc_target=null``
+  * ``drilldowns[${LABEL}].filter=null``
+  * ``drilldowns[${LABEL}].columns[${NAME}].stage=null``
+  * ``drilldowns[${LABEL}].columns[${NAME}].flags=COLUMN_SCALAR``
+  * ``drilldowns[${LABEL}].columns[${NAME}].type=null``
+  * ``drilldowns[${LABEL}].columns[${NAME}].value=null``
+  * ``drilldowns[${LABEL}].columns[${NAME}].window.sort_keys=null``
+  * ``drilldowns[${LABEL}].columns[${NAME}].window.group_keys=null``
+
+.. deprecated:: 6.1.4
+
+   ``drilldown[...]`` syntax is deprecated. Use ``drilldowns[...]``
+   instead.
+
+.. deprecated:: 6.1.5
+
+   :ref:`logical-select-drilldowns-label-sortby` is deprecated.
+   Use :ref:`logical-select-drilldowns-label-sort-keys` instead.
 
 You can use one or more alphabets, digits, ``_`` and ``.`` for
 ``${LABEL}``. For example, ``parent.sub1`` is a valid ``${LABEL}``.
@@ -65,15 +117,15 @@ Parameters that have the same ``${LABEL}`` are grouped.
 
 For example, the following parameters specify one drilldown:
 
-  * ``--drilldown[label].keys column``
-  * ``--drilldown[label].sortby -_nsubrecs``
+  * ``--drilldowns[label].keys column``
+  * ``--drilldowns[label].sort_keys -_nsubrecs``
 
 The following parameters specify two drilldowns:
 
-  * ``--drilldown[label1].keys column1``
-  * ``--drilldown[label1].sortby -_nsubrecs``
-  * ``--drilldown[label2].keys column2``
-  * ``--drilldown[label2].sortby _key``
+  * ``--drilldowns[label1].keys column1``
+  * ``--drilldowns[label1].sort_keys -_nsubrecs``
+  * ``--drilldowns[label2].keys column2``
+  * ``--drilldowns[label2].sort_keys _key``
 
 Differences from ``select``
 ---------------------------
@@ -86,12 +138,12 @@ But there are some differences from :doc:`select`:
 
   * ``logical_table`` and ``shard_key`` parameters are required
     instead of ``table`` parameter.
-  * ``sortby`` isn't supported when multiple shards are used. (Only
+  * ``sort_keys`` isn't supported when multiple shards are used. (Only
     one shard is used, they are supported.)
-  * ``_value.${KEY_NAME}`` in ``drilldown[${LABEL}].sortby`` doesn't
-    work with multiple shards. It works with one shard. ``_key`` in
-    ``drilldown[${LABEL}].sortby`` work with multiple shards.
-  * ``match_columns`` and ``query`` aren't supported yet.
+  * ``_value.${KEY_NAME}`` in ``drilldowns[${LABEL}].sort_keys``
+    doesn't work with multiple shards. It works with one
+    shard. ``_key`` in ``drilldowns[${LABEL}].sort_keys`` work with
+    multiple shards.
   * ``cache`` isn't supported yet.
   * ``match_escalation_threshold`` isn't supported yet.
   * ``query_flags`` isn't supported yet.
@@ -364,22 +416,48 @@ Search related parameters
 ``logical_select`` provides :doc:`select` compatible search related
 parameters.
 
-``match_columns`` and ``query`` aren't supported yet. ``filter`` is
-only supported for now.
-
 .. _logical-select-match-columns:
 
 ``match_columns``
 """""""""""""""""
 
-Not implemented yet.
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`select-match-columns` in :doc:`select`. See
+:ref:`select-match-columns` for details.
+
+Here is an example to find records that include ``"fast"`` text in
+``content`` column:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/match_columns.log
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --match_columns content \
+..   --query "fast"
 
 .. _logical-select-query:
 
 ``query``
 """""""""
 
-Not implemented yet.
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`select-query` in :doc:`select`. See
+:ref:`select-query` for details.
+
+Here is an example to find records that include ``"fast"`` text in
+``content`` column:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/query.log
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --query "content:@fast"
+
+See also :ref:`logical-select-match-columns`.
 
 .. _logical-select-filter:
 
@@ -451,17 +529,26 @@ Here is an example:
 ``sortby``
 """"""""""
 
-Corresponds to :ref:`select-sortby` in :doc:`select`. See
-:ref:`select-sortby` for details.
+.. deprecated:: 6.1.5
+
+   Use :ref:`logical-select-sort-keys` instead.
 
-``sortby`` has a limitation. It works only when the number of search
-target shards is one. If the number of search target shards is larger
-than one, ``sortby`` doesn't work.
+.. _logical-select-sort-keys:
+
+``sort_keys``
+"""""""""""""
+
+Corresponds to :ref:`select-sort-keys` in :doc:`select`. See
+:ref:`select-sort-keys` for details.
+
+``sort_keys`` has a limitation. It works only when the number of
+search target shards is one. If the number of search target shards is
+larger than one, ``sort_keys`` doesn't work.
 
 Here is an example that uses only one shard:
 
 .. groonga-command
-.. include:: ../../example/reference/commands/logical_select/sortby.log
+.. include:: ../../example/reference/commands/logical_select/sort_keys.log
 .. logical_select \
 ..   --logical_table Entries \
 ..   --shard_key created_at \
@@ -469,7 +556,7 @@ Here is an example that uses only one shard:
 ..   --min_border "include" \
 ..   --max "2015/07/09 00:00:00" \
 ..   --max_border "exclude" \
-..   --sortby _key
+..   --sort_keys _key
 
 .. _logical-select-offset:
 
@@ -512,6 +599,204 @@ Here is an example:
 
 Not implemented yet.
 
+.. _logical-select-dynamic-column-related-parameters:
+
+Dynamic column related parameters
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. versionadded:: 7.0.1
+
+All dynamic column related parameters in :doc:`select` are
+supported. See :ref:`select-dynamic-column-related-parameters` for
+details.
+
+.. _logical-select-columns-name-stage:
+
+``columns[${NAME}].stage``
+""""""""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`select-columns-name-stage` in :doc:`select`. See
+:ref:`select-columns-name-stage` for details.
+
+This is a required parameter.
+
+Here is an example that creates ``is_popular`` column at ``initial``
+stage. You can use ``is_popular`` in all parameters such as ``filter``
+and ``output_columns``:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/columns_name_stage.log
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --columns[is_popular].stage initial \
+..   --columns[is_popular].type Bool \
+..   --columns[is_popular].value 'n_likes >= 10' \
+..   --filter is_popular \
+..   --output_columns _id,is_popular,n_likes
+
+.. _logical-select-columns-name-flags:
+
+``columns[${NAME}].flags``
+""""""""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`select-columns-name-flags` in :doc:`select`. See
+:ref:`select-columns-name-flags` for details.
+
+The default value is ``COLUMN_SCALAR``.
+
+Here is an example that creates a vector column by ``COLUMN_VECTOR``
+flags. ``plugin_register functions/vector`` is for using
+:doc:`/reference/functions/vector_new` function:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/columns_name_flags.log
+.. plugin_register functions/vector
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --columns[vector].stage initial \
+..   --columns[vector].flags COLUMN_VECTOR \
+..   --columns[vector].type UInt32 \
+..   --columns[vector].value 'vector_new(1, 2, 3)' \
+..   --output_columns _id,vector
+
+.. _logical-select-columns-name-type:
+
+``columns[${NAME}].type``
+"""""""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`select-columns-name-type` in :doc:`select`. See
+:ref:`select-columns-name-type` for details.
+
+This is a required parameter.
+
+Here is an example that creates a ``ShortText`` type column. Stored
+value is casted to ``ShortText`` automatically. In this example,
+number is casted to ``ShortText``:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/columns_name_type.log
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --columns[n_likes_string].stage initial \
+..   --columns[n_likes_string].type ShortText \
+..   --columns[n_likes_string].value n_likes \
+..   --output_columns _id,n_likes,n_likes_string
+
+.. _logical-select-columns-name-value:
+
+``columns[${NAME}].value``
+""""""""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`select-columns-name-value` in :doc:`select`. See
+:ref:`select-columns-name-value` for details.
+
+You need to specify :doc:`/reference/window_function` as ``value``
+value and other window function related parameters when you use window
+function. See :ref:`logical-select-window-function-related-parameters`
+for details.
+
+This is a required parameter.
+
+Here is an example that creates a new dynamic column that stores the
+number of characters of content. This example uses
+:doc:`/reference/functions/string_length` function in
+``functions/string`` plugin to compute the number of characters in a
+string. :doc:`plugin_register` is used to register
+``functions/string`` plugin:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/columns_name_value.log
+.. plugin_register functions/string
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --columns[content_length].stage initial \
+..   --columns[content_length].type UInt32 \
+..   --columns[content_length].value 'string_length(content)' \
+..   --output_columns _id,content,content_length
+
+.. _logical-select-window-function-related-parameters:
+
+Window function related parameters
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. versionadded:: 7.0.1
+
+All window function related parameters in :doc:`select` are
+supported. See :ref:`select-window-function-related-parameters` for
+details.
+
+.. _logical-select-columns-name-window-sort-keys:
+
+``columns[${NAME}].window.sort_keys``
+"""""""""""""""""""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`select-columns-name-window-sort-keys` in
+:doc:`select`. See :ref:`select-columns-name-window-sort-keys` for
+details.
+
+You must specify :ref:`logical-select-columns-name-window-sort-keys`
+or :ref:`logical-select-columns-name-window-group-keys` to use window
+function.
+
+Here is an example that computes cumulative sum per
+``Entries.tag``. Each group is sorted by ``Entries._key``:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/columns_name_window_sort_keys.log
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --columns[n_likes_cumulative_sum_per_tag].stage initial \
+..   --columns[n_likes_cumulative_sum_per_tag].type UInt32 \
+..   --columns[n_likes_cumulative_sum_per_tag].value 'window_sum(n_likes)' \
+..   --columns[n_likes_cumulative_sum_per_tag].window.sort_keys _key \
+..   --columns[n_likes_cumulative_sum_per_tag].window.group_keys tag \
+..   --sort_keys _key \
+..   --output_columns tag,_key,n_likes,n_likes_cumulative_sum_per_tag
+
+.. _logical-select-columns-name-window-group-keys:
+
+``columns[${NAME}].window.group_keys``
+""""""""""""""""""""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`select-columns-name-window-group-keys` in
+:doc:`select`. See :ref:`select-columns-name-window-group-keys` for
+details.
+
+You must specify :ref:`logical-select-columns-name-window-sort-keys`
+or :ref:`logical-select-columns-name-window-group-keys` to use window
+function.
+
+Here is an example that computes sum per ``Entries.tag``:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/columns_name_window_group_keys.log
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --columns[n_likes_sum_per_tag].stage initial \
+..   --columns[n_likes_sum_per_tag].type UInt32 \
+..   --columns[n_likes_sum_per_tag].value 'window_sum(n_likes)' \
+..   --columns[n_likes_sum_per_tag].window.group_keys tag \
+..   --sort_keys _key \
+..   --output_columns tag,_key,n_likes,n_likes_sum_per_tag
+
 .. _logical-select-drilldown-related-parameters:
 
 Drilldown related parameters
@@ -543,20 +828,29 @@ Here is an example:
 ``drilldown_sortby``
 """"""""""""""""""""
 
-Corresponds to :ref:`select-drilldown-sortby` in :doc:`select`. See
-:ref:`select-drilldown-sortby` for details.
+.. deprecated:: 6.1.5
+
+   Use :ref:`logical-select-drilldown-sort-keys` instead.
+
+.. _logical-select-drilldown-sort-keys:
+
+``drilldown_sort_keys``
+"""""""""""""""""""""""
+
+Corresponds to :ref:`select-drilldown-sort-keys` in :doc:`select`. See
+:ref:`select-drilldown-sort-keys` for details.
 
 Here is an example:
 
 .. groonga-command
-.. include:: ../../example/reference/commands/logical_select/drilldown_sortby.log
+.. include:: ../../example/reference/commands/logical_select/drilldown_sort_keys.log
 .. logical_select \
 ..   --logical_table Entries \
 ..   --shard_key created_at \
 ..   --limit 0 \
 ..   --output_columns _id \
 ..   --drilldown tag \
-..   --drilldown_sortby -_nsubrecs,_key
+..   --drilldown_sort_keys -_nsubrecs,_key
 
 .. _logical-select-drilldown-output-columns:
 
@@ -650,6 +944,30 @@ Corresponds to :ref:`select-drilldown-calc-target` in
 
 See also :ref:`logical-select-drilldown-calc-types` for an example.
 
+.. _logical-select-drilldown-filter:
+
+``drilldown_filter``
+""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`select-drilldown-filter` in
+:doc:`select`. See :ref:`select-drilldown-filter` for details.
+
+Here is an example to suppress drilled down tags that are occurred
+only once:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/drilldown_filter.log
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --limit 0 \
+..   --output_columns _id \
+..   --drilldown tag \
+..   --drilldown_filter "_nsubrecs > 1" \
+..   --drilldown_output_columns _key,_nsubrecs
+
 .. _logical-select-advanced-drilldown-related-parameters:
 
 Advanced drilldown related parameters
@@ -661,70 +979,80 @@ details.
 
 There are some limitations:
 
-  * ``_value.${KEY_NAME}`` in ``drilldown[${LABEL}].sortby`` doesn't
-    work with multiple shards. It works with one shard. ``_key`` in
-    ``drilldown[${LABEL}].sortby`` work with multiple shards.
+  * ``_value.${KEY_NAME}`` in ``drilldowns[${LABEL}].sort_keys``
+    doesn't work with multiple shards. It works with one
+    shard. ``_key`` in ``drilldowns[${LABEL}].sort_key`` work with
+    multiple shards.
 
-.. _logical-select-drilldown-label-keys:
+.. _logical-select-drilldowns-label-keys:
 
-``drilldown[${LABEL}].keys``
-""""""""""""""""""""""""""""
+``drilldowns[${LABEL}].keys``
+"""""""""""""""""""""""""""""
 
-Corresponds to :ref:`select-drilldown-label-keys` in
-:doc:`select`. See :ref:`select-drilldown-label-keys` for details.
+Corresponds to :ref:`select-drilldowns-label-keys` in
+:doc:`select`. See :ref:`select-drilldowns-label-keys` for details.
 
 Here is an example:
 
 .. groonga-command
-.. include:: ../../example/reference/commands/logical_select/drilldown_label_keys.log
+.. include:: ../../example/reference/commands/logical_select/drilldowns_label_keys.log
 .. logical_select \
 ..   --logical_table Entries \
 ..   --shard_key created_at \
 ..   --limit 0 \
 ..   --output_columns _id \
-..   --drilldown[tag.n_likes].keys tag,n_likes \
-..   --drilldown[tag.n_likes].output_columns _value.tag,_value.n_likes,_nsubrecs
+..   --drilldowns[tag.n_likes].keys tag,n_likes \
+..   --drilldowns[tag.n_likes].output_columns _value.tag,_value.n_likes,_nsubrecs
 
-.. _logical-select-drilldown-label-output-columns:
+.. _logical-select-drilldowns-label-output-columns:
 
-``drilldown[${LABEL}].output_columns``
-""""""""""""""""""""""""""""""""""""""
+``drilldowns[${LABEL}].output_columns``
+"""""""""""""""""""""""""""""""""""""""
 
-Corresponds to :ref:`select-drilldown-label-output-columns` in
-:doc:`select`. See :ref:`select-drilldown-label-output-columns` for
+Corresponds to :ref:`select-drilldowns-label-output-columns` in
+:doc:`select`. See :ref:`select-drilldowns-label-output-columns` for
 details.
 
 Here is an example:
 
 .. groonga-command
-.. include:: ../../example/reference/commands/logical_select/drilldown_label_output_columns.log
+.. include:: ../../example/reference/commands/logical_select/drilldowns_label_output_columns.log
 .. logical_select \
 ..   --logical_table Entries \
 ..   --shard_key created_at \
 ..   --limit 0 \
 ..   --output_columns _id \
-..   --drilldown[tag].keys tag \
-..   --drilldown[tag].output_columns _key,_nsubrecs
+..   --drilldowns[tag].keys tag \
+..   --drilldowns[tag].output_columns _key,_nsubrecs
 
-.. _logical-select-drilldown-label-sortby:
+.. _logical-select-drilldowns-label-sortby:
 
-``drilldown[${LABEL}].sortby``
-""""""""""""""""""""""""""""""
+``drilldowns[${LABEL}].sortby``
+"""""""""""""""""""""""""""""""
 
-Corresponds to :ref:`logical-select-drilldown-sortby` in not labeled
-drilldown.
+.. deprecated:: 6.1.5
+
+   Use :ref:`logical-select-drilldowns-label-sort-keys` instead.
 
-``drilldown[${LABEL}].sortby`` has a limitation.
+.. _logical-select-drilldowns-label-sort-keys:
+
+``drilldowns[${LABEL}].sort_keys``
+""""""""""""""""""""""""""""""""""
+
+Corresponds to :ref:`logical-select-drilldown-sort-keys` in not
+labeled drilldown.
 
-``_value.${KEY_NAME}`` in ``drilldown[${LABEL}].sortby`` doesn't work
-with multiple shards. It works with one shard. ``_key`` in
-``drilldown[${LABEL}].sortby`` work with multiple shards.
+``drilldowns[${LABEL}].sort_keys`` has a limitation.
+
+``_value.${KEY_NAME}`` in ``drilldowns[${LABEL}].sort_keys`` doesn't
+work with multiple shards. It works with one shard. ``_key`` in
+``drilldowns[${LABEL}].sort_keys`` work with multiple shards.
 
 Here is an example that uses ``_value.${KEY_NAME}`` with only one
 shard:
 
 .. groonga-command
-.. include:: ../../example/reference/commands/logical_select/drilldown_label_sortby.log
+.. include:: ../../example/reference/commands/logical_select/drilldowns_label_sort_keys.log
 .. logical_select \
 ..   --logical_table Entries \
 ..   --shard_key created_at \
@@ -734,14 +1062,14 @@ shard:
 ..   --max_border "exclude" \
 ..   --limit 0 \
 ..   --output_columns _id \
-..   --drilldown[tag.n_likes].keys tag,n_likes \
-..   --drilldown[tag.n_likes].output_columns _nsubrecs,_value.n_likes,_value.tag \
-..   --drilldown[tag.n_likes].sortby -_nsubrecs,_value.n_likes,_value.tag
+..   --drilldowns[tag.n_likes].keys tag,n_likes \
+..   --drilldowns[tag.n_likes].output_columns _nsubrecs,_value.n_likes,_value.tag \
+..   --drilldowns[tag.n_likes].sort_keys -_nsubrecs,_value.n_likes,_value.tag
 
-.. _logical-select-drilldown-label-offset:
+.. _logical-select-drilldowns-label-offset:
 
-``drilldown[${LABEL}].offset``
-""""""""""""""""""""""""""""""
+``drilldowns[${LABEL}].offset``
+"""""""""""""""""""""""""""""""
 
 Corresponds to :ref:`logical-select-drilldown-offset` in not labeled
 drilldown.
@@ -749,19 +1077,19 @@ drilldown.
 Here is an example:
 
 .. groonga-command
-.. include:: ../../example/reference/commands/logical_select/drilldown_label_offset.log
+.. include:: ../../example/reference/commands/logical_select/drilldowns_label_offset.log
 .. logical_select \
 ..   --logical_table Entries \
 ..   --shard_key created_at \
 ..   --limit 0 \
 ..   --output_columns _id \
-..   --drilldown[tag.n_likes].keys tag \
-..   --drilldown[tag.n_likes].offset 1
+..   --drilldowns[tag.n_likes].keys tag \
+..   --drilldowns[tag.n_likes].offset 1
 
-.. _logical-select-drilldown-label-limit:
+.. _logical-select-drilldowns-label-limit:
 
-``drilldown[${LABEL}].limit``
-"""""""""""""""""""""""""""""
+``drilldowns[${LABEL}].limit``
+""""""""""""""""""""""""""""""
 
 Corresponds to :ref:`logical-select-drilldown-limit` in not labeled
 drilldown.
@@ -769,19 +1097,19 @@ drilldown.
 Here is an example:
 
 .. groonga-command
-.. include:: ../../example/reference/commands/logical_select/drilldown_label_limit.log
+.. include:: ../../example/reference/commands/logical_select/drilldowns_label_limit.log
 .. logical_select \
 ..   --logical_table Entries \
 ..   --shard_key created_at \
 ..   --limit 0 \
 ..   --output_columns _id \
-..   --drilldown[tag.n_likes].keys tag \
-..   --drilldown[tag.n_likes].limit 2
+..   --drilldowns[tag.n_likes].keys tag \
+..   --drilldowns[tag.n_likes].limit 2
 
-.. _logical-select-drilldown-label-calc-types:
+.. _logical-select-drilldowns-label-calc-types:
 
-``drilldown[${LABEL}].calc_types``
-""""""""""""""""""""""""""""""""""
+``drilldowns[${LABEL}].calc_types``
+"""""""""""""""""""""""""""""""""""
 
 Corresponds to :ref:`logical-select-drilldown-calc-types` in not
 labeled drilldown.
@@ -789,28 +1117,241 @@ labeled drilldown.
 Here is an example:
 
 .. groonga-command
-.. include:: ../../example/reference/commands/logical_select/drilldown_label_calc_types.log
+.. include:: ../../example/reference/commands/logical_select/drilldowns_label_calc_types.log
 .. logical_select \
 ..   --logical_table Entries \
 ..   --shard_key created_at \
 ..   --limit 0 \
 ..   --output_columns _id \
-..   --drilldown[tag].keys tag \
-..   --drilldown[tag].calc_types MAX,MIN,SUM,AVG \
-..   --drilldown[tag].calc_target n_likes \
-..   --drilldown[tag].output_columns _key,_nsubrecs,_max,_min,_sum,_avg
+..   --drilldowns[tag].keys tag \
+..   --drilldowns[tag].calc_types MAX,MIN,SUM,AVG \
+..   --drilldowns[tag].calc_target n_likes \
+..   --drilldowns[tag].output_columns _key,_nsubrecs,_max,_min,_sum,_avg
 
-.. _logical-select-drilldown-label-calc-target:
+.. _logical-select-drilldowns-label-calc-target:
 
-``drilldown[${LABEL}].calc_target``
-"""""""""""""""""""""""""""""""""""
+``drilldowns[${LABEL}].calc_target``
+""""""""""""""""""""""""""""""""""""
 
 Corresponds to :ref:`logical-select-drilldown-calc-target` in not
 labeled drilldown.
 
-See also :ref:`logical-select-drilldown-label-calc-types`
+See also :ref:`logical-select-drilldowns-label-calc-types`
 for an example.
 
+.. _logical-select-drilldowns-label-filter:
+
+``drilldowns[${LABEL}].filter``
+"""""""""""""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`logical-select-drilldown-filter` in not labeled
+drilldown.
+
+Here is an example to suppress drilled down tags that are occurred
+only once:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/drilldowns_label_filter.log
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --limit 0 \
+..   --output_columns _id \
+..   --drilldowns[tag].keys tag \
+..   --drilldowns[tag].filter "_nsubrecs > 1" \
+..   --drilldowns[tag].output_columns _key,_nsubrecs
+
+.. _logical-select-drilldowns-label-columns-name-stage:
+
+``drilldowns[${LABEL}].columns[${NAME}].stage``
+"""""""""""""""""""""""""""""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`select-drilldowns-label-columns-name-stage` in
+:doc:`select`. See :ref:`select-drilldowns-label-columns-name-stage`
+for details.
+
+Here is an example that creates a dynamic column at ``initial``
+stage. This example creates a dynamic column that stores whether each
+drilled down tag is occurred only once or not:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/drilldowns_label_columns_name_stage.log
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --limit 0 \
+..   --output_columns _id \
+..   --drilldowns[tag].keys tag \
+..   --drilldowns[tag].columns[is_popular].stage initial \
+..   --drilldowns[tag].columns[is_popular].type Bool \
+..   --drilldowns[tag].columns[is_popular].value '_nsubrecs > 1' \
+..   --drilldowns[tag].output_columns _key,_nsubrecs,is_popular
+
+.. _logical-select-drilldowns-label-columns-name-flags:
+
+``drilldowns[${LABEL}].columns[${NAME}].flags``
+"""""""""""""""""""""""""""""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`logical-select-columns-name-flags` in main
+search.
+
+The default value is ``COLUMN_SCALAR``.
+
+Here is an example that creates a vector column by ``COLUMN_VECTOR``
+flags. ``plugin_register functions/vector`` is for using
+:doc:`/reference/functions/vector_new` function:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/drilldowns_label_columns_name_flags.log
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --limit 0 \
+..   --output_columns _id \
+..   --drilldowns[tag].keys tag \
+..   --drilldowns[tag].columns[vector].stage initial \
+..   --drilldowns[tag].columns[vector].flags COLUMN_VECTOR \
+..   --drilldowns[tag].columns[vector].type ShortText \
+..   --drilldowns[tag].columns[vector].value 'vector_new("a", "b", "c")' \
+..   --drilldowns[tag].output_columns _key,vector
+
+.. _logical-select-drilldowns-label-columns-name-type:
+
+``drilldowns[${LABEL}].columns[${NAME}].type``
+""""""""""""""""""""""""""""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`logical-select-columns-name-type` in main
+search.
+
+This is a required parameter.
+
+Here is an example that creates a ``ShortText`` type column. Stored
+value is casted to ``ShortText`` automatically. In this example,
+number is casted to ``ShortText``:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/drilldowns_label_columns_name_type.log
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --limit 0 \
+..   --output_columns _id \
+..   --drilldowns[tag].keys tag \
+..   --drilldowns[tag].columns[nsubrecs_string].stage initial \
+..   --drilldowns[tag].columns[nsubrecs_string].type ShortText \
+..   --drilldowns[tag].columns[nsubrecs_string].value _nsubrecs \
+..   --drilldowns[tag].output_columns _key,_nsubrecs,nsubrecs_string
+
+.. _logical-select-drilldowns-label-columns-name-value:
+
+``drilldowns[${LABEL}].columns[${NAME}].value``
+"""""""""""""""""""""""""""""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`logical-select-columns-name-value` in main
+search.
+
+This is a required parameter.
+
+Here is an example that creates a new dynamic column that stores the
+number of characters of content. This example uses
+:doc:`/reference/functions/string_length` function in
+``functions/string`` plugin to compute the number of characters in a
+string. :doc:`plugin_register` is used to register
+``functions/string`` plugin:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/drilldowns_label_columns_name_value.log
+.. plugin_register functions/string \
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --limit 0 \
+..   --output_columns _id \
+..   --drilldowns[tag].keys tag \
+..   --drilldowns[tag].columns[tag_length].stage initial \
+..   --drilldowns[tag].columns[tag_length].type UInt32 \
+..   --drilldowns[tag].columns[tag_length].value 'string_length(_key)' \
+..   --drilldowns[tag].output_columns _key,tag_length
+
+.. _logical-select-drilldowns-label-columns-name-window-sort-keys:
+
+``drilldowns[${LABEL}].columns[${NAME}].window.sort_keys``
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`logical-select-columns-name-window-sort-keys` in
+main search.
+
+You must specify
+:ref:`logical-select-drilldowns-label-columns-name-window-sort-keys`
+or
+:ref:`logical-select-drilldowns-label-columns-name-window-group-keys`
+to use window function.
+
+Here is an example that computes the Nth record in the number of sub
+records order:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/drilldowns_label_columns_name_window_sort_keys.log
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --limit 0 \
+..   --output_columns _id \
+..   --drilldowns[tag].keys tag \
+..   --drilldowns[tag].columns[record_number].stage initial \
+..   --drilldowns[tag].columns[record_number].type UInt32 \
+..   --drilldowns[tag].columns[record_number].value 'window_record_number()' \
+..   --drilldowns[tag].columns[record_number].window.sort_keys _nsubrecs,_key \
+..   --drilldowns[tag].sort_keys record_number \
+..   --drilldowns[tag].output_columns _key,_nsubrecs,record_number
+
+.. _logical-select-drilldowns-label-columns-name-window-group-keys:
+
+``drilldowns[${LABEL}].columns[${NAME}].window.group_keys``
+"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+
+.. versionadded:: 7.0.1
+
+Corresponds to :ref:`logical-select-columns-name-window-group-keys` in
+main search.
+
+You must specify
+:ref:`logical-select-drilldowns-label-columns-name-window-sort-keys`
+or
+:ref:`logical-select-drilldowns-label-columns-name-window-group-keys`
+to use window function.
+
+Here is an example that computes the Nth record ordered by tag name
+for each the same number of sub records:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_select/drilldowns_label_columns_name_window_group_keys.log
+.. logical_select \
+..   --logical_table Entries \
+..   --shard_key created_at \
+..   --limit 0 \
+..   --output_columns _id \
+..   --drilldowns[tag].keys tag \
+..   --drilldowns[tag].columns[record_number].stage initial \
+..   --drilldowns[tag].columns[record_number].type UInt32 \
+..   --drilldowns[tag].columns[record_number].value 'window_record_number()' \
+..   --drilldowns[tag].columns[record_number].window.sort_keys _key \
+..   --drilldowns[tag].columns[record_number].window.group_keys _nsubrecs \
+..   --drilldowns[tag].sort_keys _nsubrecs,record_number \
+..   --drilldowns[tag].output_columns _key,_nsubrecs,record_number
+
 Return value
 ------------