Kouhei Sutou
null+****@clear*****
Tue Nov 7 09:45:56 JST 2017
Kouhei Sutou 2017-11-07 09:45:56 +0900 (Tue, 07 Nov 2017) New Revision: ed2d28bc741872544d748f6c5cf34897d6cdab00 https://github.com/groonga/groonga/commit/ed2d28bc741872544d748f6c5cf34897d6cdab00 Message: doc logical_range_filter: add more descriptions Modified files: doc/locale/ja/LC_MESSAGES/reference.po doc/source/reference/commands/logical_count.rst doc/source/reference/commands/logical_range_filter.rst Modified: doc/locale/ja/LC_MESSAGES/reference.po (+29 -29) =================================================================== --- doc/locale/ja/LC_MESSAGES/reference.po 2017-11-06 17:01:11 +0900 (28aa8b25b) +++ doc/locale/ja/LC_MESSAGES/reference.po 2017-11-07 09:45:56 +0900 (239355888) @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: 1.2.1\n" "Report-Msgid-Bugs-To: \n" -"PO-Revision-Date: 2017-11-06 16:57+0900\n" +"PO-Revision-Date: 2017-11-07 09:44+0900\n" "Last-Translator: Masafumi Yokoyama <yokoyama �� clear-code.com>\n" "Language-Team: Japanese\n" "Language: ja\n" @@ -7034,8 +7034,8 @@ msgid "" "Create parted tables which contains \"_YYYYMMDD\" postfix. It is hardcoded, " "so you must create tables by each day." msgstr "" -"名前の末尾は \"_YYYYMMDD\" をつけてテーブルを作成します。これは決め打ちになっ" -"ていて、日ごとにテーブルを作成しないといけない" +"名前の末尾は「_YYYYMMDD」をつけてテーブルを作成します。これは決め打ちになって" +"いて、日ごとにテーブルを作成しないといけない" msgid "Load proper data into parted tables on your own." msgstr "自分で個々のテーブルへ適切なデータをロードしないといけない" @@ -7087,8 +7087,8 @@ msgid "" "Let's count logs which contains \"Shutdown\" in ``message`` column and the " "value of timestamp is \"2015-02-04 00:00:00\" or later." msgstr "" -"``message`` カラムに \"Shutdown\" が含まれていて、 ``timestamp`` カラムの値" -"が \"2015-02-04 00:00:00\" 以降であるログをカウントしましょう。" +"``message`` カラムに「Shutdown」が含まれていて、 ``timestamp`` カラムの値が" +"「2015-02-04 00:00:00」以降であるログをカウントしましょう。" msgid "Here is the query to achieve above purpose." msgstr "上記目的を達成するためのクエリがこちらです。" @@ -7107,8 +7107,8 @@ msgid "" "\"_YYYYMMDD\" postfix in table name." msgstr "" "SQLの ``PARTITIONING BY`` のような便利なクエリはありません。つまり、 " -"``table_create`` で \"_YYYYMMDD\" を名前の末尾に含むテーブルをそれぞれの作ら" -"なければなりません。" +"``table_create`` で「_YYYYMMDD」を名前の末尾に含むテーブルをそれぞれの作らな" +"ければなりません。" msgid "This section describes parameters of ``logical_count``." msgstr "このセクションでは ``logical_count`` の引数について説明します。" @@ -7120,13 +7120,13 @@ msgid "``logical_table``" msgstr "" msgid "" -"Specifies logical table name. It means table name without \"_YYYYMMDD\" " -"postfix. If you use actual table such as \"Logs_20150203\", " -"\"Logs_20150203\" and so on, logical table name is \"Logs\"." +"Specifies logical table name. It means table name without ``_YYYYMMDD`` " +"postfix. If you use actual table such as ``Logs_20150203``, " +"``Logs_20150203`` and so on, logical table name is ``Logs``." msgstr "" -"論理テーブル名を指定します。これは \"_YYYYMMDD\" をテーブル名から除いたもので" -"す。実際のテーブルが \"Logs_20150203\" や \"Logs_20150203\" といったものな" -"ら、論理テーブル名は \"Logs\" です。" +"論理テーブル名を指定します。これは ``_YYYYMMDD`` をテーブル名から除いたもので" +"す。実際のテーブルが ``Logs_20150203`` や ``Logs_20150203`` といったものな" +"ら、論理テーブル名は ``Logs`` です。" msgid "``shard_key``" msgstr "" @@ -7326,6 +7326,14 @@ msgstr "" "ん。" msgid "" +"``logical_range_filter`` doesn't return the number of all matched records. " +"Because ``logical_range_filter`` may not search all matched records." +msgstr "" +"``logical_range_filter`` はマッチしたレコードの総数を返しません。なぜなら、 " +"``logical_range_filter`` はマッチするレコードをすべて検索しないかもしれないか" +"らです。" + +msgid "" "You need to :doc:`plugin_register` ``sharding`` plugin because this command " "is included in ``sharding`` plugin." msgstr "" @@ -7503,10 +7511,11 @@ msgstr "" msgid "" "If you use one or more dynamic columns, \"stop searching when enough records " -"are matched in a table\" feature is disabled. ``logical_range_filter`` " -"searches all matched records in a table even when requested the number of " -"matched records is small. It's for supporting window function. Running " -"window function requires all records in a table." +"are matched in a table\" feature is disabled. (\"Stop searching against rest " +"tables when enough records are matched\" is still enabled.) " +"``logical_range_filter`` searches all matched records in a table even when " +"requested the number of matched records is small. It's for supporting window " +"function. Running window function requires all target records in a table." msgstr "" "動的カラムを1つ以上使うと、「十分なレコードがマッチしたらそのテーブルの検索を" "切り上げる」機能が無効になります。（「十分なレコードがマッチしたら残りのテー" @@ -7638,9 +7647,9 @@ msgid "" "or :ref:`logical-range-filter-columns-name-window-group-keys` to use window " "function." msgstr "" -"ウィンドウ関数を使うには :ref:`logical-select-columns-name-window-sort-keys` " -"または :ref:`logical-range-filter-columns-name-window-group-keys` を指定しな" -"ければいけません。" +"ウィンドウ関数を使うには :ref:`logical-range-filter-columns-name-window-sort-" +"keys` または :ref:`logical-range-filter-columns-name-window-group-keys` を指" +"定しなければいけません。" msgid "" "Here is an example that computes cumulative sum per ``Entries.tag``. Each " @@ -8838,15 +8847,6 @@ msgstr "" msgid "This section describes parameters of ``logical_table_remove``." msgstr "このセクションでは ``logical_table_remove`` の引数について説明します。" -msgid "" -"Specifies logical table name. It means table name without ``_YYYYMMDD`` " -"postfix. If you use actual table such as ``Logs_20150203``, " -"``Logs_20150203`` and so on, logical table name is ``Logs``." -msgstr "" -"論理テーブル名を指定します。これは \"_YYYYMMDD\" をテーブル名から除いたもので" -"す。実際のテーブルが \"Logs_20150203\" や \"Logs_20150203\" といったものな" -"ら、論理テーブル名は \"Logs\" です。" - msgid "See also :ref:`logical-select-logical-table`." msgstr ":ref:`logical-select-logical-table` も参照してください。" Modified: doc/source/reference/commands/logical_count.rst (+4 -2) =================================================================== --- doc/source/reference/commands/logical_count.rst 2017-11-06 17:01:11 +0900 (ca4036efd) +++ doc/source/reference/commands/logical_count.rst 2017-11-07 09:45:56 +0900 (7f1ea02be) @@ -122,8 +122,10 @@ There are required parameters, ``logical_table`` and ``shard_key``. ``logical_table`` """"""""""""""""" -Specifies logical table name. It means table name without "_YYYYMMDD" postfix. -If you use actual table such as "Logs_20150203", "Logs_20150203" and so on, logical table name is "Logs". +Specifies logical table name. It means table name without +``_YYYYMMDD`` postfix. If you use actual table such as +``Logs_20150203``, ``Logs_20150203`` and so on, logical table name is +``Logs``. ``shard_key`` """"""""""""" Modified: doc/source/reference/commands/logical_range_filter.rst (+23 -19) =================================================================== --- doc/source/reference/commands/logical_range_filter.rst 2017-11-06 17:01:11 +0900 (8fd803055) +++ doc/source/reference/commands/logical_range_filter.rst 2017-11-07 09:45:56 +0900 (52671452e) @@ -34,6 +34,10 @@ requires all matched records. ``logical_range_filter`` may not find all matched records. So ``logical_range_filter`` doesn't support drilldown. +``logical_range_filter`` doesn't return the number of all matched +records. Because ``logical_range_filter`` may not search all matched +records. + You need to :doc:`plugin_register` ``sharding`` plugin because this command is included in ``sharding`` plugin. @@ -77,26 +81,26 @@ Here are parameters that can be only used as named parameters: * ``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`. + 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. + Parameters that have the same ``${NAME}`` are grouped. - For example, the following parameters specify one dynamic column: + For example, the following parameters specify one dynamic column: - * ``--columns[name].stage initial`` - * ``--columns[name].type UInt32`` - * ``--columns[name].value 29`` + * ``--columns[name].stage initial`` + * ``--columns[name].type UInt32`` + * ``--columns[name].value 29`` - The following parameters specify two dynamic columns: + 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'`` + * ``--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'`` Usage ----- @@ -213,8 +217,10 @@ There are required parameters, ``logical_table`` and ``shard_key``. ``logical_table`` """"""""""""""""" -Specifies logical table name. It means table name without "_YYYYMMDD" postfix. -If you use actual table such as "Logs_20150203", "Logs_20150203" and so on, logical table name is "Logs". +Specifies logical table name. It means table name without +``_YYYYMMDD`` postfix. If you use actual table such as +``Logs_20150203``, ``Logs_20150203`` and so on, logical table name is +``Logs``. TODO: Add examples @@ -531,8 +537,6 @@ Here are available values: - Cache the output of this query. It's the default value. -TODO: Add examples - Here is an example to disable caching the result of this query: .. groonga-command -------------- next part -------------- HTML����������������������������... URL: https://lists.osdn.me/mailman/archives/groonga-commit/attachments/20171107/bb3d23d7/attachment-0001.htm
