YUKI Hiroshi
null+****@clear*****
Fri Dec 27 19:21:51 JST 2013
YUKI Hiroshi 2013-12-27 19:21:51 +0900 (Fri, 27 Dec 2013) New Revision: eae0d4d8cb245f1bb90b1490c4ee043a02096f5b https://github.com/droonga/droonga.org/commit/eae0d4d8cb245f1bb90b1490c4ee043a02096f5b Message: Update descriptions of known issue around grouping for Droonga 0.8 Modified files: _po/ja/reference/commands/search/index.po ja/reference/commands/search/index.md reference/commands/search/index.md Modified: _po/ja/reference/commands/search/index.po (+27 -40) =================================================================== --- _po/ja/reference/commands/search/index.po 2013-12-27 19:11:14 +0900 (86c1b1d) +++ _po/ja/reference/commands/search/index.po 2013-12-27 19:21:51 +0900 (c85e169) @@ -720,16 +720,6 @@ msgstr "" msgid "See [`groupBy` parameters](#query-groupBy) for more details." msgstr "詳細は [`groupBy` パラメータの仕様](#query-groupBy) を参照して下さい。" -msgid "" -"*Note: The version {{ site.droonga_version }} doesn't support grouping of sear" -"ch results from partitioned datasets. You should use this feature only on sing" -"le partition datasets, while you are using the version {{ site.droonga_version" -" }}." -msgstr "" -"※註:バージョン {{ site.droonga_version }} では、複数パーティションに別れたデータセットでの検索結果を集約した場合、集約結果に同" -"一キーのレコードが複数登場することがあります(パーティションごとの集約結果のマージ処理が未実装であるため)。バージョン {{ site.droonga_ve" -"rsion }} では、この機能はパーティション分けを伴わないデータセットでのみの利用を推奨します。" - msgid "#### Multiple search queries in one request {#usage-multiple-queries}" msgstr "#### 複数の検索クエリの列挙 {#usage-multiple-queries}" @@ -975,6 +965,13 @@ msgstr "" "値\n" ": 個々の検索クエリの名前をキー、[個々の検索クエリ](#query-parameters)の内容を値としたハッシュ。" +msgid "" +"Default value\n" +": Nothing. This is a required parameter." +msgstr "" +"省略時の既定値\n" +": なし。このパラメータは必須です。" + msgid "You can put multiple search queries in a `search` request." msgstr "`search` は、複数の検索クエリを一度に受け取る事ができます。" @@ -1007,13 +1004,6 @@ msgstr "" ": テーブル名の文字列、または結果を参照する別の検索クエリの名前の文字列。" msgid "" -"Default value\n" -": Nothing. This is a required parameter." -msgstr "" -"省略時の既定値\n" -": なし。このパラメータは必須です。" - -msgid "" "You can do a facet search, specifying a name of another search query as its so" "urce." msgstr "別の検索クエリの処理結果をデータソースとして指定する事により、ファセット検索などを行う事ができます。" @@ -1439,17 +1429,6 @@ msgid "" "as the result, for following operations and the output." msgstr "集約条件を指定した場合、指定に基づいてレコードを集約した結果がレコードとして取り出され、その後の処理に使われます。" -msgid "" -"*Note: On the version {{ site.droonga_version }}, grouping of search results f" -"rom a partitioned dataset possibly include multiple records with a same key, b" -"ecause merging of search results from partitioned dataset is not implemented y" -"et. So you should use this feature only on datasets without partitionings, on " -"the version {{ site.droonga_version }}." -msgstr "" -"※註:バージョン {{ site.droonga_version }} では、複数パーティションに別れたデータセットでの検索結果を集約した場合、集約結果に同" -"一キーのレコードが複数登場することがあります(パーティションごとの集約結果のマージ処理が未実装であるため)。バージョン {{ site.droonga_ve" -"rsion }} では、この機能はパーティション分けを伴わないデータセットでのみの利用を推奨します。" - msgid "##### Basic condition of grouping {#query-groupBy-string}" msgstr "##### 基本的な集約条件の指定 {#query-groupBy-string}" @@ -1531,25 +1510,33 @@ msgid " This parameter is optional, the default value is `0`." msgstr " このパラメータは省略可能で、省略時の既定値は `0` です。" msgid "" -"For example, this condition will return results grouped by their `job` column " -"with one sample record per a grouped result:" +" For example, this condition will return results grouped by their `job` colum" +"n with one sample record per a grouped result:" msgstr "" -"例えば以下は、`job` カラムの値でレコードを集約した結果について、各 `job` カラムの値を含んでいるレコードを代表として1件ずつ取り出すという意味に" -"なります。" +" 例えば以下は、`job` カラムの値でレコードを集約した結果について、各 `job` カラムの値を含んでいるレコードを代表として1件ずつ取り出すという意" +"味になります。" msgid "" -" {\n" -" \"key\" : \"job\",\n" -" \"maxNSubRecords\" : 1\n" -" }" +" {\n" +" \"key\" : \"job\",\n" +" \"maxNSubRecords\" : 1\n" +" }" +msgstr "" + +msgid "" +" Grouped results will have all columns of [the result of the basic conditions" +" for grouping](#query-groupBy-string), and following extra columns:" msgstr "" +" 集約結果のレコードは、[基本的な集約条件の指定](#query-groupBy-string)の集約結果のレコード群が持つすべてのカラムに加えて、以下の" +"カラムを持ちます。" msgid "" -"Grouped results will have all columns of [the result of the basic conditions f" -"or grouping](#query-groupBy-string), and following extra columns:" +" *Note: On the version {{ site.droonga_version }}, too many records can be re" +"turned larger than the specified `maxNSubRecords`, if the dataset has multiple" +" partitions. This is a known problem and to be fixed in a future version." msgstr "" -"集約結果のレコードは、[基本的な集約条件の指定](#query-groupBy-string)の集約結果のレコード群が持つすべてのカラムに加えて、以下のカラ" -"ムを持ちます。" +" ※バージョン {{ site.droonga_version }} では、データセットが複数のパーティションに別れている場合、集約前のレコードの代表が " +"`maxNSubRecords` で指定した数よりも多く返される場合があります。これは既知の問題で、将来のバージョンで修正される予定です。" msgid "" "`_subrecs`\n" Modified: ja/reference/commands/search/index.md (+11 -13) =================================================================== --- ja/reference/commands/search/index.md 2013-12-27 19:11:14 +0900 (05ec8dc) +++ ja/reference/commands/search/index.md 2013-12-27 19:21:51 +0900 (3940305) @@ -477,8 +477,6 @@ Personテーブル(主キーあり): 詳細は [`groupBy` パラメータの仕様](#query-groupBy) を参照して下さい。 -※註:バージョン {{ site.droonga_version }} では、複数パーティションに別れたデータセットでの検索結果を集約した場合、集約結果に同一キーのレコードが複数登場することがあります(パーティションごとの集約結果のマージ処理が未実装であるため)。バージョン {{ site.droonga_version }} では、この機能はパーティション分けを伴わないデータセットでのみの利用を推奨します。 - #### 複数の検索クエリの列挙 {#usage-multiple-queries} @@ -878,8 +876,6 @@ Droongaはまず最初に指定したカラムの値でレコードをソート 集約条件を指定した場合、指定に基づいてレコードを集約した結果がレコードとして取り出され、その後の処理に使われます。 -※註:バージョン {{ site.droonga_version }} では、複数パーティションに別れたデータセットでの検索結果を集約した場合、集約結果に同一キーのレコードが複数登場することがあります(パーティションごとの集約結果のマージ処理が未実装であるため)。バージョン {{ site.droonga_version }} では、この機能はパーティション分けを伴わないデータセットでのみの利用を推奨します。 - ##### 基本的な集約条件の指定 {#query-groupBy-string} 基本的な集約条件では、処理対象のレコード群が持つカラムの名前を文字列として指定します。 @@ -915,15 +911,17 @@ Droongaはそのカラムの値が同じであるレコードを集約し、カ `-1` は指定できません。 このパラメータは省略可能で、省略時の既定値は `0` です。 - -例えば以下は、`job` カラムの値でレコードを集約した結果について、各 `job` カラムの値を含んでいるレコードを代表として1件ずつ取り出すという意味になります。 - - { - "key" : "job", - "maxNSubRecords" : 1 - } - -集約結果のレコードは、[基本的な集約条件の指定](#query-groupBy-string)の集約結果のレコード群が持つすべてのカラムに加えて、以下のカラムを持ちます。 + + 例えば以下は、`job` カラムの値でレコードを集約した結果について、各 `job` カラムの値を含んでいるレコードを代表として1件ずつ取り出すという意味になります。 + + { + "key" : "job", + "maxNSubRecords" : 1 + } + + 集約結果のレコードは、[基本的な集約条件の指定](#query-groupBy-string)の集約結果のレコード群が持つすべてのカラムに加えて、以下のカラムを持ちます。 + + ※バージョン {{ site.droonga_version }} では、データセットが複数のパーティションに別れている場合、集約前のレコードの代表が `maxNSubRecords` で指定した数よりも多く返される場合があります。これは既知の問題で、将来のバージョンで修正される予定です。 `_subrecs` : 集約前のレコード群における、集約対象のカラムの値が一致するレコードの配列。 Modified: reference/commands/search/index.md (+11 -13) =================================================================== --- reference/commands/search/index.md 2013-12-27 19:11:14 +0900 (f2c6da6) +++ reference/commands/search/index.md 2013-12-27 19:21:51 +0900 (044a982) @@ -475,8 +475,6 @@ You can also extract the ungrouped record by the `maxNSubRecords` parameter and See [`groupBy` parameters](#query-groupBy) for more details. -*Note: The version {{ site.droonga_version }} doesn't support grouping of search results from partitioned datasets. You should use this feature only on single partition datasets, while you are using the version {{ site.droonga_version }}. - #### Multiple search queries in one request {#usage-multiple-queries} @@ -872,8 +870,6 @@ Default value If a condition for grouping is given, then grouped result records will appear as the result, for following operations and the output. -*Note: On the version {{ site.droonga_version }}, grouping of search results from a partitioned dataset possibly include multiple records with a same key, because merging of search results from partitioned dataset is not implemented yet. So you should use this feature only on datasets without partitionings, on the version {{ site.droonga_version }}. - ##### Basic condition of grouping {#query-groupBy-string} A condition of grouping is given as a string of a column name or an expression. @@ -907,15 +903,17 @@ A condition of grouping can include more options, like: : An integer, meaning maximum number of sample records included into each grouped result. Possible values are `0` or larger. `-1` is not acceptable. This parameter is optional, the default value is `0`. - -For example, this condition will return results grouped by their `job` column with one sample record per a grouped result: - - { - "key" : "job", - "maxNSubRecords" : 1 - } - -Grouped results will have all columns of [the result of the basic conditions for grouping](#query-groupBy-string), and following extra columns: + + For example, this condition will return results grouped by their `job` column with one sample record per a grouped result: + + { + "key" : "job", + "maxNSubRecords" : 1 + } + + Grouped results will have all columns of [the result of the basic conditions for grouping](#query-groupBy-string), and following extra columns: + + *Note: On the version {{ site.droonga_version }}, too many records can be returned larger than the specified `maxNSubRecords`, if the dataset has multiple partitions. This is a known problem and to be fixed in a future version. `_subrecs` : An array of sample records which have the value in its grouped column. -------------- next part -------------- HTML����������������������������... Download