File: check.rst

package info (click to toggle)
groonga 9.0.0-1%2Bdeb10u1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 101,496 kB
  • sloc: ansic: 608,707; ruby: 35,042; xml: 23,643; cpp: 10,319; sh: 7,453; yacc: 5,968; python: 3,033; makefile: 2,609; perl: 133
file content (161 lines) | stat: -rw-r--r-- 4,295 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
.. -*- rst -*-

.. highlightlang:: none

``check``
=========

Summary
-------

check - オブジェクトの状態表示

Groonga組込コマンドの一つであるcheckについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。

checkコマンドは、groongaプロセス内の指定したオブジェクトの状態を表示します。主にデータベースが壊れた場合など異常時の問題解決のために使用することを想定しています。デバッグ用のため、返値のフォーマットが安定しているということは保証されません。(フォーマットが変更される可能性が高い)

Syntax
------
::

 check obj

Usage
-----

テーブル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":[["に述",18149,18149,2,25,6,6],
                  ["に追",4505,4505,76,485,136,174],
                  ["に退",26568,26568,2,9,2,2],
                  ...],
   "buffer free":120000,
   "size in buffer":11155,
   "nterms":121,
   "nterms with chunk":116},
   {"buffer id":1,
    ...},
   ...]

Parameters
----------

``obj``

  状態を表示するオブジェクトの名前を指定します。

Return value
------------

チェックするオブジェクトにより返される値が変わります。

インデックスカラムの場合::

  下記のような配列が出力されます。

    [インデックスの状態, バッファの状態1, バッファの状態2, ...]

``インデックスの状態`` には下記の項目がハッシュ形式で出力されます。

  ``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``

    バッファ内にある語の一覧です。各語の状態は以下のような配列となっています。

      [語, バッファに登録されている語のID, 用語集に登録されている語のID, バッファ内でのサイズ, チャンク内でのサイズ]

  ``buffer free``

    バッファの空き容量です。

  ``size in buffer``

    バッファの使用量です。

  ``nterms``

    バッファ内にある語の数です。

  ``nterms with chunk``

    バッファ内にある語のうち、チャンクを使っている語の数です。