rroonga 2.1.0-x86-mingw32 → 2.1.1-x86-mingw32

data/vendor/local/share/doc/groonga/source/reference/tables.txt

@@ -0,0 +1,163 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+Tables
+======
+
+Summary
+-------
+
+Table in groonga manages relation between ID and key. Groonga provides
+four table types. They are ``TABLE_NO_KEY``, ``TABLE_HASH_KEY``,
+``TABLE_PAT_KEY`` and ``TABLE_DAT_KEY``.
+
+All table except ``TABLE_NO_KEY`` provides both fast ID search by key
+and fast key search by ID. ``TABLE_NO_KEY`` doesn't support
+key. ``TABLE_NO_KEY`` only manages ID. So ``TABLE_NO_KEY`` doesn't
+provides ID search and key search.
+
+Characteristics
+---------------
+
+Here is a chracteristic table of all tables in groonga. (``TABLE_``
+prefix is omitted in the table.)
+
++--------------+------------+--------------+-------------+-------------+
+|              | ``NO_KEY`` | ``HASH_KEY`` | ``PAT_KEY`` | ``DAT_KEY`` |
++--------------+------------+--------------+-------------+-------------+
+| Data         | Array      | Hash table   | Patricia    | Double      |
+| structure    |            |              | trie        | array       |
+|              |            |              |             | trie        |
++--------------+------------+--------------+-------------+-------------+
+| ID           | o          | o            | o           | o           |
+| support      |            |              |             |             |
++--------------+------------+--------------+-------------+-------------+
+| Key          | x          | o            | o           | o           |
+| support      |            |              |             |             |
++--------------+------------+--------------+-------------+-------------+
+| Value        | o          | o            | o           | x           |
+| support      |            |              |             |             |
++--------------+------------+--------------+-------------+-------------+
+| Key -> ID    | -          | oo           | x           | o           |
+| speed        |            |              |             |             |
+| (o -> fast)  |            |              |             |             |
+| (x -> slow)  |            |              |             |             |
++--------------+------------+--------------+-------------+-------------+
+| Update       | ooo        | o            | o           | x           |
+| speed        |            |              |             |             |
+| (o -> fast)  |            |              |             |             |
+| (x -> slow)  |            |              |             |             |
++--------------+------------+--------------+-------------+-------------+
+| Size         | ooo        | o            | oo          | x           |
+| (o -> small) |            |              |             |             |
+| (x -> large) |            |              |             |             |
++--------------+------------+--------------+-------------+-------------+
+| Key          | -          | x            | x           | o           |
+| update       |            |              |             |             |
++--------------+------------+--------------+-------------+-------------+
+| Common       | -          | x            | o           | o           |
+| prefix       |            |              |             |             |
+| search       |            |              |             |             |
++--------------+------------+--------------+-------------+-------------+
+| Predictive   | -          | x            | o           | o           |
+| search       |            |              |             |             |
++--------------+------------+--------------+-------------+-------------+
+| Range        | -          | x            | o           | o           |
+| search       |            |              |             |             |
++--------------+------------+--------------+-------------+-------------+
+
+``TABLE_NO_KEY``
+^^^^^^^^^^^^^^^^
+
+``TABLE_NO_KEY`` is very fast and very small but it doesn't support
+key. ``TABLE_NO_KEY`` is a only table that doesn't support key.
+
+You cannot use ``TABLE_NO_KEY`` for lexicon for fulltext search
+because lexicon stores tokens as key. ``TABLE_NO_KEY`` is useful for
+no key records such as log.
+
+``TABLE_HASH_KEY``
+^^^^^^^^^^^^^^^^^^
+
+``TABLE_HASH_KEY`` is fast but it doesn't support advanced search
+functions such as common prefix search and predictive search.
+
+``TABLE_HASH_KEY`` is useful for index for exact search such as tag
+search.
+
+``TABLE_PAT_KEY``
+^^^^^^^^^^^^^^^^^
+
+``TABLE_PAT_KEY`` is small and supports advanced search functions.
+
+``TABLE_PAT_KEY`` is useful for lexicon for fulltext search and
+index for range search.
+
+``TABLE_DAT_KEY``
+^^^^^^^^^^^^^^^^^
+
+``TABLE_DAT_KEY`` is fast and supports key update but it is large. It
+is not suitable for storing many records. ``TABLE_DAT_KEY`` is a only
+table that supports key update.
+
+``TABLE_DAT_KEY`` is used in groonga database. Groonga database needs
+to convert object name such as ``ShortText``, ``TokenBigram`` and
+table names to object ID. And groonga database needs to rename object
+name. Those features are implemented by ``TABLE_DAT_KEY``. The number
+of objects is small. So large data size demerit of ``TABLE_DAT_KEY``
+can be ignored.
+
+Record ID
+---------
+
+Record ID is assigned automatically. You cannot assign record ID.
+
+Record ID of deleted record may be reused.
+
+Valid record ID range is between 1 and 268435455. (1 and 268435455 are
+valid IDs.)
+
+Persistent table and temporary table
+------------------------------------
+
+Table is persistent table or temporary table.
+
+Persistent table
+^^^^^^^^^^^^^^^^
+
+Persistent table is named and registered to database. Records in
+persistent table aren't deleted after closing table or
+database.
+
+Persistent table can be created by
+:doc:`/reference/commands/table_create` command.
+
+Temporary table
+^^^^^^^^^^^^^^^
+
+Temporary table is anonymous. Records in temporary table are deleted
+after closing table. Temporary table is used to store search result,
+sort result, group (drilldown) result and so on. ``TABLE_HASH_KEY`` is
+used for search result and group result. ``TABLE_NO_KEY`` is used for
+sort result.
+
+Limitations
+-----------
+
+The max number of records is 268435455. You cannot add 268435456 or
+more records in a table.
+
+The max number of a key size is 4096byte. You cannot use 4097byte or
+larger key. You can use column instead of key for 4097byte or larger
+size data. ``Text`` and ``LargeText`` types supports 4097byte or
+larger size data.
+
+The max number of total key size is 4GiB. You need to split a table,
+split a database (sharding) or reduce each key size to handle 4GiB or
+more larger total key size.
+
+See also
+--------
+
+* :doc:`/reference/commands/table_create`

data/vendor/local/share/doc/groonga/source/server/http/comparison.txt

@@ -123,7 +123,7 @@ configuration to use ``/api/`` as prefix path::
 Custom command version
 ----------------------
 
-Groonga has :doc:`/reference/command_version` mechanism. It is for
+Groonga has :doc:`/reference/command/command_version` mechanism. It is for
 upgrading groonga commands with backward compatibility.
 
 :doc:`groonga` can change the default command veresion by

data/vendor/local/share/doc/groonga/source/tutorial/data.txt

@@ -15,7 +15,7 @@ Groonga is a full text search engine but also serves as a column-oriented data s
 Overview
 --------
 
-The basic data types of groonga are roughly divided into 5 groups --- boolean type, numeric types, string types, date/time type and longitude/latitude types. The numeric types are further divided according to whether integer or floating point number, signed or unsigned and the number of bits allocated to each integer. The string types are further divided according to the maximum length. The longitude/latitude types are further divided according to the geographic coordinate system. For more details, see :doc:`/reference/type`.
+The basic data types of groonga are roughly divided into 5 groups --- boolean type, numeric types, string types, date/time type and longitude/latitude types. The numeric types are further divided according to whether integer or floating point number, signed or unsigned and the number of bits allocated to each integer. The string types are further divided according to the maximum length. The longitude/latitude types are further divided according to the geographic coordinate system. For more details, see :doc:`/reference/types`.
 
 In addition, groonga supports reference types and vector types. Reference types are designed for accessing other tables. Vector types are designed for storing a variable number of values in one element.
 
@@ -46,7 +46,7 @@ The following example creates a boolean type column and adds three records. Note
 Numeric types
 -------------
 
-The numeric types are divided into integer types and a floating point number type. The integer types are further divided into the signed integer types and unsigned integer types. In addition, you can choose the number of bits allocated to each integer. For more details, see :doc:`/reference/type`. The default value of the numeric types is 0.
+The numeric types are divided into integer types and a floating point number type. The integer types are further divided into the signed integer types and unsigned integer types. In addition, you can choose the number of bits allocated to each integer. For more details, see :doc:`/reference/types`. The default value of the numeric types is 0.
 
 The following example creates an Int8 column and a Float column, and then updates existing records. The :doc:`/reference/commands/load` command updates the weight column as expected. On the other hand, the price column values are different from the specified values because 15.9 is not an integer and 200 is too large. 15.9 is converted to 15 by removing the fractional part. 200 causes an overflow and the result becomes -56. Note that the result of an overflow/underflow is undefined.
 
@@ -65,7 +65,7 @@ The following example creates an Int8 column and a Float column, and then update
 String types
 ------------
 
-The string types are divided according to the maximum length. For more details, see :doc:`/reference/type`. The default value is the zero-length string.
+The string types are divided according to the maximum length. For more details, see :doc:`/reference/types`. The default value is the zero-length string.
 
 The following example creates a ShortText column and updates existing records. The third record has the default value because not updated.
 
@@ -99,7 +99,7 @@ The following example creates a Time column and updates existing records. The fi
 Longitude and latitude types
 ----------------------------
 
-The longitude and latitude types are divided according to the geographic coordinate system. For more details, see :doc:`/reference/type`. To represent a longitude and latitude, groonga uses a string formatted as follows:
+The longitude and latitude types are divided according to the geographic coordinate system. For more details, see :doc:`/reference/types`. To represent a longitude and latitude, groonga uses a string formatted as follows:
 
 * "longitude x latitude" in milliseconds (e.g.: "128452975x503157902")
 * "longitude x latitude" in degrees (e.g.: "35.6813819x139.7660839")

data/vendor/local/share/doc/groonga/source/tutorial/introduction.txt

@@ -93,7 +93,7 @@ A :doc:`/reference/commands/table_create` command creates a new table.
 
 In most cases, a table has a primary key which must be specified with its data type and index type. 
 
-There are various data types such as integers, strings, etc. See also :doc:`/reference/type` for more details. The index type determines the search performance and the availability of prefix searches. The details will be described later.
+There are various data types such as integers, strings, etc. See also :doc:`/reference/types` for more details. The index type determines the search performance and the availability of prefix searches. The details will be described later.
 
 Let's create a table. The following example creates a table with a primary key. The `name` parameter specifies the name of the table. The `flags` parameter specifies the index type for the primary key. The `key_type` parameter specifies the data type of the primary key.
 

data/vendor/local/share/man/ja/man1/groonga.1

@@ -1,4 +1,4 @@
-.TH "GROONGA" "1" "2012 年 12 月 27 日" "2.1.0" "groonga"
+.TH "GROONGA" "1" "2012 年 12 月 29 日" "2.1.1" "groonga"
 .SH NAME
 groonga \- groongaのドキュメント
 .
@@ -1354,10 +1354,10 @@ status
 #     "max_command_version": 2,
 #     "n_queries": 0,
 #     "cache_hit_rate": 0.0,
-#     "version": "2.0.5",
-#     "alloc_count": 142,
+#     "version": "2.1.0",
+#     "alloc_count": 152,
 #     "command_version": 1,
-#     "starttime": 1343713486,
+#     "starttime": 1356678603,
 #     "default_command_version": 1
 #   }
 # ]
@@ -1418,7 +1418,7 @@ groongaプロセスの状態を表示します。
 .sp
 groongaのテーブルには基本的に主キーが必要であり、テーブルを作成する際には型と格納方法も併せて指定する必要があります。
 .sp
-型には数値や文字列などがあります。ここではデータの種類を表しているものという程度に考えてください。詳細は \fB/reference/type\fP に記述されています。主キーの格納方法は、主キーを条件とする検索にかかる時間や、前方一致検索の可否などを左右します。こちらも後で説明します。
+型には数値や文字列などがあります。ここではデータの種類を表しているものという程度に考えてください。詳細は \fB/reference/types\fP に記述されています。主キーの格納方法は、主キーを条件とする検索にかかる時間や、前方一致検索の可否などを左右します。こちらも後で説明します。
 .sp
 それでは、テーブルを作成してみましょう。以下の例では、主キーのあるテーブルを作成します。 \fIname\fP 引数はテーブルの引数を指定します。 \fIflags\fP 引数は主キーの格納方法を指定するために使っています。 \fIkey_type\fP 引数は主キーの型を指定します。
 .sp
@@ -2586,7 +2586,7 @@ groongaのサーバには認証機能がありません。誰でもデータベ
 groongaは全文検索エンジンを起源として独自のカラムストアを持つに至るわけですが、索引語や文書を保存するだけでなく、数値や文字列、日時や経緯度など、いろいろなデータを保存することができます。本チュートリアルでは、groongaで保存できるデータの種類、およびに保存の方法を説明します。
 .SS データの種類
 .sp
-groongaにおいて利用できる基本型は、真偽値、数値、文字列、日時、経緯度の5種類に大別できます。基本型において、数値は整数・浮動小数点数の違い、符号の有無と割り当てるビット数によって細分化できるほか、文字列は長さの上限によって細分化できます。また、経緯度には測地系による分類があります。詳しくは \fB/reference/type\fP を参照してください。
+groongaにおいて利用できる基本型は、真偽値、数値、文字列、日時、経緯度の5種類に大別できます。基本型において、数値は整数・浮動小数点数の違い、符号の有無と割り当てるビット数によって細分化できるほか、文字列は長さの上限によって細分化できます。また、経緯度には測地系による分類があります。詳しくは \fB/reference/types\fP を参照してください。
 .sp
 拡張型としては、別テーブルを参照するための情報であるテーブル参照を保存することができます。また、基本型もしくはテーブル参照を複数まとめて保存できるように、ベクターカラムをサポートしています。
 .sp
@@ -2660,7 +2660,7 @@ select \-\-table ToyBox \-\-output_columns _key,is_animal
 .fi
 .SS 数値
 .sp
-数値型は、整数と浮動小数点数に分けることができます。整数は、符号付き整数と符号なし整数に分けることができるだけでなく、割り当てるビット数によっても分けることができます。割り当てるビット数を大きくすると、カラムのサイズは大きくなってしまいますが、表現できる整数の範囲を大きくすることができます。詳しくは \fB/reference/type\fP を参照してください。数値型のデフォルト値はいずれも0です。
+数値型は、整数と浮動小数点数に分けることができます。整数は、符号付き整数と符号なし整数に分けることができるだけでなく、割り当てるビット数によっても分けることができます。割り当てるビット数を大きくすると、カラムのサイズは大きくなってしまいますが、表現できる整数の範囲を大きくすることができます。詳しくは \fB/reference/types\fP を参照してください。数値型のデフォルト値はいずれも0です。
 .sp
 以下の例では、Int8型のカラムとFloat型のカラムを作成し、既存のレコードを更新します。weightカラムについては、指定した値が問題なく格納されています。一方、priceカラムに指定した小数については、小数点以下を切り捨てた値が格納されています。また、表現できる範囲を超える値を格納しようとした2番目のレコードについては、指定した値とは異なる値が格納されています。このように、表現できる範囲を超える値を指定すると、操作後の値は未定義になるので注意してください。
 .sp
@@ -2727,7 +2727,7 @@ select \-\-table ToyBox \-\-output_columns _key,price,weight
 .fi
 .SS 文字列
 .sp
-文字列型は、長さの上限によって分けることができます。詳しくは \fB/reference/type\fP を参照してください。文字列型のデフォルト値は長さ0の文字列です。
+文字列型は、長さの上限によって分けることができます。詳しくは \fB/reference/types\fP を参照してください。文字列型のデフォルト値は長さ0の文字列です。
 .sp
 以下の例では、ShortText型のカラムを作成し、IDが1と2のレコードを更新します。更新しないレコードについては、デフォルト値のままとなります。
 .sp
@@ -2841,7 +2841,7 @@ select \-\-table ToyBox \-\-output_columns _key,time
 .fi
 .SS 経緯度
 .sp
-経緯度を表現するための型は、測地系によって分けることができます。詳しくは \fB/reference/type\fP を参照してください。経緯度の指定・表示には、以下に示す形式の文字列を使います。
+経緯度を表現するための型は、測地系によって分けることができます。詳しくは \fB/reference/types\fP を参照してください。経緯度の指定・表示には、以下に示す形式の文字列を使います。
 .INDENT 0.0
 .IP \(bu 2
 "経度のミリ秒表記x緯度のミリ秒表記" （例: "128452975x503157902"）
@@ -7523,7 +7523,7 @@ http {
 .fi
 .SS コマンドバージョンの変更
 .sp
-groongaには \fB/reference/command_version\fP という仕組みがあります。これは後方互換性を維持したままgroongaコマンドをアップグレードするための仕組みです。
+groongaには \fB/reference/command/command_version\fP という仕組みがあります。これは後方互換性を維持したままgroongaコマンドをアップグレードするための仕組みです。
 .sp
 \fBgroonga\fP は \fB\-\-default\-command\-version\fP オプションでデフォルトのコマンドバージョンを変更できます。以下はデフォルトのコマンドバージョンとしてコマンドバージョン2を使うコマンドライン例です。:
 .sp
@@ -7905,7 +7905,7 @@ out_gqtp コマンドファイル 出力ファイル名
 .UNINDENT
 .SS コマンドファイル
 .sp
-コマンドファイルは、groonga組み込みコマンドを1行に1つずつ記述したテキストファイルです。拡張子に制限はありません。groonga組み込みコマンドに関しては \fB/reference/commands\fP を参照してください。
+コマンドファイルは、groonga組み込みコマンドを1行に1つずつ記述したテキストファイルです。拡張子に制限はありません。groonga組み込みコマンドに関しては \fB/reference/command\fP を参照してください。
 .SS サンプル
 .sp
 スクリプトファイルのサンプルです。:
@@ -8224,6 +8224,17 @@ groongaコマンドを通してデータベースを操作する命令をコマ
 形式1でコマンドを実行する場合は、定義された順番で値を指定しなければならず、途中の引数の値を省略することはできません。形式2でコマンドを実行する場合は、「\-\-引数名」のように引数の名前を明示しなければならない代わりに、任意の順番で引数を指定することが可能で、途中の引数の指定を省略することもできます。
 .sp
 標準入力からコマンド文字列を与える場合は、コマンド名と引数名と値は、空白( )で区切ります。空白や、記号「"\(aq()」のうちいずれかを含む値を指定したい場合は、シングルクォート(\(aq)かダブルクォート(")で値を囲みます。値として指定する文字列の中では、改行文字は\(aqn\(aqに置き換えて指定します。また、引用符に使用した文字を値の中で指定する場合には、その文字の前にバックスラッシュ(\(aq\(aq) を指定します。バックスラッシュ文字自身を値として指定する場合には、その前にバックスラッシュを指定します。
+.sp
+\(aq\e\(aq文字で継続行であることを明示してコマンドリストを記述することができます。
+.sp
+.nf
+.ft C
+table_create \-\-name Terms \e
+             \-\-flags TABLE_PAT_KEY \e
+             \-\-key_type ShortText \e
+             \-\-default_tokenizer TokenBigram
+.ft P
+.fi
 .SS 組み込みコマンド
 .sp
 以下のコマンドは組み込みコマンドとして予め定義されています。
@@ -8390,14 +8401,14 @@ http {
     0.000355720520019531
   ],
   {
-    "uptime": 1,
+    "uptime": 0,
     "max_command_version": 2,
     "n_queries": 0,
     "cache_hit_rate": 0.0,
-    "version": "2.0.5",
-    "alloc_count": 142,
+    "version": "2.1.0",
+    "alloc_count": 152,
     "command_version": 1,
-    "starttime": 1343713471,
+    "starttime": 1356678595,
     "default_command_version": 1
   }
 ]
@@ -8581,7 +8592,7 @@ GETメソッドのみが使用可能です。
 .sp
 output_typeにはjson, tsv, xmlが指定可能です。
 .sp
-command_versionはコマンドの仕様の互換性を指定します。詳細は \fB/reference/command_version\fP を参照してください。
+command_versionはコマンドの仕様の互換性を指定します。詳細は \fB/reference/command/command_version\fP を参照してください。
 .SS 返値
 .sp
 output_typeの指定に従って、コマンドの実行結果を出力します。
@@ -10567,7 +10578,7 @@ register query_expanders/tsv
 \fBregister\fP が失敗すると、エラーの詳細は \fBHEADER\fP に含まれます。
 .sp
 \fBHEADER\fP については \fB/reference/command/output_format\fP を参照してください。
-.SS select
+.SS \fBselect\fP
 .SS 概要
 .sp
 \fBselect\fP はテーブルから指定された条件にマッチするレコードを検索し、見つかったレコードを出力します。
@@ -12872,14 +12883,14 @@ status
 #     0.000355720520019531
 #   ],
 #   {
-#     "uptime": 23,
+#     "uptime": 6,
 #     "max_command_version": 2,
 #     "n_queries": 30,
 #     "cache_hit_rate": 0.0,
-#     "version": "2.0.5",
-#     "alloc_count": 278,
+#     "version": "2.1.0",
+#     "alloc_count": 280,
 #     "command_version": 1,
-#     "starttime": 1343713421,
+#     "starttime": 1356678580,
 #     "default_command_version": 1
 #   }
 # ]
@@ -13377,139 +13388,274 @@ suggest \-\-table item_query \-\-column kana \-\-types complete|correct|suggest
 .IP \(bu 2
 \fB/reference/executables/groonga\-suggest\-create\-dataset\fP
 .UNINDENT
-.SS table_create
-.SS 名前
+.SS \fBtable_create\fP
+.SS 概要
 .sp
-table_create \- テーブルの追加
-.SS 書式
+\fBtable_create\fP は現在のデータベースに新しいテーブルを作成します。データを保存したり検索したりするために、1つ以上のテーブルを作成する必要があります。
+.SS 構文
+.sp
+\fBtable_create\fP には多くの引数があります。必須の引数は \fBname\fP だけで、残りは省略できます。:
 .sp
 .nf
 .ft C
-table_create name [flags [key_type [value_type [default_tokenizer]]]]
+table_create name
+             [flags=TABLE_HASH_KEY]
+             [key_type=null]
+             [value_type=null]
+             [default_tokenizer=null]
+             [normalizer=null]
 .ft P
 .fi
-.SS 説明
+.SS 使い方
 .sp
-groonga組込コマンドの一つであるtable_createについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+\fBtable_create\fP コマンドは新しく永続テーブルを作成します。テーブルの詳細については \fB/reference/tables\fP を参照してください。
+.SS データ保存用テーブルの作成
 .sp
-table_createコマンドは、使用しているデータベースに対してテーブルを追加します。groongaには名前付きテーブルと名前なしテーブル、永続テーブルと一時テーブルがありますが、table_createコマンドでは、名前付きの永続テーブルのみが作成できます。テーブルはレコードの集合であり、全てのレコードは一意なIDを持ちます。IDはレコードを追加した順序に従って自動的に付与されます。
+データ保存用のテーブルにはどの種類のテーブルでも使えます。テーブルの種類については \fB/reference/tables\fP を参照してください。
 .sp
-テーブルにカラムを追加する時にはcolumn_createコマンドを使用します。また、テーブルを作成した時点でいくつかの疑似カラムが使用可能になっています。
-.SS 引数
+テーブルの型は \fBTABLE_${TYPE}\fP を \fBflags\fP 引数に指定します。
 .sp
-\fBname\fP
-.INDENT 0.0
-.INDENT 3.5
-作成するテーブルの名前を指定します。nameはデータベース内で一意な、未定義の名前でなければなりません。組込型名・組込コマンド名・組込関数名は予約済みであり、テーブル名には 使用できません。また、ピリオド(\(aq.\(aq), コロン(\(aq:\(aq)を含む名前のテーブルは作成できません。
-.UNINDENT
-.UNINDENT
+以下は \fBTABLE_NO_KEY\fP テーブルを使う例です。
 .sp
-\fBflags\fP
-.INDENT 0.0
-.INDENT 3.5
-作成するテーブルの属性を示す数値か、パイプ(\(aq|\(aq)で組み合わせたシンボル名を指定します。(デフォルト値は0(="TABLE_HASH_KEY"))
-.INDENT 0.0
-.INDENT 3.5
-.INDENT 0.0
-.TP
-.B 0, \fBTABLE_HASH_KEY\fP
-主キー値をハッシュ表で管理するテーブルを作成します。ハッシュ表を使用したテーブルでは、主キー値に完全一致するレコードを非常に高速に検索することができます。
-.TP
-.B 1, \fBTABLE_PAT_KEY\fP
-主キー値をパトリシア木で管理するテーブルを作成します。パトリシア木を使用したテーブルでは、主キー値に完全一致するレコードを検索することができるとともに、前方一致するレコード、および最長共通接頭辞となるレコードを高速に検索することができます。また、キー値の昇降順でレコードを取り出したり、キー値の範囲での検索を行うことができます。また、flagsの値に64を加えることによって、後方一致検索も可能となります。
-.TP
-.B 2, \fBTABLE_DAT_KEY\fP
-主キー値をダブル配列で管理するテーブルを作成します。ダブル配列を使用したテーブルでは、主キー値に完全一致するレコードを高速に検索することができるとともに、前方一致するレコード、および最長共通接頭辞となるレコードを検索することができます。また、キー値の昇降順でレコードを取り出したり、キー値の範囲での検索を行うことができます。
-.TP
-.B 3, \fBTABLE_NO_KEY\fP
-主キーを持たないテーブルを作成します。各レコードはIDのみによって特定することができます。
-.TP
-.B 4, \fBTABLE_VIEW\fP
-複数のテーブルをまとめて操作するための仮想的なテーブル(view)を作成します。
-.TP
-.B 64, \fBKEY_WITH_SIS\fP
-語彙表となるパトリシア木型のテーブルにおいて、後方一致検索を可能とします。
-.TP
-.B 128, \fBKEY_NORMALIZE\fP
-ハッシュ表型か、パトリシア木型のテーブルにおいて、主キー値を正規化した上で登録します。この値が指定されたテーブルではたとえば、主キー値\(aqabc\(aqと\(aqABC\(aq は同一のレコードに対応するものとみなされます。
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.UNINDENT
+実行例:
 .sp
-\fBkey_type\fP
-.INDENT 0.0
-.INDENT 3.5
-主キー値の型を指定します。主キー値を持つテーブルに限り有効です。型にはgroongaの組込型か、同一データベースに定義済みのユーザ定義型、定義済みのテーブルを指定することができます。
-.UNINDENT
-.UNINDENT
+.nf
+.ft C
+table_create Logs TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
 .sp
-\fBvalue_type\fP
-.INDENT 0.0
-.INDENT 3.5
-値の型を指定します。tableの値には固定長の型のみが指定できます。(可変長の値が必要な場合は別途カラムを作成します) 型にはgroongaの組込型か、同一データベースに定義済みのユーザ定義型、またはテーブルを指定することができます。(デフォルトはvalueなし)
-.UNINDENT
-.UNINDENT
+この \fBtable_create\fP コマンドは \fBLogs\fP という名前で \fBTABLE_NO_KEY\fP 型のテーブルを作成します。
 .sp
-\fBdefault_tokenizer\fP
-.INDENT 0.0
-.INDENT 3.5
-作成するテーブルを語彙表として使用する場合、文字列を分割するトークナイザを指定します。
+キーでレコードを検索しないのであれば、 \fBTABLE_NO_KEY\fP 型のテーブルが適切です。なぜなら、 \fBTABLE_NO_KEY\fP はキーをサポートしていませんが、速くて小さいサイズのテーブルだからです。ログをgroongaのデータベースに保存するという使い方はこのケースです。
+.sp
+キーでレコードを検索したり、カラムからレコードを参照したりする場合は、 \fBTABLE_NO_KEY\fP 型は適していません。全文検索用の語彙表として使うケースはこのケースです。
+.SS 語彙表テーブルの作成
 .sp
-組込のトークナイザとして、以下が準備されています。
+語彙表テーブル用のテーブルには \fBTABLE_NO_KEY\fP 以外の型のテーブルを使います。語彙表テーブルはキーをサポートしていないといけませんが、 \fBTABLE_NO_KEY\fP はキーをサポートしていません。
+.sp
+以下は \fBTABLE_PAT_KEY\fP テーブルを作る例です。
+.sp
+実行例:
+.sp
+.nf
+.ft C
+table_create Lexicon TABLE_PAT_KEY ShortText \-\-default_tokenizer TokenBigram \-\-normalizer NormalizerAuto
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.sp
+この \fBtable_create\fP コマンドは以下のテーブルを作成します。
 .INDENT 0.0
-.TP
-.B \fBTokenDelimit\fP
-空白で区切られた文字列をトークンとする
-.TP
-.B \fBTokenUnigram\fP
-unigram(1文字を1トークンとする)
-.TP
-.B \fBTokenBigram\fP
-bigram(2文字の文字列要素をトークンとする)
-.TP
-.B \fBTokenTrigram\fP
-trigram(3文字の文字列要素をトークンとする)
-.TP
-.B \fBTokenMecab\fP
-形態素解析器mecabで解析した形態素をトークンとする。(mecabを組み込んだ場合のみ有効)
+.IP \(bu 2
+このテーブルは \fBLexicon\fP という名前です。
+.IP \(bu 2
+このテーブルは \fBTABLE_PAT_KEY\fP 型のテーブルです。
+.IP \(bu 2
+このテーブルのキーは \fBShortText\fP 型です。
+.IP \(bu 2
+このテーブルは正規化されたテキストからトークンを抽出するために \fBTokenBigram\fP トークナイザーを使います。
+.IP \(bu 2
+このテーブルはテキストを正規化するために \fBNormalizerAuto\fP ノーマライザーを使います。
 .UNINDENT
 .sp
-トークナイザが指定されなかった場合は、対象の文字列を分割せずに語彙表に登録します。
-.UNINDENT
-.UNINDENT
-.SS 返値
-.SS json形式
+語彙表テーブルには \fBTABLE_PAT_KEY\fP が適切なテーブルの型です。語彙表テーブルは全文検索に使われます。
+.sp
+全文検索では、あいまい検索をするために前方一致検索を使っています。前方一致検索は \fBTABLE_PAT_KEY\fP と \fBTABLE_DAT_KEY\fP がサポートしています。
+.sp
+全文検索対象のテキストには大量のトークンが含まれるので、語彙表テーブルのキーも大量になります。大量のキーを格納するテーブルの場合はテーブルのサイズを意識する必要があります。これは、大きなテーブルはそれだけ多くのメモリーを必要とするからです。多くのメモリーが必要になると、ディスクI/Oが発生することもあります。ディスクI/Oが発生すると高速に検索できなくなります。そのため、大量のキーがあるテーブルの場合はテーブルのサイズが重要になります。\(ga\(gaTABLE_PAT_KEY\(ga\(ga は \fBTABLE_DAT_KEY\fP よりもテーブルのサイズが小さいです。
+.sp
+上記の理由から、 \fBTABLE_PAT_KEY\fP が語彙表テーブルに適したテーブルの型です。
+.SS タグインデックス用テーブルの作成
+.sp
+タグインデックス用のテーブルには \fBTABLE_NO_KEY\fP 以外の型のテーブルを使えます。タグインデックス用のテーブルはキーのサポートが必要ですが、 \fBTABLE_NO_KEY\fP はキーをサポートしていません。
+.sp
+以下は \fBTABLE_HASH_KEY\fP 型のテーブルを作る例です。
+.sp
+実行例:
 .sp
 .nf
 .ft C
-[成功かどうかのフラグ]
-
-\(ga\(ga成功かどうかのフラグ\(ga\(ga
-
-  エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
+table_create Ages TABLE_DAT_KEY UInt32
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 .ft P
 .fi
-.SS 例
 .sp
-ShortText型の主キーを持つハッシュ表型のテーブル、Entryを作成します。:
+この \fBtable_create\fP コマンドは \fBTags\fP という名前で \fBTABLE_HASH_KEY\fP 型のテーブルを作ります。このテーブルのキーは \fBShortText\fP 型です。
+.sp
+タグインデックス用のテーブルには \fBTABLE_HASH_KEY\fP あるいは \fBTABLE_DAT_KEY\fP が適切なテーブルの型です。
+.sp
+完全一致でタグを検索する機能だけが必要なら、 \fBTABLE_HASH_KEY\fP が適切です。多くの場合はこのケースです。
+.sp
+もし、前方一致検索機能も必要な場合（例えば、 \fB"gr"\fP というキーワードで \fB"groonga"\fP を検索する場合）は、 \fBTABLE_DAT_KEY\fP が適切です。 \fBTABLE_DAT_KEY\fP はサイズの大きなテーブルですが、タグの数はそれほど多くならないので、サイズは重要ではありません。
+.SS 範囲検索用のインデックステーブルの作成
+.sp
+範囲検索用のインデックステーブルには \fBTABLE_PAT_KEY\fP 型と \fBTABLE_DAT_KEY\fP 型を使えます。範囲検索用のインデックステーブルは範囲検索をサポートしている必要がありますが、 \fBTABLE_NO_KEY\fP 型と \fBTABLE_HASH_KEY\fP 型はサポートしていません。
+.sp
+以下は \fBTABLE_DAT_KEY\fP テーブルを作成する例です。
+.sp
+実行例:
 .sp
 .nf
 .ft C
-table_create Entry \-\-key_type ShortText
-[true]
+table_create Ages TABLE_DAT_KEY UInt32
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 .ft P
 .fi
 .sp
-ShortText型の主キーを持つパトリシア木型のテーブル、Termを作成します。主キー値は正規化して管理します。また、このテーブルを語彙表とする転置索引を作成する場合には、バイグラムの索引を作成します。:
+この \fBtable_create\fP コマンドは \fBAges\fP という名前で \fBTABLE_DAT_KEY\fP 型のテーブルを作成します。このテーブルのキーの型は \fBUInt32\fP です。
+.sp
+範囲検索用のインデックステーブルには \fBTABLE_PAT_KEY\fP 型と \fBTABLE_DAT_KEY\fP 型が適切なテーブルの型です。
+.sp
+インデックス対象の項目が少なければ、 \fBTABLE_DAT_KEY\fP 型が適切です。前述の例では、年齢（age）用のインデックスがこのケースになります。年齢のインデックスはせいぜい0から100項目くらいにしかなりません。これは、人はそんなに長生きできないからです。
+.sp
+インデックス対象が大量にある場合は、 \fBTABLE_PAT_KEY\fP 型が適切です。なぜなら、 \fBTABLE_PAT_KEY\fP 型は \fBTABLE_DAT_KEY\fP 型よりもサイズが小さいからです。
+.SS 引数
+.sp
+このセクションではすべての引数について説明します。
+.SS \fBname\fP
+.sp
+作成するテーブル名を指定します。 \fBname\fP は必ず指定しなければいけません。
+.sp
+利用可能な文字は以下の通りです。
+.INDENT 0.0
+.IP \(bu 2
+\fB0\fP .. \fB9\fP （数字）
+.IP \(bu 2
+\fBa\fP .. \fBz\fP （アルファベット。小文字）
+.IP \(bu 2
+\fBA\fP .. \fBZ\fP （アルファベット。大文字）
+.IP \(bu 2
+\fB#\fP （シャープ）
+.IP \(bu 2
+\fB@\fP （アットマーク）
+.IP \(bu 2
+\fB\-\fP （ハイフン）
+.IP \(bu 2
+\fB_\fP （アンダースコア）（注: 最初の文字としてアンダースコアを使うことはできません。）
+.UNINDENT
+.sp
+上記の文字を1つ以上使って名前を決めます。 \fB_name\fP というように、最初の文字に \fB_\fP を使えないことに注意してください。
+.SS \fBflags\fP
+.sp
+テーブルの型とテーブルをカスタマイズするオプションを指定します。
+.sp
+指定可能なフラグは以下の通りです。
+.TS
+center;
+|l|l|.
+_
+T{
+フラグ
+T}	T{
+説明
+T}
+_
+T{
+\fBTABLE_NO_KEY\fP
+T}	T{
+配列テーブル。
+T}
+_
+T{
+\fBTABLE_HASH_HEY\fP
+T}	T{
+ハッシュテーブル。
+T}
+_
+T{
+\fBTABLE_PAT_KEY\fP
+T}	T{
+パトリシアトライ。
+T}
+_
+T{
+\fBTABLE_DAT_KEY\fP
+T}	T{
+ダブル配列トライ。
+T}
+_
+T{
+\fBKEY_WITH_SIS\fP
+T}	T{
+半無限文字列を有効にします。 \fBTABLE_PAT_KEY\fP を使う必要があります。
+T}
+_
+.TE
+.IP ノート
+groonga 2.1.0から \fBKEY_NORMALIZE\fP フラグは非推奨になりました。代わりに、 \fBnormalizer\fP オプションに \fBNormalizerAuto\fP を指定してください。
+.RE
+.sp
+\fBTABLE_${TYPE}\fP フラグのどれか1つを指定します。 \fBTABLE_${TYPE}\fP フラグを2つ以上指定することはできません。例えば、 \fBTABLE_NO_KEY|TABLE_HASH_KEY\fP は不正な指定方法です。
+.sp
+\fBTABLE_PAT_KEY|KEY_WITH_SIS\fP というように、 \fB|\fP （縦棒）で複数のフラグを組み合わせることができます。
+.sp
+それぞれのテーブルの型の違いは \fB/reference/tables\fP を参照してください。
+.sp
+デフォルトのフラグは \fBTABLE_HASH_KEY\fP です。
+.SS \fBkey_type\fP
+.sp
+キーの型を指定します。
+.sp
+\fBflags\fP パラメーターに \fBTABLE_HASH_KEY\fP 、 \fBTABLE_PAT_KEY\fP または \fBTABLE_DAT_KEY\fP を指定した場合は、 \fBkey_type\fP オプションを指定する必要があります。
+.sp
+型の一覧は \fB/reference/types\fP にあります。
+.sp
+デフォルト値はありません。
+.SS \fBvalue_type\fP
+.sp
+値の型を指定します。
+.sp
+\fBflags\fP パラメーターに \fBTABLE_NO_KEY\fP 、 \fBTABLE_HASH_KEY\fP または \fBTABLE_PAT_KEY\fP を指定した場合は「値」を使うことができます。「値」の型は固定長でなければいけません。例えば、 \fBUInt32\fP は使えますが、 \fBShortText\fP は使えません。この場合は値ではなく、カラムを使ってください。
+.sp
+デフォルト値はありません。
+.SS \fBdefault_tokenizer\fP
+.sp
+デフォルトトークナイザーを指定します。これは、検索時とデータロード時に使われます。
+.sp
+\fBTABLE_NO_KEY\fP と一緒に \fBdefault_tokenizer\fP を使うことはできません。これは、 \fBTABLE_NO_KEY\fP をインデックスに使うことができないからです。
+.sp
+全文検索用のインデックスとして使う場合には \fBdefault_tokenizer\fP を必ず指定しなければいけません。
+.sp
+トークナイザーの一覧は \fB/reference/tokenizers\fP にあります。
+.sp
+デフォルト値はありません。
+.SS \fBnormalizer\fP
+.sp
+キーを正規化するために使うノーマライザーを指定します。
+.sp
+\fBTABLE_NO_KEY\fP はキーをサポートしていないので、 \fBTABLE_NO_KEY\fP と \fBnormalizer\fP を一緒に指定することはできません。
+.sp
+ノーマライザーの一覧は \fB/reference/normalizers\fP にあります。
+.sp
+デフォルト値はありません。
+.SS 戻り値
+.sp
+\fBtable_create\fP が成功したときは以下のようにボディは \fBtrue\fP になります:
 .sp
 .nf
 .ft C
-table_create Term \-\-flags TABLE_PAT_KEY|KEY_NORMALIZE \-\-key_type ShortText \-\-default_tokenizer TokenBigram
-[true]
+[HEADER, true]
 .ft P
 .fi
+.sp
+\fBtable_create\fP が失敗すると、エラーの詳細は \fBHEADER\fP に含まれます。
+.sp
+\fBHEADER\fP については \fB/reference/command/output_format\fP を参照してください。
+.SS 参考
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/tables\fP
+.IP \(bu 2
+\fB/reference/commands/column_create\fP
+.IP \(bu 2
+\fB/reference/tokenizers\fP
+.IP \(bu 2
+\fB/reference/normalizers\fP
+.IP \(bu 2
+\fB/reference/command/output_format\fP
+.UNINDENT
 .SS table_list
 .SS 名前
 .sp
@@ -13641,63 +13787,55 @@ table_list
 #       [
 #         "range",
 #         "ShortText"
+#       ],
+#       [
+#         "default_tokenizer",
+#         "ShortText"
+#       ],
+#       [
+#         "normalizer",
+#         "ShortText"
 #       ]
 #     ],
 #     [
 #       259,
-#       "bigram",
-#       "/tmp/groonga\-databases/suggest.0000103",
-#       "TABLE_PAT_KEY|KEY_NORMALIZE|PERSISTENT",
-#       "ShortText",
-#       "null"
-#     ],
-#     [
-#       278,
-#       "event_query",
-#       "/tmp/groonga\-databases/suggest.0000116",
-#       "TABLE_NO_KEY|PERSISTENT",
-#       "null",
-#       "null"
-#     ],
-#     [
-#       258,
-#       "event_type",
-#       "/tmp/groonga\-databases/suggest.0000102",
-#       "TABLE_HASH_KEY|PERSISTENT",
-#       "ShortText",
-#       "null"
-#     ],
-#     [
-#       261,
-#       "item_query",
-#       "/tmp/groonga\-databases/suggest.0000105",
-#       "TABLE_PAT_KEY|KEY_NORMALIZE|PERSISTENT",
-#       "ShortText",
-#       "null"
+#       "Ages",
+#       "/tmp/groonga\-databases/commands_table_create.0000103",
+#       "TABLE_DAT_KEY|PERSISTENT",
+#       "UInt32",
+#       null,
+#       null,
+#       null
 #     ],
 #     [
-#       260,
-#       "kana",
-#       "/tmp/groonga\-databases/suggest.0000104",
-#       "TABLE_PAT_KEY|KEY_NORMALIZE|PERSISTENT",
+#       257,
+#       "Lexicon",
+#       "/tmp/groonga\-databases/commands_table_create.0000101",
+#       "TABLE_PAT_KEY|PERSISTENT",
 #       "ShortText",
-#       "null"
+#       null,
+#       "TokenBigram",
+#       "NormalizerAuto"
 #     ],
 #     [
-#       270,
-#       "pair_query",
-#       "/tmp/groonga\-databases/suggest.000010E",
-#       "TABLE_HASH_KEY|PERSISTENT",
-#       "UInt64",
-#       "null"
+#       256,
+#       "Logs",
+#       "/tmp/groonga\-databases/commands_table_create.0000100",
+#       "TABLE_NO_KEY|PERSISTENT",
+#       null,
+#       null,
+#       null,
+#       null
 #     ],
 #     [
-#       277,
-#       "sequence_query",
-#       "/tmp/groonga\-databases/suggest.0000115",
+#       258,
+#       "Tags",
+#       "/tmp/groonga\-databases/commands_table_create.0000102",
 #       "TABLE_HASH_KEY|PERSISTENT",
 #       "ShortText",
-#       "null"
+#       null,
+#       null,
+#       null
 #     ]
 #   ]
 # ]
@@ -13958,6 +14096,443 @@ groongaのカラムは、ある型のベクターを保存することができ
 脚注
 .IP [1] 5
 Object型はv1.2でサポートされます。
+.SS Tables
+.SS 概要
+.sp
+Table in groonga manages relation between ID and key. Groonga provides
+four table types. They are \fBTABLE_NO_KEY\fP, \fBTABLE_HASH_KEY\fP,
+\fBTABLE_PAT_KEY\fP and \fBTABLE_DAT_KEY\fP.
+.sp
+All table except \fBTABLE_NO_KEY\fP provides both fast ID search by key
+and fast key search by ID. \fBTABLE_NO_KEY\fP doesn\(aqt support
+key. \fBTABLE_NO_KEY\fP only manages ID. So \fBTABLE_NO_KEY\fP doesn\(aqt
+provides ID search and key search.
+.SS Characteristics
+.sp
+Here is a chracteristic table of all tables in groonga. (\fBTABLE_\fP
+prefix is omitted in the table.)
+.TS
+center;
+|l|l|l|l|l|.
+_
+T{
+T}	T{
+\fBNO_KEY\fP
+T}	T{
+\fBHASH_KEY\fP
+T}	T{
+\fBPAT_KEY\fP
+T}	T{
+\fBDAT_KEY\fP
+T}
+_
+T{
+Data
+structure
+T}	T{
+配列
+T}	T{
+Hash table
+T}	T{
+Patricia
+trie
+T}	T{
+Double
+array
+trie
+T}
+_
+T{
+ID
+support
+T}	T{
+o
+T}	T{
+o
+T}	T{
+o
+T}	T{
+o
+T}
+_
+T{
+Key
+support
+T}	T{
+x
+T}	T{
+o
+T}	T{
+o
+T}	T{
+o
+T}
+_
+T{
+Value
+support
+T}	T{
+o
+T}	T{
+o
+T}	T{
+o
+T}	T{
+x
+T}
+_
+T{
+Key \-> ID
+speed
+(o \-> fast)
+(x \-> slow)
+T}	T{
+.INDENT 0.0
+.IP \(bu 2
+.UNINDENT
+T}	T{
+oo
+T}	T{
+x
+T}	T{
+o
+T}
+_
+T{
+Update
+speed
+(o \-> fast)
+(x \-> slow)
+T}	T{
+ooo
+T}	T{
+o
+T}	T{
+o
+T}	T{
+x
+T}
+_
+T{
+Size
+(o \-> small)
+(x \-> large)
+T}	T{
+ooo
+T}	T{
+o
+T}	T{
+oo
+T}	T{
+x
+T}
+_
+T{
+Key
+update
+T}	T{
+.INDENT 0.0
+.IP \(bu 2
+.UNINDENT
+T}	T{
+x
+T}	T{
+x
+T}	T{
+o
+T}
+_
+T{
+Common
+prefix
+search
+T}	T{
+.INDENT 0.0
+.IP \(bu 2
+.UNINDENT
+T}	T{
+x
+T}	T{
+o
+T}	T{
+o
+T}
+_
+T{
+Predictive
+search
+T}	T{
+.INDENT 0.0
+.IP \(bu 2
+.UNINDENT
+T}	T{
+x
+T}	T{
+o
+T}	T{
+o
+T}
+_
+T{
+範囲検索
+T}	T{
+.INDENT 0.0
+.IP \(bu 2
+.UNINDENT
+T}	T{
+x
+T}	T{
+o
+T}	T{
+o
+T}
+_
+.TE
+.SS \fBTABLE_NO_KEY\fP
+.sp
+\fBTABLE_NO_KEY\fP is very fast and very small but it doesn\(aqt support
+key. \fBTABLE_NO_KEY\fP is a only table that doesn\(aqt support key.
+.sp
+You cannot use \fBTABLE_NO_KEY\fP for lexicon for fulltext search
+because lexicon stores tokens as key. \fBTABLE_NO_KEY\fP is useful for
+no key records such as log.
+.SS \fBTABLE_HASH_KEY\fP
+.sp
+\fBTABLE_HASH_KEY\fP is fast but it doesn\(aqt support advanced search
+functions such as common prefix search and predictive search.
+.sp
+\fBTABLE_HASH_KEY\fP is useful for index for exact search such as tag
+search.
+.SS \fBTABLE_PAT_KEY\fP
+.sp
+\fBTABLE_PAT_KEY\fP is small and supports advanced search functions.
+.sp
+\fBTABLE_PAT_KEY\fP is useful for lexicon for fulltext search and
+index for range search.
+.SS \fBTABLE_DAT_KEY\fP
+.sp
+\fBTABLE_DAT_KEY\fP is fast and supports key update but it is large. It
+is not suitable for storing many records. \fBTABLE_DAT_KEY\fP is a only
+table that supports key update.
+.sp
+\fBTABLE_DAT_KEY\fP is used in groonga database. Groonga database needs
+to convert object name such as \fBShortText\fP, \fBTokenBigram\fP and
+table names to object ID. And groonga database needs to rename object
+name. Those features are implemented by \fBTABLE_DAT_KEY\fP. The number
+of objects is small. So large data size demerit of \fBTABLE_DAT_KEY\fP
+can be ignored.
+.SS Record ID
+.sp
+Record ID is assigned automatically. You cannot assign record ID.
+.sp
+Record ID of deleted record may be reused.
+.sp
+Valid record ID range is between 1 and 268435455. (1 and 268435455 are
+valid IDs.)
+.SS Persistent table and temporary table
+.sp
+Table is persistent table or temporary table.
+.SS Persistent table
+.sp
+Persistent table is named and registered to database. Records in
+persistent table aren\(aqt deleted after closing table or
+database.
+.sp
+Persistent table can be created by
+\fB/reference/commands/table_create\fP command.
+.SS Temporary table
+.sp
+Temporary table is anonymous. Records in temporary table are deleted
+after closing table. Temporary table is used to store search result,
+sort result, group (drilldown) result and so on. \fBTABLE_HASH_KEY\fP is
+used for search result and group result. \fBTABLE_NO_KEY\fP is used for
+sort result.
+.SS 制限
+.sp
+The max number of records is 268435455. You cannot add 268435456 or
+more records in a table.
+.sp
+The max number of a key size is 4096byte. You cannot use 4097byte or
+larger key. You can use column instead of key for 4097byte or larger
+size data. \fBText\fP and \fBLargeText\fP types supports 4097byte or
+larger size data.
+.sp
+The max number of total key size is 4GiB. You need to split a table,
+split a database (sharding) or reduce each key size to handle 4GiB or
+more larger total key size.
+.SS 参考
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/commands/table_create\fP
+.UNINDENT
+.SS Normalizers
+.SS 概要
+.sp
+Groonga has normalizer module. It is used when tokenizing text and
+storing table key. For example, \fBA\fP and \fBa\fP are processed as the
+same character after normalization.
+.sp
+Normalizer module can be added as a plugin. You can customize text
+normalization by registering your normalizer plugins to groonga.
+.sp
+A normalizer module is attached to a table. A table can have zero or
+one normalizer module. You can attach a normalizer module to a table
+by \fItable\-create\-normalizer\fP option in
+\fB/reference/commands/table_create\fP.
+.sp
+Here is an example \fBtable_create\fP that uses \fBNormalizerAuto\fP
+normalizer module:
+.sp
+実行例:
+.sp
+.nf
+.ft C
+table_create Dictionary TABLE_HASH_KEY ShortText \-\-normalizer NormalizerAuto
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.IP ノート
+Groonga 2.0.9 or earlier doesn\(aqt have \fB\-\-normalizer\fP option in
+\fBtable_create\fP. \fBKEY_NORMALIZE\fP flag was used instead.
+.sp
+You can open an old database by groonga 2.1.0 or later. An old
+database means that the database is created by groonga 2.0.9 or
+earlier. But you cannot open the opened old database by groonga
+2.0.9 or earlier. Once you open the old database by groonga 2.1.0
+or later, \fBKEY_NORMALIZE\fP flag information in the old database is
+converted to normalizer information. So groogna 2.0.9 or earlier
+cannot find \fBKEY_NORMALIZE\fP flag information in the opened old
+database.
+.RE
+.sp
+Keys of a table that has a normalizer module are normalized:
+.sp
+実行例:
+.sp
+.nf
+.ft C
+load \-\-table Dictionary
+[
+{"_key": "Apple"},
+{"_key": "black"},
+{"_key": "COLOR"}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 3]
+select Dictionary
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           "_id",
+#           "UInt32"
+#         ],
+#         [
+#           "_key",
+#           "ShortText"
+#         ]
+#       ],
+#       [
+#         1,
+#         "apple"
+#       ],
+#       [
+#         2,
+#         "black"
+#       ],
+#       [
+#         3,
+#         "color"
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.sp
+\fBNormalizerAuto\fP normalizer normalizes a text as a downcased text.
+For example, \fB"Apple"\fP is normalized to \fB"apple"\fP, \fB"black"\fP is
+normalized to \fB"blank"\fP and \fB"COLOR"\fP is normalized to
+\fB"color"\fP.
+.sp
+If a table is a lexicon for fulltext search, tokenized tokens are
+normalized. Because tokens are stored as table keys. Table keys are
+normalized as described above.
+.SS Built\-in normalizers
+.sp
+Here is a list of built\-in\-normalizers:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+\fBNormalizerAuto\fP
+.IP \(bu 2
+\fBNormalizerNFKC51\fP
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.SS \fBNormalizerAuto\fP
+.sp
+Normally you should use \fBNormalizerAuto\fP
+normalizer. \fBNormalizerAuto\fP was the normalizer for groonga 2.0.9 or
+earlier. \fBKEY_NORMALIZE\fP flag in \fBtable_create\fP on groonga 2.0.9
+or earlier equals to \fB\-\-normalizer NormalizerAuto\fP option in
+\fBtable\fP on groonga 2.1.0 or later.
+.sp
+\fBNormalizerAuto\fP supports all encoding. It uses Unicode NFKC
+(Normalization Form Compatibility Composition) for UTF\-8 encoding
+text. It uses encoding specific original normalization for other
+encodings. The results of those original normalization are similar to
+NFKC.
+.sp
+For example, half\-width katakana (such as U+FF76 HALFWIDTH KATAKANA
+LETTER KA) + half\-width katakana voiced sound mark (U+FF9E HALFWIDTH
+KATAKANA VOICED SOUND MARK) is normalized to full\-width katakana with
+voiced sound mark (U+30AC KATAKANA LETTER GA). The former is two
+chracters but the latter is one character.
+.sp
+Here is an example that uses \fBNormalizerAuto\fP normalizer:
+.sp
+実行例:
+.sp
+.nf
+.ft C
+table_create NormalLexicon TABLE_HASH_KEY ShortText \-\-normalizer NormalizerAuto
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.SS \fBNormalizerNFKC51\fP
+.sp
+\fBNormalizerNFKC51\fP normalizes texts by Unicode NFKC (Normalization
+Form Compatibility Composition) for Unicode version 5.1. It supports
+only UTF\-8 encoding.
+.sp
+Normally you don\(aqt need to use \fBNormalizerNFKC51\fP explicitly. You can
+use \fBNormalizerAuto\fP instead.
+.sp
+Here is an example that uses \fBNormalizerNFKC51\fP normalizer:
+.sp
+実行例:
+.sp
+.nf
+.ft C
+table_create NFKC51Lexicon TABLE_HASH_KEY ShortText \-\-normalizer NormalizerNFKC51
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.SS 参考
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/commands/table_create\fP
+.UNINDENT
 .SS Tokenizers
 .sp
 TODO: Write me.
@@ -15698,7 +16273,7 @@ select Entries \-\-filter \(aqn_likes < 5 && (content @ "senna" || content @ "fa
 .sp
 \fBname(argument1, argument2, ...)\fP は \fBname\fP という関数を引数 \fBargument1\fP, \fBargument2\fP, \fB...\fP で呼び出します。
 .sp
-利用可能な関数の一覧は \fB/reference/functions/\fP を参照してください。
+利用可能な関数の一覧は \fB/reference/function\fP を参照してください。
 .sp
 以下は簡単な使用例です。
 .sp
@@ -17434,14 +18009,14 @@ select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("1
 .sp
 GeoPoint型の値を指定することができます。 [1]
 .sp
-GeoPointについては \fB/reference/type\fP を参照してください。
+GeoPointについては \fB/reference/types\fP を参照してください。
 .SS \fBpoint2\fP
 .sp
 計算しようとしている二点間の終了地点を指定します。
 .sp
 GeoPoint型の値か座標を表す文字列を指定することができます。
 .sp
-GeoPointと座標については \fB/reference/type\fP を参照してください。
+GeoPointと座標については \fB/reference/types\fP を参照してください。
 .SS 省略可能引数
 .sp
 省略可能な引数として \fBapproximate_type\fP があります。
@@ -19384,13 +19959,13 @@ Travis CI上でgroongaを使っているオープンソースソフトウェア
 groongaプロジェクトではみなさんからのコントリビュートを歓迎します！コントリビュートの方法はいくつもあります。groongaを使ったり誰かに紹介することもコントリビュートですし、バグレポートを送ったり、groonga本体やgroonga関連の開発に参加することもコントリビュートです。プログラムではなく、ドキュメントでのコントリビュートも歓迎します！
 .INDENT 0.0
 .TP
-.B ユーザーの立場で:
+.B As a user:
 このドキュメントを読んでください。
 .TP
-.B 布教する立場で:
+.B As a spokesman:
 groongaについてまわりの人に話してください。
 .TP
-.B 開発者の立場で: 不具合報告や開発、ドキュメント
+.B As a developer: Bug report, development and documentation
 これらについてはこのセクションで説明します。
 .UNINDENT
 .SS バグレポートの送り方