null+****@clear*****
null+****@clear*****
2010年 7月 13日 (火) 12:23:26 JST
Kouhei Sutou 2010-07-13 03:23:26 +0000 (Tue, 13 Jul 2010)
New Revision: 7ee92ad5a093d6b99db1facf3253cb3e09e8f3c9
Log:
add a document for check command.
Added files:
doc/ja/source/commands/check.txt
Added: doc/ja/source/commands/check.txt (+152 -0) 100644
===================================================================
--- /dev/null
+++ doc/ja/source/commands/check.txt 2010-07-13 03:23:26 +0000 (0ffdd84)
@@ -0,0 +1,152 @@
+.. highlightlang:: none
+
+check
+=====
+
+名前
+----
+
+check - オブジェクトの状態表示
+
+書式
+----
+::
+
+ check obj
+
+説明
+----
+
+groonga組込コマンドの一つであるcheckについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+
+checkコマンドは、groongaプロセス内の指定したオブジェクトの状態を表示します。主にデータベースが壊れた場合など異常時の問題解決のために使用することを想定しています。デバッグ用のため、返値のフォーマットが安定しているということは保証されません。（フォーマットが変更される可能性が高い）
+
+引数
+----
+
+``obj``
+
+ 状態を表示するオブジェクトの名前を指定します。
+
+返値
+----
+
+json形式
+^^^^^^^^
+
+チェックするオブジェクトにより返される値が変わります。
+
+インデックスカラムの場合::
+
+ 下記の項目がハッシュ形式で出力されます。
+
+ ``flags``
+
+ 指定されているフラグ値です。16進数で表現されています。
+
+ ``max sid``
+
+ セグメントのうち最も大きなIDです。
+
+ ``number of garbage segments``
+
+ ゴミセグメントの数です。
+
+ ``number of array segments``
+
+ 配列セグメントの数です。
+
+ ``max id of array segment``
+
+ 配列セグメントのうち最も大きなIDです。
+
+ ``number of buffer segments``
+
+ バッファセグメントの数です。
+
+ ``max id of buffer segment``
+
+ バッファセグメントのうち最も大きなIDです。
+
+ ``max id of physical segment in use``
+
+ 使用中の論理セグメントのうち最も大きなIDです。
+
+ ``number of unmanaged segments``
+
+ 管理されていないセグメントの数です。
+
+ ``total chunk size``
+
+ チャンクサイズの合計です。
+
+
+ ``max id of chunk segments in use``
+
+ 使用中のチャンクセグメントのうち最も大きなIDです。
+
+ ``number of garbage chunk``
+
+ 各チャンク毎のゴミの数です。
+
+ ``buffer id``
+
+ バッファIDです。
+
+ ``chunk size``
+
+ チャンクのサイズです。
+
+ ``buffer term``
+
+ バッファ内にある語の一覧です。
+
+ ``buffer free``
+
+ バッファの空き容量です。
+
+ ``size in buffer``
+
+ バッファの使用量です。
+
+ ``nterms``
+
+ バッファ内にある語の数です。
+
+ ``nterms with chunk``
+
+ バッファ内にある語のうち、チャンクを使っている語の数です。
+
+例
+--
+
+テーブルTermsのインデックスカラムnameの状態を表示します。::
+
+ check Terms.name
+ {"flags":"00008202",
+ "max sid":1,
+ "number of garbage segments":0,
+ "number of array segments":1,
+ "max id of array segment":1,
+ "number of buffer segments":110,
+ "max id of buffer segment":111,
+ "max id of physical segment in use":111,
+ "number of unmanaged segments":4294967185,
+ "total chunk size":7470239,
+ "max id of chunk segments in use":127,
+ "number of garbage chunk":[0,0,0,0,0,0,0,0,2,2,0,0,0,0,0],
+ "buffer id":0,
+ "chunk size":94392,
+ "buffer term":["596","59777","6",...],
+ "buffer free":152944,
+ "size in buffer":7361,
+ "nterms":237,
+ "nterms with chunk":216,
+ "buffer id":1,
+ "chunk size":71236,
+ "buffer term":["に述","に追","に退",...],
+ "buffer free":120000,
+ "size in buffer":11155,
+ "nterms":121,
+ "nterms with chunk":116,
+ ...}