Yasuhiro Horimoto 2019-05-17 12:05:03 +0900 (Fri, 17 May 2019) Revision: 2c53a1dea83fae8c7b94f6a1aba23bf91f1da521 https://github.com/groonga/groonga/commit/2c53a1dea83fae8c7b94f6a1aba23bf91f1da521 Message: doc object_inspect: add the explanation of new statistics (#947) * doc object_inspect: add the explanation of new statistics * doc object_inspect: simplify * doc object_inspect: add the explanation of "INDEX_COLUMN_VALUE_STATISTICS_N_PHYSICAL_SEGMENTS" Modified files: doc/locale/ja/LC_MESSAGES/reference.po doc/source/reference/commands/object_inspect.rst Modified: doc/locale/ja/LC_MESSAGES/reference.po (+53 -31) =================================================================== --- doc/locale/ja/LC_MESSAGES/reference.po 2019-05-17 11:59:51 +0900 (d6331dbd9) +++ doc/locale/ja/LC_MESSAGES/reference.po 2019-05-17 12:05:03 +0900 (9f099d715) @@ -10681,25 +10681,13 @@ msgstr "" "インデックスカラムは使われなくなったセグメント（内部で確保している領域）を再" "利用します。このセグメントのことを「ゴミセグメント」と呼びます。" -msgid "The max value is the max number of segments. It depends on index size:" -msgstr "" -"最大値は最大セグメント数です。最大セグメント数はインデックスサイズに依りま" -"す。" - -msgid "The max number of segments" -msgstr "最大セグメント数" - -msgid "``2**9`` (512)" -msgstr "" - -msgid "``2**16`` (65536)" -msgstr "" - -msgid "``2**17 * 2`` (262144)" -msgstr "" - -msgid "``2**17`` (131072)" +msgid "" +"The max value is the max number of segments. See :ref:`object-inspect-return-" +"value-index-column-value-statistics-n-physical-segments` for the max number " +"of segments." msgstr "" +"最大値は最大セグメント数です。最大セグメント数は :ref:`object-inspect-return-" +"value-index-column-value-statistics-n-physical-segments` を見てください。" msgid "``INDEX_COLUMN_VALUE_STATISTICS_MAX_ARRAY_SEGMENT_ID``" msgstr "" @@ -10712,15 +10700,6 @@ msgstr "" msgid "\"array\" is used for managing \"buffer\"." msgstr "「array」は「buffer」を管理するために使っています。" -msgid "" -"The max value is the max number of segments. See :ref:`object-inspect-return-" -"value-index-column-value-statistics-n-garbage-segments` for the max number " -"of segments." -msgstr "" -"この値の最大値は最大セグメント数です。最大セグメント数は :ref:`object-" -"inspect-return-value-index-column-value-statistics-n-garbage-segments` を見て" -"ください。" - msgid "``INDEX_COLUMN_VALUE_STATISTICS_N_ARRAY_SEGMENTS``" msgstr "" @@ -10731,11 +10710,11 @@ msgstr "調査対象のインデックスカラム内の「array」に使って msgid "" "The max value is ``the max number of segments - the number of segments used " "for \"buffer\"``. See :ref:`object-inspect-return-value-index-column-value-" -"statistics-n-garbage-segments` for the max number of segments." +"statistics-n-physical-segments` for the max number of segments." msgstr "" "最大値は ``最大セグメント数 - 「buffer」に使っているセグメント数`` です。最大" "セグメント数は :ref:`object-inspect-return-value-index-column-value-" -"statistics-n-garbage-segments` を見てください。" +"statistics-n-physical-segments` を見てください。" msgid "``INDEX_COLUMN_VALUE_STATISTICS_MAX_BUFFER_SEGMENT_ID``" msgstr "" @@ -10759,11 +10738,11 @@ msgstr "" msgid "" "The max value is ``the max number of segments - the number of segments used " "for \"array\"``. See :ref:`object-inspect-return-value-index-column-value-" -"statistics-n-garbage-segments` for the max number of segments." +"statistics-n-physical-segments` for the max number of segments." msgstr "" "最大値は ``最大セグメント数 - 「array」に使っているセグメント数`` です。最大" "セグメント数は :ref:`object-inspect-return-value-index-column-value-" -"statistics-n-garbage-segments` を見てください。" +"statistics-n-physical-segments` を見てください。" msgid "``INDEX_COLUMN_VALUE_STATISTICS_MAX_IN_USE_PHYSICAL_SEGMENT_ID``" msgstr "" @@ -10868,6 +10847,49 @@ msgstr "" "各領域の最大値は最大チャンク数です。最大チャンク数は :ref:`object-inspect-" "return-value-index-column-value-statistics-total-chunk-size` を見てください。" +msgid "``INDEX_COLUMN_VALUE_STATISTICS_NEXT_PHYSICAL_SEGMENT_ID``" +msgstr "" + +msgid "" +"This value is the ID of the segment. The inspected index column use it as " +"the next segment ID. The max value is the max number of segments. See :ref:" +"`object-inspect-return-value-index-column-value-statistics-n-physical-" +"segments` for the max number of segments." +msgstr "" +"この値は、調査対象のインデックスカラムが次に使うセグメントIDです。最大値は最" +"大セグメント数です。最大セグメント数は :ref:`object-inspect-return-value-" +"index-column-value-statistics-n-physical-segments` を見てください。" + +msgid "``INDEX_COLUMN_VALUE_STATISTICS_N_PHYSICAL_SEGMENTS``" +msgstr "" + +msgid "This value the max number of segments. It depends on index size:" +msgstr "" +"この値は、最大セグメント数です。最大セグメント数はインデックスサイズに依りま" +"す。" + +msgid "The max number of segments" +msgstr "最大セグメント数" + +msgid "``2**9`` (512)" +msgstr "" + +msgid "``2**16`` (65536)" +msgstr "" + +msgid "``2**17 * 2`` (262144)" +msgstr "" + +msgid "``2**17`` (131072)" +msgstr "" + +msgid "" +"If the number of segments tend to exceeds near the future, you need to " +"consider to adopt ``INDEX_XXX`` flags." +msgstr "" +"近い将来、セグメント数を超過する傾向がある場合は、 ``INDEX_XXX`` フラグの採用" +"を検討する必要があります。" + msgid "``INDEX_COLUMN_SOURCE_ID``" msgstr "" Modified: doc/source/reference/commands/object_inspect.rst (+47 -20) =================================================================== --- doc/source/reference/commands/object_inspect.rst 2019-05-17 11:59:51 +0900 (1939194aa) +++ doc/source/reference/commands/object_inspect.rst 2019-05-17 12:05:03 +0900 (5bf0e6278) @@ -356,6 +356,8 @@ Index column returns the following information:: "total_chunk_size": INDEX_COLUMN_VALUE_STATISTICS_TOTAL_CHUNK_SIZE, "max_in_use_chunk_id": INDEX_COLUMN_VALUE_STATISTICS_MAX_IN_USE_CHUNK_ID, "n_garbage_chunks": INDEX_COLUMN_VALUE_STATISTICS_N_GARBAGE_CHUNKS + "next_physical_segment_id": INDEX_COLUMN_VALUE_STATISTICS_NEXT_PHYSICAL_SEGMENT_ID + "max_n_physical_segments": INDEX_COLUMN_VALUE_STATISTICS_N_PHYSICAL_SEGMENTS } }, "sources": [ @@ -590,21 +592,9 @@ The number of garbage segments in the inspected index column. Index column reuses segment (internal allocated space) that is no longer used. It's called "garbage segment". -The max value is the max number of segments. It depends on index size: - -.. list-table:: - :header-rows: 1 - - * - Index column size - - The max number of segments - * - ``INDEX_SMALL`` - - ``2**9`` (512) - * - ``INDEX_MEDIUM`` - - ``2**16`` (65536) - * - ``INDEX_LARGE`` - - ``2**17 * 2`` (262144) - * - Default - - ``2**17`` (131072) +The max value is the max number of segments. See +:ref:`object-inspect-return-value-index-column-value-statistics-n-physical-segments` +for the max number of segments. .. _object-inspect-return-value-index-column-value-statistics-max-array-segment-id: @@ -616,7 +606,7 @@ The max ID of segment used for "array" in the inspected index column. "array" is used for managing "buffer". The max value is the max number of segments. See -:ref:`object-inspect-return-value-index-column-value-statistics-n-garbage-segments` +:ref:`object-inspect-return-value-index-column-value-statistics-n-physical-segments` for the max number of segments. .. _object-inspect-return-value-index-column-value-statistics-n-array-segments: @@ -630,7 +620,7 @@ The number of segments used for "array" in the inspected index column. The max value is ``the max number of segments - the number of segments used for "buffer"``. See -:ref:`object-inspect-return-value-index-column-value-statistics-n-garbage-segments` +:ref:`object-inspect-return-value-index-column-value-statistics-n-physical-segments` for the max number of segments. .. _object-inspect-return-value-index-column-value-statistics-max-buffer-segment-id: @@ -643,7 +633,7 @@ The max ID of segment used for "buffer" in the inspected index column. "buffer" is used for storing posting lists. The max value is the max number of segments. See -:ref:`object-inspect-return-value-index-column-value-statistics-n-garbage-segments` +:ref:`object-inspect-return-value-index-column-value-statistics-n-physical-segments` for the max number of segments. .. _object-inspect-return-value-index-column-value-statistics-n-buffer-segments: @@ -657,7 +647,7 @@ The number of segments used for "buffer" in the inspected index column. The max value is ``the max number of segments - the number of segments used for "array"``. See -:ref:`object-inspect-return-value-index-column-value-statistics-n-garbage-segments` +:ref:`object-inspect-return-value-index-column-value-statistics-n-physical-segments` for the max number of segments. .. _object-inspect-return-value-index-column-value-statistics-max-in-use-physical-segment-id: @@ -669,7 +659,7 @@ The max segment ID in use as "garbage", "array" or "buffer" in the inspected index column. The max value is the max number of segments. See -:ref:`object-inspect-return-value-index-column-value-statistics-n-garbage-segments` +:ref:`object-inspect-return-value-index-column-value-statistics-n-physical-segments` for the max number of segments. .. _object-inspect-return-value-index-column-value-statistics-n-unmanaged-segments: @@ -747,6 +737,43 @@ The max value of each space is the max number of chunks. See :ref:`object-inspect-return-value-index-column-value-statistics-total-chunk-size` for the max number of chunks. +.. _object-inspect-return-value-index-column-value-statistics-next-physical-segment-id: + +``INDEX_COLUMN_VALUE_STATISTICS_NEXT_PHYSICAL_SEGMENT_ID`` +"""""""""""""""""""""""""""""""""""""""""""""""""""""""""" + +.. versionadded:: 9.0.2 + +This value is the ID of the segment. The inspected index column use it as the next segment ID. +The max value is the max number of segments. See +:ref:`object-inspect-return-value-index-column-value-statistics-n-physical-segments` +for the max number of segments. + +.. _object-inspect-return-value-index-column-value-statistics-n-physical-segments: + +``INDEX_COLUMN_VALUE_STATISTICS_N_PHYSICAL_SEGMENTS`` +""""""""""""""""""""""""""""""""""""""""""""""""""""" + +.. versionadded:: 9.0.2 + +This value the max number of segments. It depends on index size: + +.. list-table:: + :header-rows: 1 + + * - Index column size + - The max number of segments + * - ``INDEX_SMALL`` + - ``2**9`` (512) + * - ``INDEX_MEDIUM`` + - ``2**16`` (65536) + * - ``INDEX_LARGE`` + - ``2**17 * 2`` (262144) + * - Default + - ``2**17`` (131072) + +If the number of segments tend to exceeds near the future, you need to consider to adopt ``INDEX_XXX`` flags. + .. _object-inspect-return-value-index-column-source-id: ``INDEX_COLUMN_SOURCE_ID`` -------------- next part -------------- An HTML attachment was scrubbed... URL: <https://lists.osdn.me/mailman/archives/groonga-commit/attachments/20190517/02c6389a/attachment-0001.html>
