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

data/vendor/local/share/groonga/doc/ja/source/expr.txt

@@ -0,0 +1,43 @@
+.. highlightlang:: none
+
+grn_expr
+========
+
+名前
+----
+
+grn_expr - 検索条件やデータベースへの操作を表現するデータ構造(読み方:"ぐるんしき")
+
+説明
+----
+
+grn_exprは、検索条件やデータベースへの操作を表現するために使用されるデータ構造の形式です。
+
+データベースの中から特定の条件を満たすレコードを取り出すために、様々な条件をand,or,notなどの演算子で結合して自由に表現することができます。grn_exprは、一連のAPI関数を呼ぶことによって組み立てることができます。特定の文字列形式には依存していません。組み込みコマンドselectのqueryパラメータでは、検索エンジンのユーザがフォームで入力する文字列を直接受け取ることを想定して、文字列からgrn_exprを生成しています。また、多くの組み込みコマンドで共通に使用するために、ECMAScript形式の文字列からgrn_exprを生成するAPI関数grn_expr_parse()を用意しています。grn_expr_parseでパースできる文字列を特にscript形式のgrn_exprと呼びます。
+
+grn_exprを使うことによって非常に柔軟に検索条件を記述することができます。類似文書検索や近傍検索のような高度な検索もすべてgrn_exprによって記述できます。また、全文検索クエリにおいて、特定の文字列を含むレコードのスコアを細かく制御したり、検索結果数の多寡に応じてより検索漏れの少ないアルゴリズムで再検索するような機能も、grn_exprとgrn_table_select()API関数を組み合わせることによって自由に定義できます。
+
+script形式のgrn_expr
+--------------------
+
+ECMAScript風の構文で検索条件やレコードへの操作を記述します。
+
+式中のIDENTIFIER(識別子)は、以下のいずれかを指します。
+
+:引数名:
+  grn_exprが受け取る引数の名前
+
+:カラム名:
+  操作対象としているレコードのカラム名
+
+:型名・関数名・テーブル名:
+  データベースに定義された型・テーブル・関数の名前
+
+例
+--
+
+script形式でcolumn1の値が'hoge'に等しいという条件
+
+  column1 == "hoge"
+
+.. rubric:: 脚注

data/vendor/local/share/groonga/doc/ja/source/functions.txt

@@ -0,0 +1,10 @@
+.. highlightlang:: none
+
+組み込み関数一覧
+================
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   functions/*

data/vendor/local/share/groonga/doc/ja/source/functions/edit_distance.txt

@@ -0,0 +1,48 @@
+.. highlightlang:: none
+
+.. _edit_distance:
+
+edit_distance
+=============
+
+名前
+----
+
+edit_distance - 指定した2つの文字列の編集距離を計算する
+
+書式
+----
+::
+
+ edit_distance(string1, string2)
+
+説明
+----
+
+groonga組込関数の一つであるedit_distanceについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
+
+edit_distance() 関数は、string1に指定した文字列とstring2に指定した文字列の間の編集距離を求めます。
+
+引数
+----
+
+``string1``
+
+  文字列を指定します
+
+``string2``
+
+  もうひとつの文字列を指定します
+
+
+返値
+----
+
+指定した2つ文字列の編集距離をUint32型の値として返します。
+
+例
+--
+::
+
+ edit_distance(title, "hoge")
+ 1

data/vendor/local/share/groonga/doc/ja/source/functions/geo_distance.txt

@@ -0,0 +1,51 @@
+.. highlightlang:: none
+
+geo_distance
+============
+
+名前
+----
+
+geo_distance - 指定した2点の距離を計算する
+
+書式
+----
+::
+
+ geo_distance(point1, point2)
+
+説明
+----
+
+groonga組込関数の一つであるgeo_distanceについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
+
+geo_distance() 関数は、point1に指定した座標とpoint2に指定した座標の間の距離(近似値)を求めます。
+geo_distance()の他に、距離計算アルゴリズムの異なる、geo_distance2()、geo_distance3()が使用できます。それぞれ、長方形近似、球面近似、ヒュベニの距離計算式によって距離を算出します。
+
+引数
+----
+
+``point1``
+
+  距離を求める2点のうち一つを指定します。GeoPoint型の値を指定できます。 [#]_
+
+``point2``
+
+  距離を求める2点のうちもう一つを指定します。GeoPoint型の値、あるいは座標を示す文字列を指定できます。
+
+
+返値
+----
+
+指定した2点の距離をFloat型の値(単位:メートル)として返します。
+
+例
+--
+::
+
+ geo_distance(pos, "150x150")
+ 100
+
+.. rubric:: 脚注
+
+.. [#] TokyoGeoPoint(日本測地系座標)かWGS84GeoPoint(世界測地系座標)のいずれかを指定できます。

data/vendor/local/share/groonga/doc/ja/source/functions/geo_in_circle.txt

@@ -0,0 +1,54 @@
+.. highlightlang:: none
+
+geo_in_circle
+=============
+
+名前
+----
+
+geo_in_circle - 座標が円の範囲内に存在するかどうかを調べます。
+
+書式
+----
+::
+
+ geo_in_circle(point, center, radious_or_point)
+
+説明
+----
+
+groonga組込関数の一つであるgeo_in_circleについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
+
+geo_in_circle() 関数は、pointに指定した座標が、centerに指定した座標を中心とする円の範囲内にあるかどうかを調べます。
+
+引数
+----
+
+``point``
+
+  円の範囲内に存在するかどうかを調べる座標を指定します。Point型の値を指定できます。 [#]_
+
+``center``
+
+  円の中心となる座標を指定します。Point型の値、あるいは座標を示す文字列を指定できます。
+
+``radious_or_point``
+
+  円の半径を指定します。数値を指定した場合には、半径(単位:メートル)が指定されたものとみなします。
+  Point型の値、あるいは座標を示す文字列を指定した場合は、円周上の点の一つの座標が指定されたものとみなします。
+
+返値
+----
+
+pointに指定した座標が円の範囲内にあるかどうかをBool型の値で返します。
+
+例
+--
+::
+
+ geo_in_circle(pos, "100x100", 100)
+ true
+
+.. rubric:: 脚注
+
+.. [#] TokyoGeoPoint(日本測地系座標)かWGS84GeoPoint(世界測地系座標)のいずれかを指定できます。

data/vendor/local/share/groonga/doc/ja/source/functions/geo_in_rectangle.txt

@@ -0,0 +1,55 @@
+.. highlightlang:: none
+
+.. _geo_in_rectangle:
+
+geo_in_rectangle
+================
+
+名前
+----
+
+geo_in_rectangle - 座標が矩形の範囲内に存在するかどうかを調べます。
+
+書式
+----
+::
+
+ geo_in_rectangle(point, top_left, bottom_right)
+
+説明
+----
+
+groonga組込関数の一つであるgeo_in_rectangleについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
+
+geo_in_rectangle() 関数は、pointに指定した座標が、top_leftとbottom_rightがなす矩形の範囲内にあるかどうかを調べます。
+
+引数
+----
+
+``point``
+
+  矩形の範囲内に存在するかどうかを調べる座標を指定します。Point型の値を指定できます。 [#]_
+
+``top_left``
+
+  矩形の左上隅となる座標を指定します。Point型の値、あるいは座標を示す文字列を指定できます。
+
+``bottom_right``
+
+  矩形の右下隅となる座標を指定します。Point型の値、あるいは座標を示す文字列を指定できます。
+
+返値
+----
+
+pointに指定した座標が矩形の範囲内にあるかどうかをBool型の値で返します。
+
+例
+--
+::
+
+ geo_in_rectangle(pos, "150x100", "100x150")
+ true
+
+.. rubric:: 脚注
+
+.. [#] TokyoGeoPoint(日本測地系座標)かWGS84GeoPoint(世界測地系座標)のいずれかを指定できます。

data/vendor/local/share/groonga/doc/ja/source/functions/now.txt

@@ -0,0 +1,34 @@
+.. highlightlang:: none
+
+now
+===
+
+名前
+----
+
+now - 現在時刻を返す
+
+書式
+----
+::
+
+ now()
+
+説明
+----
+
+groonga組込関数の一つであるnowについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
+
+now() 関数は現在時刻に対応するTime型の値を返します。
+
+返値
+----
+
+現在時刻に対応するTime型のオブジェクトを返します。
+
+例
+--
+::
+
+ now()
+ 1256791194.55541

data/vendor/local/share/groonga/doc/ja/source/functions/rand.txt

@@ -0,0 +1,41 @@
+.. highlightlang:: none
+
+rand
+====
+
+名前
+----
+
+rand - 乱数を生成する
+
+書式
+----
+::
+
+ rand([max])
+
+説明
+----
+
+groonga組込関数の一つであるrandについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
+
+rand() 関数は 0 から max の間の疑似乱数整数を返します。
+
+引数
+----
+
+``max``
+
+  返値の最大値を指定します。省略した場合は RAND_MAX が指定されたものとみなされます。
+
+返値
+----
+
+0 と max の間の数を表すInt32型の値を返します。
+
+例
+--
+::
+
+ rand(10)
+ 3

data/vendor/local/share/groonga/doc/ja/source/grnslap.txt

@@ -0,0 +1,64 @@
+.. highlightlang:: none
+
+grnslap
+=======
+
+名前
+----
+
+grnslap - groongaプロセスの通信層のパフォーマンスをチェックするツール
+
+書式
+----
+
+::
+
+ grnslap [options] [dest]
+
+説明
+----
+
+grnslapは、groongaプロセスに対してリクエストを多重に行い、パフォーマンスをチェックするためのツールです。
+
+groonga独自プロトコルであるgqtpと、httpの両プロトコルでリクエストを行うことができます。また、リクエストの多重度を指定することができます。
+
+クエリの内容を標準入力から与えることができます。実稼動環境でのクエリパタンに近いクエリを標準入力に与えることによって、実稼動環境に近い状態での検証を行うことができます。
+
+現在は、make installしてもインストールは行われない。
+
+オプション
+----------
+
+.. cmdoption:: -P
+
+   リクエストのプロトコルを指定します。
+
+   `http`
+
+     httpでリクエストします。対象のhttpのパス群(GETパラメータを含む)をLF区切り形式で標準入力に与えると、それらのパスに順次アクセスします。
+
+   `gqtp`
+
+     gqtpでリクエストします。gqtpのリクエストをLF区切り形式で標準入力に与えると、それらのリクエストを順次行います。
+
+.. cmdoption:: -m
+
+   リクエストの多重度を指定します。初期値は10です。
+
+引数
+----
+
+.. cmdoption:: dest
+
+   接続先のホスト名とポート番号をを指定します(デフォルト値は'localhost:10041')。ポート番号を指定しない場合には、10041が指定されたものとします。
+
+サンプル
+--------
+
+http://localhost:10041/d/status に、多重度100でリクエストを行う。
+
+::
+
+  > yes /d/status | head -n 100 | grnslap -P http -m 100 localhost:10041
+  2009-11-12 19:34:09.998696|begin: max_concurrency=100 max_tp=10000
+  2009-11-12 19:34:10.011208|end  : n=100 min=46 max=382 avg=0 qps=7992.966190 etime=0.012511

data/vendor/local/share/groonga/doc/ja/source/grntest.txt

@@ -0,0 +1,259 @@
+.. highlightlang:: none
+
+grntest
+=======
+
+名前
+----
+
+grntest - groongaテストプログラム
+
+書式
+----
+
+::
+
+  grntest  [options...] [script] [db]
+
+説明
+----
+
+grntestは、groonga汎用テストツールです。
+
+groongaを単独のプロセスとして利用する場合はもちろん、サーバプログラムとして利用する場合の動作確認や実行速度測定が可能です。
+
+grntest を利用するために必要なデータファイルは、ftp.groonga.orgから必要に応じダウンロードしますので、groonga及びgrntestが動作し、インターネットに接続できる環境であればgroongaコマンドの知識がなくてもgroongaの動作を確認できます。
+
+現在は、linux 及びWindows上で動作します。make installしてもインストールは行われません。
+
+オプション
+----------
+.. cmdoption:: -i, --host <ip/hostname>
+
+  接続するgroongaサーバを、ipアドレスまたはホスト名で指定します。指定先にgroongaサーバが立ち上がっていない場合、接続不能となることに注意してください。このオプションを指定しない場合、grntestは自動的にlocalhostのgroongaサーバを起動して接続します。
+
+
+.. cmdoption:: -p, --port <port number>
+
+  自動的に起動するgroongaサーバ、または明示的に指定した接続先のgroonga サーバが利用するポート番号を指定します。接続先のgroongaサーバが利用しているポートと、このオプションで指定したポート番号が異なる場合、接続不能となることに注意してください。
+
+
+.. cmdoption:: --dir
+
+  ftp.groonga.org に用意されているスクリプトファイルを表示します。
+
+.. cmdoption:: --noftp
+
+  通常grntestはftp.groonga.orgとftp通信を行い、scriptファイルの同期やログファイルの送信を行います。--noftp オプションを指定するとftp 通信を一切行わないようになります。存在しないスクリプトファイルを指定した場合、エラーとなることに注意してください。
+
+.. cmdoption:: --log-output-dir
+
+  デフォルトでは、grntest終了後のログファイルの出力先ははカレントディレクトリです。このオプションを利用すると、任意のディレクトリに出力先を変更することができます。
+
+引数
+----
+
+.. cmdoption:: script
+
+  grntestの動作方法(以下、grntest命令と呼びます)を記述したテキストファイルです。拡張子は.scrです。
+
+.. cmdoption:: db
+
+  grntestが利用するgroonga データベースです。指定されたデータベースが存在しない場合、grntestが新規に作成します。またgroonga サーバを自動的に起動する場合もこの引数で指定したデータベースが利用されます。接続するgroonga サーバを明示的に指定した場合に利用するデータベースは、接続先サーバが使用中のデータベースになることに注意してください。
+
+
+使い方
+------
+まず、シェル上(Windowsならコマンドプロンプト上)で
+
+   grntest test.scr 任意のDB名
+
+とタイプしてください。もしgrntestが正常に動作すれば、
+
+   test-ユーザ名-数字.log
+
+というファイルが作成されるはずです。作成されない場合、、このドキュメントの「トラブルシューティング」の章を参照してください。
+
+
+スクリプトファイル
+------------------
+
+スクリプトファイルは、grntest命令を記述したテキストファイルです。
+";"セミコロンを利用して、一行に複数のgrntest命令を記述することができます。一行に複数のgrntest命令がある場合、各命令は並列に実行されます。
+"#"で始まる行はコメントとして扱われます。
+
+
+
+grntest命令
+^^^^^^^^^^^
+
+現在サポートされているgrntest命令は以下の8つです。
+
+  do_local コマンドファイル [スレッド数] [繰り返し数]
+
+    コマンドファイルをgrntest単体で実行します。スレッド数が指定されている場合、複数のスレッドで同じコマンドファイルを同時に実行します。繰り返し数が指定されてい場合、コマンドファイルの内容を繰り返し実行します。スレッド数、繰り返し数とも省略時は1です。1スレッドで複数回動作させたい場合は、do_local コマンドファイル 1 [繰り返し数]と明示的に指定してください。
+
+  do_gqpt コマンドファイル [スレッド数] [繰り返し数]
+
+    コマンドファイルをgroongaサーバで実行します。スレッド数や繰り返し数の意味はdo_localの場合と同じです。
+
+  rep_local コマンドファイル [スレッド数] [繰り返し数]
+
+    コマンドファイルをgrntest単体で実行し、より詳細な報告を行います。
+
+  rep_gqpt コマンドファイル [スレッド数] [繰り返し数]
+
+    コマンドファイルをgroongaサーバで実行し、より詳細な報告を行います。 スレッド数や繰り返し数の意味はdo_localと 同じです。
+
+  out_local コマンドファイル 入力ファイル名
+
+    コマンドファイルをgrntest単体で実行し、各コマンドの実行結果をすべて”出力ファイル"に書きだします。この結果は、test_local,　test_gqtp命令で利用します。なおこの命令の「出力ファイル」とは、grntest実行時に自動的に作成されるログとは別のものです。grntestではコメントが利用できる以外、::
+
+     groonga < コマンドファイル > 出力ファイル
+
+    とした場合と同じです。
+
+  out_gqtp コマンドファイル 出力ファイル名
+
+    コマンドファイルをgroongaサーバで実行します。その他はout_local命令と同等です。
+
+  test_local コマンドファイル 入力ファイル名
+    コマンドファイルをgrntest単体で実行し、各コマンドの実行結果を入力ファイルと比較します。処理時間など本質的要素以外に差分があった場合、差分を、入力ファイル.diffというファイルに書きだします。
+ 
+
+コマンドファイル
+^^^^^^^^^^^^^^^^
+
+コマンドファイルは、groonga組み込みコマンドを1行に1つずつ記述したテキストファイルです。拡張子に制限はありません。groonga組み込みコマンドに関しては./commands.htmlを参照してください。
+
+サンプル
+^^^^^^^^
+
+スクリプトファイルのサンプルです。::
+
+  # sample script
+  rep_local test.ddl
+  do_local test.load;
+  do_gqtp test.select 10 10; do_local test.status 10
+
+
+上記の意味は以下のとおりです。::
+
+  1行目:コメント行。
+  2行目:test.dll というコマンドファイルをgroonga単体で実行し、詳細に報告する。
+  3行目:test.load というコマンドファイルをgroonga単体で実行する。(最後の";"セミコロンは複数のgrntest命令を記述する場合に必要ですが、この例のように1つのgrntest命令を実行する場合に付与しても問題ありません。)
+  4行目:test.select というコマンドファイルをgroongaサーバで10個のスレッドで同時に実行する。各スレッドはtest.selectの中身を10回繰り返す。また同時に、groonga単体でtest.statusというコマンドファイルを10個のスレッドで実行する。
+
+特殊命令
+^^^^^^^^
+
+スクリプトファイルのコメント行には特殊コマンドを埋め込むことが可能です。現在サポートされている特殊命令は以下の二つです。
+
+#SET_HOST <ip/hostname>
+-i, --hostオプションと同等の機能です。コマンドラインオプションに指定したIPアドレス/ホスト名と、SET_HOSTで指定したIPアドレス/ホスト名が異なる場合、またコマンドラインオプションを指定しなかった場合にもSET_HOSTが優先されます。SET_HOSTを利用した場合、サーバが自動的には起動されないのもコマンドラインオプションで指定した場合と同様です。
+
+#SET_PORT <port number>
+
+-p, --port オプションと同等の機能です。コマンドラインオプションに指定したポート番号とSET_PORTで指定したポート番号が異なる場合、またコマンドラインオプションを指定しなかった場合にもSET_PORTが優先されます。
+
+
+特殊命令はスクリプトファイルの任意の場所に書き込むことができます。同一ファイル内に複数回特殊命令を記述した場合、「最後の」特殊命令が有効となります。
+
+例えば、
+
+::
+
+  $ ./grntest --port 20010 test.scr testdb
+
+とコマンド上でポートを指定した場合でも、もしtest.scrの中身が
+
+::
+  #SET_PORT 10900
+  rep_local test.ddl
+  do_local test.load;
+  rep_gqtp test.select 10 10; rep_local test.status 10
+  #SET_PORT 10400
+
+であれば、自動的に起動されるgroongaサーバはポート番号10400を利用します。
+
+
+grntest実行結果
+---------------
+
+grntestが正常に終了すると、(拡張子を除いた)スクリプト名-ユーザ名-実行開始時刻.logという形式のログファイルがカレントディレクトリに作られます。ログファイルは自動的にftp.groonga.org
+に送信されます。ログファイルは以下のようなjson形式のテキストです。 
+
+::
+
+  [{"script": "test.scr",
+    "user": "homepage",
+    "date": "2010-04-14 22:47:04",
+    "CPU": Intel(R) Pentium(R) 4 CPU 2.80GHz",
+    "BIT": 32,
+    "CORE": 1,
+    "RAM": "975MBytes",
+    "HDD": "257662232KBytes",
+    "OS": "Linux 2.4.20-24.7-i686",
+    "HOST": "localhost",
+    "PORT": "10041",
+    "VERSION": "0.1.8-100-ga54c5f8"
+  },
+  {"jobs": "rep_local test.ddl",
+  "detail": [
+  [0, "table_create res_table --key_type ShortText", 1490, 3086, [0,1271252824.25846,0.00144
+  7]],
+  [0, "column_create res_table res_column --type Text", 3137, 5956, [0,1271252824.2601,0.002
+  741]],
+  [0, "column_create res_table user_column --type Text", 6020, 8935, [0,1271252824.26298,0.0
+  02841]],
+  [0, "column_create res_table mail_column --type Text", 8990, 11925, [0,1271252824.26595,0.
+  002861]],
+  [0, "column_create res_table time_column --type Time", 12008, 13192, [0,1271252824.26897,0
+  .001147]],
+  [0, "status", 13214, 13277, [0,1271252824.27018,3.0e-05]],
+  [0, "table_create thread_table --key_type ShortText", 13289, 14541, [0,1271252824.27025,0.
+  001213]],
+  [0, "column_create thread_table thread_title_column --type ShortText", 14570, 17380, [0,12
+  71252824.27153,0.002741]],
+  [0, "status", 17435, 17480, [0,1271252824.2744,2.7e-05]],
+  [0, "table_create lexicon_table --flags 129 --key_type ShortText --default_tokenizer Token
+  Bigram", 17491, 18970, [0,1271252824.27446,0.001431]],
+  [0, "column_create lexicon_table inv_res_column 514 res_table res_column ", 18998, 33248,
+  [0,1271252824.27596,0.01418]],
+  [0, "column_create lexicon_table inv_thread_column 514 thread_table thread_title_column ",
+   33285, 48472, [0,1271252824.29025,0.015119]],
+  [0, "status", 48509, 48554, [0,1271252824.30547,2.7e-05]]],
+  "summary" :[{"job": "rep_local test.ddl", "latency": 48607, "self": 47719, "qps": 272.4281
+  73, "min": 45, "max": 15187, "queries": 13}]},
+  {"jobs": "do_local test.load; ",
+  "summary" :[{"job": "do_local test.load", "latency": 68693, "self": 19801, "qps": 1010.049
+  997, "min": 202, "max": 5453, "queries": 20}]},
+  {"jobs": "do_gqtp test.select 10 10; do_local test.status 10",
+  "summary" :[{"job": " do_local test.status 10", "latency": 805990, "self": 737014, "qps":
+  54.273053, "min": 24, "max": 218, "queries": 40},{"job": "do_gqtp test.select 10 10", "lat
+  ency": 831495, "self": 762519, "qps": 1967.164097, "min": 73, "max": 135631, "queries": 15
+  00}]},
+  {"total": 915408, "qps": 1718.359464, "queries": 1573}]
+  
+
+
+制限事項
+--------
+
+* スクリプトファイルの一行には複数のgrntest命令を記述できますが、すべてのスレッド数の合計は最大64までに制限されます。
+
+* コマンドファイル中のgroongaコマンドの長さは最長5000000byteです。
+
+
+トラブルシューティング
+----------------------
+
+もし、grntestが正常に動作しない場合、まず以下を確認してください。
+
+* インターネットに接続しているか？　--noftp モードを指定しない限り、grntestは動作のたびにftp.groonga.orgと通信します。ftp.groonga.orgと通信可能でない場合、grntestは正常に動作しません。
+
+* groonga サーバが動作していないか？　grntestは、-i, --host オプションで明示的にサーバを指定しないかぎり、自動的にlocalhostのgroongaサーバを立ち上げます。すでにgroongaサーバが動作している場合、grntestは正常に動作しない可能性があります。
+
+* 指定したDBが適切か？ grntestは、引数で指定したDBの中身はチェックしません。もし指定されたDBが存在しなければ自動的にDBを作成しますが、もしファイルとして存在する場合は中身に関わらず動作を続けてしまい、結果が異常になる可能性があります。
+
+以上の原因でなければ、問題はgrntestかgroongaにあります。ご報告をお願いします。