rroonga 0.9.5-x86-mingw32 → 1.0.1-x86-mingw32

data/vendor/local/share/groonga/doc/ja/source/commands/select.txt

@@ -0,0 +1,247 @@
+.. highlightlang:: none
+
+.. _select:
+
+select
+======
+
+名前
+----
+
+select - テーブルの中から条件にマッチするレコードを検索して出力する
+
+書式
+----
+::
+
+ select table [match_columns [query [filter [scorer [sortby [output_columns
+              [offset [limit [drilldown [drilldown_sortby [drilldown_output_columns
+              [drilldown_offset [drilldown_limit [cache]]]]]]]]]]]]]]
+
+説明
+----
+
+groonga組込コマンドの一つであるselectについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+
+selectは、使用しているデータベースのテーブルの中から条件にマッチするレコードを検索して出力します。
+
+引数
+----
+
+``table``
+
+  検索対象のテーブルを指定します。存在しないテーブルを指定した場合はエラーになります。
+
+``match_columns``
+
+  query引数に指定する検索条件文字列でデフォルトの検索対象となるカラムを指定します。
+
+    カラム名
+
+  カラム名の後ろに'* 数値'を指定することによって、そのカラムにヒットした際のスコアに積算される重みを指定することができます。
+
+    カラム名 * 重み
+
+  複数のカラムを'||'で結合して指定することもできます。
+
+    カラム名1 * 重み1 || カラム名2 * 重み2
+
+  また、カラム名ではなく、検索に使用するインデックス名を指定することもできます。
+
+``query``
+
+  以下の形式の文字列によって検索条件を指定します。
+
+条件式
+^^^^^^
+
+以下の条件式が使用できます。
+
+文字列
+  全文検索条件(デフォルト検索対象カラムの値が指定された文字列を含んでいる)
+
+\"文字列\"
+  フレーズ検索条件(デフォルト検索対象カラムの値が指定されたフレーズを含んでいる)
+
+カラム名:値
+  一致条件(カラム値 == 値)
+
+カラム名:!値
+  不一致条件(カラム値 != 値)
+
+カラム名:<値
+  比較条件(カラム値 < 値)
+
+カラム名:>値
+  比較条件(カラム値 > 値)
+
+カラム名:<=値
+  比較条件(カラム値 <= 値)
+
+カラム名:>=値
+  比較条件(カラム値 >= 値)
+
+カラム名:@文字列
+  全文検索条件(カラム値が指定された文字列を含んでいる)
+
+結合演算子
+^^^^^^^^^^
+
+複数の条件式を結合するために以下の演算子が使用できます。
+
+a OR b
+  論理和(aとbといずれかの条件がマッチする)
+
+a + b
+  論理積(aとbの両方がマッチする)
+
+a - b
+  aにマッチし、bにはマッチしない
+
+( )
+  複数の条件をまとめる
+
+
+``filter``
+
+  絞り込み条件をscript形式のgrn_expr文字列によって指定します。
+
+  query引数とfilter引数をどちらも指定した場合は、両方の条件を満足するレコードのみがヒットします。どちらも指定しない場合は全件がヒットします。
+
+``scorer``
+
+  検索条件にマッチする全てのレコードに対して適用するgrn_exprをscript形式で指定します。
+
+  scorerは、検索処理が完了し、ソート処理が実行される前に呼び出されます。従って、各レコードのスコアを操作する式を指定しておけば、検索結果のソート順序をカスタマイズできるようになります。
+
+``sortby``
+
+  ソートキーとなるカラム名のリストをカンマ(',')区切りで指定します。::
+
+    [-]カラム名1, [-]カラム名2, [-]カラム名3, ...
+
+  カラム名1の値でソートし、値が同一である場合はカラム名2でソート、と順次比較を行いソートします。カラム名の前に - を付加した場合は降順にソートします。付加しない場合には昇順にソートします。
+
+  query引数またはfilter引数を指定した場合はカラム名に'_score'を使えます。'_score'を指定することでスコアでソートすることができます。query引数もfilter引数も指定していない状態で'_score'を指定するとエラーになります。
+
+``output_columns``
+
+  出力するカラム名のリストをカンマ(',')区切りで指定します。
+
+  アスタリスク('*')を指定すると、全てのカラムが指定されたものとみなされます。または、script形式のgrn_expr文字列を指定します。 (デフォルトは、'_id, _key, \*')
+
+``offset``
+
+  検索条件にマッチしたレコードのうち、出力対象となる最初のレコードの番号を0ベースで指定します。デフォルト値は0です。offsetに負の値を指定した場合は、ヒットした件数 + offset によって算出される値が指定されたものとみなされます。
+
+``limit``
+
+  検索条件にマッチしたレコードのうち、出力を行うレコードの件数を指定します。デフォルト値は10です。実際には、offset + limit がヒットした件数を超えない範囲でレコードが出力されます。limitに負の値を指定した場合は、ヒットした件数 + limit + 1 によって算出される値が指定されたものとみなされます。
+
+``drilldown``
+
+  グループ化のキーとなるカラム名のリストをカンマ(',')区切りで指定します。検索条件にマッチした各レコードを出力したのちに、drilldownに指定されたカラムの値が同一であるレコードをとりまとめて、それぞれについて結果レコードを出力します。
+
+``drilldown_sortby``
+
+  drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、ソートキーとなるカラム名のリストをカンマ(',')区切りで指定します。sortbyパラメータと同様に昇降順を指定できます。
+
+``drilldown_output_columns``
+
+  drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力するカラム名のリストをカンマ(',')区切りで指定します。
+
+``drilldown_offset``
+
+  drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力対象となる最初のレコードの番号を0ベースで指定します。デフォルト値は0です。drilldown_offsetに負の値を指定した場合は、ヒットした件数 + drilldown_offsetによって算出される値が指定されたものとみなされます。
+
+``drilldown_limit``
+
+  drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力を行うレコードの件数を指定します。デフォルト値は10です。実際には、drilldown_offset + drilldown_limit がヒットした件数を超えない範囲でレコードが出力されます。drilldown_limitに負の値を指定した場合は、ヒットした件数 + drilldown_limit + 1 によって算出される値が指定されたものとみなされます。
+
+``cache``
+
+  クエリキャッシュに関する動作を設定します。
+
+    ``no``
+
+      検索結果をクエリキャッシュに残しません。キャッシュして再利用される可能性が低いクエリに対して用います。キャッシュ容量は有限です。有効なキャッシュが多くヒットするために、このパラメータは有効です。
+
+返値
+----
+
+以下のようなjson形式で値が返却されます。
+
+::
+
+ [[リターンコード, 処理開始時間, 処理時間], [検索結果, ドリルダウン結果]]
+
+``リターンコード``
+
+  grn_rcに対応する数値が返されます。0(GRN_SUCCESS)以外の場合は、続いてエラー内容を示す
+  文字列が返されます。
+
+``処理開始時間``
+
+  処理を開始した時間について、1970年1月1日0時0分0秒を起点とした秒数を小数で返します。
+
+``処理時間``
+
+  処理にかかった秒数を返します。
+
+``検索結果``
+
+  drilldown条件が実行される前の検索結果が以下のように出力されます。::
+
+    [[検索件数], [[カラム名1,カラム型1],..], 検索結果1,..]
+
+  ``検索件数``
+
+    検索件数が出力されます。
+
+  ``カラム名n``
+
+    output_columnsに指定された条件に従って、対象となるカラム名が出力されます。
+
+  ``カラム型n``
+
+    output_columnsに指定された条件に従って、対象となるカラム型が出力されます。
+
+  ``検索結果n``
+
+    output_columns, offset, limitによって指定された条件に従って各レコードの値が出力されます。
+
+``drilldown結果``
+
+  drilldown処理の結果が以下のように出力されます。::
+
+    [[[件数], [[カラム名1,カラム型1],..], 検索結果1,..],..]
+
+  ``件数``
+
+    drilldownに指定されたカラムの値の異なり数が出力されます。
+
+  ``カラム名n``
+
+    drilldown_output_columnsに指定された条件に従って、対象となるカラム名が出力されます。
+
+  ``カラム型n``
+
+    drilldown_output_columnsに指定された条件に従って、対象となるカラム型が出力されます。
+
+  ``ドリルダウン結果n``
+
+    drilldown_output_columns, drilldown_offset, drilldown_limitによって指定された条件に従って各レコードの値が出力されます。
+
+例
+--
+
+テーブルEntryの全レコード・全カラムの値を出力します。::
+
+ select Entry
+
+ [[[2],[["_id", "UInt32"],["_key","ShortText"],["body","ShortText"]],[1,"abandon","放棄する"],[2,"abbreviate","短縮する"]]]
+
+関連項目
+--------
+
+:doc:`../expr`

data/vendor/local/share/groonga/doc/ja/source/commands/shutdown.txt

@@ -0,0 +1,38 @@
+.. highlightlang:: none
+
+shutdown
+========
+
+名前
+----
+
+shutdown - サーバプロセスの停止
+
+書式
+----
+::
+
+ shutdown
+
+説明
+----
+
+groonga組込コマンドの一つであるshutdownについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+
+shutdownは、接続しているgroongaサーバプロセスを停止します。
+
+引数
+----
+
+ありません。
+
+返値
+----
+
+ありません。
+
+例
+--
+::
+
+ shutdown

data/vendor/local/share/groonga/doc/ja/source/commands/status.txt

@@ -0,0 +1,59 @@
+.. highlightlang:: none
+
+status
+======
+
+名前
+----
+
+status - groongaプロセスの状態表示
+
+書式
+----
+::
+
+ status
+
+説明
+----
+
+groonga組込コマンドの一つであるstatusについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+
+statusコマンドは、groongaプロセスの状態を表示します。主にgroongaサーバプロセスに対して使用することを想定しています。
+
+引数
+----
+
+ありません。
+
+返値
+----
+
+json形式
+^^^^^^^^
+
+::
+
+  下記の項目がハッシュ形式で出力されます。
+
+  ``alloc_count``
+
+    groongaプロセスの内部でアロケートされ、まだ解放されてないメモリブロックの数を示します。groongaをbuildする際に、configureオプションで --enable-exact-alloc-countが指定されていたならば、正確な値を返します。それ以外の場合は不正確な値を返す場合があります。
+
+  ``starttime``
+
+    groongaプロセスが起動した時刻のtvsec値を返します。
+
+  ``uptime``
+
+    groongaプロセスが起動してから経過した秒数を返します。
+
+例
+--
+
+::
+
+ status
+ {"alloc_count":104,
+  "starttime":1268213679,
+  "uptime":1}

data/vendor/local/share/groonga/doc/ja/source/commands/table_create.txt

@@ -0,0 +1,111 @@
+.. highlightlang:: none
+
+table_create
+============
+
+名前
+----
+
+table_create - テーブルの追加
+
+書式
+----
+::
+
+ table_create name [flags [key_type [value_type [default_tokenizer]]]]
+
+説明
+----
+
+groonga組込コマンドの一つであるtable_createについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+
+table_createコマンドは、使用しているデータベースに対してテーブルを追加します。groongaには名前付きテーブルと名前なしテーブル、永続テーブルと一時テーブルがありますが、table_createコマンドでは、名前付きの永続テーブルのみが作成できます。テーブルはレコードの集合であり、全てのレコードは一意なIDを持ちます。IDはレコードを追加した順序に従って自動的に付与されます。
+
+テーブルにカラムを追加する時にはcolumn_createコマンドを使用します。また、テーブルを作成した時点でいくつかの疑似カラムが使用可能になっています。
+
+引数
+----
+
+``name``
+
+  作成するテーブルの名前を指定します。nameはデータベース内で一意な、未定義の名前でなければなりません。組込型名・組込コマンド名・組込関数名は予約済みであり、テーブル名には 使用できません。また、ピリオド('.'), コロン(':')を含む名前のテーブルは作成できません。
+
+``flags``
+
+  作成するテーブルの属性を示す数値か、パイプ('|')で組み合わせたシンボル名を指定します。(デフォルト値は0(="TABLE_HASH_KEY"))
+
+   0, ``TABLE_HASH_KEY``
+     主キー値をハッシュ表で管理するテーブルを作成します。ハッシュ表を使用したテーブルでは、主キー値に完全一致するレコードを高速に検索することができます。
+
+   1, ``TABLE_PAT_KEY``
+     主キー値をパトリシア木で管理するテーブルを作成します。パトリシア木を使用したテーブルでは、主キー値に完全一致するレコード、前方一致するレコード、および最長共通接頭辞となるレコードを高速に検索することができます。また、キー値の昇降順でレコードを取り出したり、キー値の範囲での検索を行うことができます。また、flagsの値に64を加えることによって、後方一致検索も可能となります。
+
+   3, ``TABLE_NO_KEY``
+     主キーを持たないテーブルを作成します。各レコードはIDのみによって特定することができます。
+
+   4, ``TABLE_VIEW``
+     複数のテーブルをまとめて操作するための仮想的なテーブル(view)を作成します。
+
+   64, ``KEY_WITH_SIS``
+     語彙表となるパトリシア木型のテーブルにおいて、後方一致検索を可能とします。
+
+   128, ``KEY_NORMALIZE``
+     ハッシュ表型か、パトリシア木型のテーブルにおいて、主キー値を正規化した上で登録します。この値が指定されたテーブルではたとえば、主キー値'abc'と'ABC' は同一のレコードに対応するものとみなされます。
+
+``key_type``
+
+  主キー値の型を指定します。主キー値を持つテーブルに限り有効です。型にはgroongaの組込型か、同一データベースに定義済みのユーザ定義型、定義済みのテーブルを指定することができます。
+
+``value_type``
+
+  値の型を指定します。tableの値には固定長の型のみが指定できます。(可変長の値が必要な場合は別途カラムを作成します) 型にはgroongaの組込型か、同一データベースに定義済みのユーザ定義型、またはテーブルを指定することができます。(デフォルトはvalueなし)
+
+``default_tokenizer``
+
+  作成するテーブルを語彙表として使用する場合、文字列を分割するトークナイザを指定します。
+
+  組込のトークナイザとして、以下が準備されています。
+
+  ``TokenDelimit``
+    空白で区切られた文字列をトークンとする
+
+  ``TokenUnigram``
+    unigram(1文字を1トークンとする)
+
+  ``TokenBigram``
+    bigram(2文字の文字列要素をトークンとする)
+
+  ``TokenTrigram``
+    trigram(3文字の文字列要素をトークンとする)
+
+  ``TokenMecab``
+    形態素解析器mecabで解析した形態素をトークンとする。(mecabを組み込んだ場合のみ有効)
+
+  トークナイザが指定されなかった場合は、対象の文字列を分割せずに語彙表に登録します。
+
+返値
+----
+
+json形式
+^^^^^^^^
+
+::
+
+ [成功かどうかのフラグ]
+
+ ``成功かどうかのフラグ``
+
+   エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
+
+例
+--
+
+ShortText型の主キーを持つハッシュ表型のテーブル、Entryを作成します。::
+
+  table_create Entry --key_type ShortText
+  [true]
+
+ShortText型の主キーを持つパトリシア木型のテーブル、Termを作成します。主キー値は正規化して管理します。また、このテーブルを語彙表とする転置索引を作成する場合には、バイグラムの索引を作成します。::
+
+  table_create Term --flags TABLE_PAT_KEY|KEY_NORMALIZE --key_type ShortText --default_tokenizer TokenBigram
+  [true]