Kouhei Sutou
null+****@clear*****
Mon Jan 22 17:17:09 JST 2018
Kouhei Sutou 2018-01-22 17:17:09 +0900 (Mon, 22 Jan 2018) New Revision: c5a1345e74294fa5de09f383cdc0643cadf7b1f2 https://github.com/groonga/groonga/commit/c5a1345e74294fa5de09f383cdc0643cadf7b1f2 Message: doc logical_range_filter: document post_filter Added files: doc/source/example/reference/commands/logical_range_filter/post_filter.log Modified files: doc/locale/ja/LC_MESSAGES/reference.po doc/source/reference/commands/logical_range_filter.rst Modified: doc/locale/ja/LC_MESSAGES/reference.po (+49 -10) =================================================================== --- doc/locale/ja/LC_MESSAGES/reference.po 2018-01-22 16:46:47 +0900 (213447374) +++ doc/locale/ja/LC_MESSAGES/reference.po 2018-01-22 17:17:09 +0900 (a41f04a2b) @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: 1.2.1\n" "Report-Msgid-Bugs-To: \n" -"PO-Revision-Date: 2018-01-11 13:15+0900\n" +"PO-Revision-Date: 2018-01-22 17:16+0900\n" "Last-Translator: Masafumi Yokoyama <yokoyama �� clear-code.com>\n" "Language-Team: Japanese\n" "Language: ja\n" @@ -223,6 +223,12 @@ msgstr "" "Groongaを全文検索ライブラリとして使うことができます。この節ではGroongaが提供" "しているAPIを示します。" +msgid "パラメータ" +msgstr "" + +msgid "戻り値" +msgstr "" + msgid "Global configurations" msgstr "全体設定" @@ -4478,12 +4484,6 @@ msgstr "" "``HEADER`` については :doc:`/reference/command/output_format` を参照してくだ" "さい。" -msgid "" -"The number of kinds of index target data and the number of handleable " -"records in a small index column" -msgstr "" -"インデックス対象データの種類数と小さなインデックスカラムで扱えるレコード数" - msgid "``column_create``" msgstr "" @@ -5023,6 +5023,12 @@ msgstr "" "``2`` と ``3`` ）になります。以下の表はインデックス対象データの種類数と扱える" "最大レコード数の関係を示しています。" +msgid "" +"The number of kinds of index target data and the number of handleable " +"records in a small index column" +msgstr "" +"インデックス対象データの種類数と小さなインデックスカラムで扱えるレコード数" + msgid "The number of kinds of index target data" msgstr "インデックス対象のデータの種類数" @@ -7809,6 +7815,39 @@ msgstr "" msgid "``order``" msgstr "" +msgid "``post_filter``" +msgstr "" + +msgid "" +"Specifies the filter text that is processed after ``filtered`` stage dynamic " +"columns are generated. You can use ``post_filter`` to filter by ``filtered`` " +"stage dynamic columns. Others are the same as :ref:`logical-range-filter-" +"filter`." +msgstr "" +"``filtered`` ステージの動的カラムが生成されてから実行するフィルターを指定しま" +"す。 ``post_filter`` を使うと ``filtered`` ステージの動的カラムを使って絞り込" +"むことができます。他は :ref:`logical-range-filter-filter` と同じです。" + +msgid "" +"If you use ``post_filter``, \"stop searching when enough records are matched " +"in a table\" feature is disabled. (\"Stop searching against rest tables when " +"enough records are matched\" is still enabled.) Because ``post_filter`` " +"needs to wait dynamic columns generation. See also :ref:`logical-range-" +"filter-dynamic-column-related-parameters`." +msgstr "" +"``post_filter`` を使うと、「十分なレコードがマッチしたらそのテーブルの検索を" +"切り上げる」機能が無効になります。（「十分なレコードがマッチしたら残りのテー" +"ブルの検索を切り上げる」機能は有効です。）なぜなら ``post_filter`` は動的カラ" +"ムが生成されるのを待つ必要があるからです。 :ref:`logical-range-filter-" +"dynamic-column-related-parameters` も参照してください。" + +msgid "" +"Here is an example that shows entries only in popular tag. All target " +"entries have ``system`` or ``use`` words:" +msgstr "" +"以下は人気のあるタグのエントリーだけを表示する例です。対象となるすべてのエン" +"トリーには ``system`` または ``use`` という単語が含まれています。" + msgid "Output related parameters" msgstr "出力関連の引数" @@ -25788,9 +25827,6 @@ msgid "" "records are fetched." msgstr "" -msgid "Characteristics of all tables" -msgstr "全テーブルの特徴" - msgid "Tables" msgstr "テーブル" @@ -25824,6 +25860,9 @@ msgstr "" "以下はGroongaにあるすべてのテーブルの特性表です。（この表の中では ``TABLE_`` " "プレフィックスは省略しています。）" +msgid "Characteristics of all tables" +msgstr "全テーブルの特徴" + msgid "Item" msgstr "" Added: doc/source/example/reference/commands/logical_range_filter/post_filter.log (+45 -0) 100644 =================================================================== --- /dev/null +++ doc/source/example/reference/commands/logical_range_filter/post_filter.log 2018-01-22 17:17:09 +0900 (6661ee295) @@ -0,0 +1,45 @@ +Execution example:: + + logical_range_filter \ + --logical_table Entries \ + --shard_key created_at \ + --columns[n_likes_sum_per_tag].stage filtered \ + --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' \ + --filter 'content @ "system" || content @ "use"' \ + --post_filter 'n_likes_sum_per_tag > 10' \ + --output_columns _key,n_likes,n_likes_sum_per_tag + # [ + # [ + # 0, + # 1337566253.89858, + # 0.000355720520019531 + # ], + # [ + # [ + # [ + # "_key", + # "ShortText" + # ], + # [ + # "n_likes", + # "UInt32" + # ], + # [ + # "n_likes_sum_per_tag", + # "UInt32" + # ] + # ], + # [ + # "Groonga", + # 10, + # 25 + # ], + # [ + # "Mroonga", + # 15, + # 25 + # ] + # ] + # ] Modified: doc/source/reference/commands/logical_range_filter.rst (+40 -0) =================================================================== --- doc/source/reference/commands/logical_range_filter.rst 2018-01-22 16:46:47 +0900 (3577fe876) +++ doc/source/reference/commands/logical_range_filter.rst 2018-01-22 17:17:09 +0900 (6a785f500) @@ -61,6 +61,7 @@ The required parameters are ``logical_table`` and ``shard_key``:: [limit=10] [output_columns="_key, *"] [use_range_index=null] + [post_filter=null] There are some parameters that can be only used as named parameters. You can't use these parameters as ordered parameters. You @@ -279,11 +280,50 @@ Search related parameters This command provides :doc:`select` compatible search related parameters. +.. _logical-range-filter-filter: + ``filter`` """""""""" +Corresponds to :ref:`select-filter` in :doc:`select`. See +:ref:`select-filter` for details. + +Here is an example: + TODO +.. _logical-range-filter-post-filter: + +``post_filter`` +""""""""""""""" + +Specifies the filter text that is processed after ``filtered`` stage +dynamic columns are generated. You can use ``post_filter`` to filter +by ``filtered`` stage dynamic columns. Others are the same as +:ref:`logical-range-filter-filter`. + +If you use ``post_filter``, "stop searching when enough records are +matched in a table" feature is disabled. ("Stop searching against rest +tables when enough records are matched" is still enabled.) Because +``post_filter`` needs to wait dynamic columns generation. See also +:ref:`logical-range-filter-dynamic-column-related-parameters`. + +Here is an example that shows entries only in popular tag. All target +entries have ``system`` or ``use`` words: + +.. groonga-command +.. include:: ../../example/reference/commands/logical_range_filter/post_filter.log +.. logical_range_filter \ +.. --logical_table Entries \ +.. --shard_key created_at \ +.. --columns[n_likes_sum_per_tag].stage filtered \ +.. --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' \ +.. --filter 'content @ "system" || content @ "use"' \ +.. --post_filter 'n_likes_sum_per_tag > 10' \ +.. --output_columns _key,n_likes,n_likes_sum_per_tag + Output related parameters ^^^^^^^^^^^^^^^^^^^^^^^^^ -------------- next part -------------- HTML����������������������������... URL: https://lists.osdn.me/mailman/archives/groonga-commit/attachments/20180122/a6ae5349/attachment-0001.htm
