[Groonga-commit] groonga/groonga at 2c53a1d [master] doc object_inspect: add the explanation of new statistics (#947)

Back to archive index
Yasuhiro Horimoto null+****@clear*****
Fri May 17 12:05:03 JST 2019


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>


More information about the Groonga-commit mailing list
Back to archive index