Kouhei Sutou
null+****@clear*****
Fri Oct 14 19:26:02 JST 2016
Kouhei Sutou 2016-10-14 19:26:02 +0900 (Fri, 14 Oct 2016) New Revision: 22ad39696f687af4dadf9bfd9abc3d4b70afeef8 https://github.com/groonga/groonga/commit/22ad39696f687af4dadf9bfd9abc3d4b70afeef8 Message: doc column_create: translate to Japanese Modified files: doc/locale/ja/LC_MESSAGES/reference.po doc/source/reference/commands/column_create.rst Modified: doc/locale/ja/LC_MESSAGES/reference.po (+943 -129) =================================================================== --- doc/locale/ja/LC_MESSAGES/reference.po 2016-10-14 19:03:42 +0900 (102dc82) +++ doc/locale/ja/LC_MESSAGES/reference.po 2016-10-14 19:26:02 +0900 (3f7ddf6) @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: 1.2.1\n" "Report-Msgid-Bugs-To: \n" -"PO-Revision-Date: 2016-08-31 19:34+0900\n" +"PO-Revision-Date: 2016-10-14 19:25+0900\n" "Last-Translator: Masafumi Yokoyama <yokoyama �� clear-code.com>\n" "Language-Team: Japanese\n" "Language: ja\n" @@ -4475,150 +4475,1034 @@ msgstr "" "``HEADER`` については :doc:`/reference/command/output_format` を参照してくだ" "さい。" +msgid "" +"The number of kinds of index target data and the number of handleable " +"records in a small index column" +msgstr "" +"インデックス対象データの種類数と小さなインデックスカラムで扱えるレコード数" + msgid "``column_create``" msgstr "" -msgid "column_create - カラムの追加" +msgid "``column_create`` creates a new column in a table." +msgstr "``column_create`` はテーブルに新しいカラムを作成します。" + +msgid "" +"You need to create one or more columns to store multiple data in one record." msgstr "" +"1つのレコードに複数の値を保存したい場合は1つ以上カラムを作成する必要がありま" +"す。" msgid "" -"Groonga組込コマンドの一つであるcolumn_createについて説明します。組込コマンド" -"は、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバに" -"リクエストを送信することによって実行します。" +"Groonga provides an index as a column. It's different from other systems. An " +"index is just an index in other systems. Implementing an index as a column " +"provides flexibility. For example, you can add metadata to each token." +msgstr "" +"Groongaはインデックスをカラムとして提供しています。これは他のシステムと異なり" +"ます。他のシステムではインデックスはインデックスです。インデックスをカラムと" +"して実装していることで高い柔軟性を実現しています。たとえば、各トークンにメタ" +"データを追加することができます。" + +msgid "See :doc:`/reference/column` for column details." +msgstr "カラムの詳細は :doc:`/reference/column` を見てください。" + +msgid "This command takes many parameters." +msgstr "このコマンドにはたくさんの引数があります。" + +msgid "Most parameters are required::" +msgstr "多くの引数は必須です::" + +msgid "This section describes about the followings:" +msgstr "このセクションでは次のことについて説明します。" + +msgid ":ref:`column-create-scalar`" +msgstr "" + +msgid ":ref:`column-create-vector`" +msgstr "" + +msgid ":ref:`column-create-vector-weight`" +msgstr "" + +msgid ":ref:`column-create-reference`" +msgstr "" + +msgid ":ref:`column-create-index`" +msgstr "" + +msgid ":ref:`column-create-index-full-text-search`" +msgstr "" + +msgid ":ref:`column-create-index-multiple-columns`" +msgstr "" + +msgid ":ref:`column-create-index-small`" +msgstr "" + +msgid ":ref:`column-create-index-medium`" msgstr "" msgid "" -"column_createは、使用しているデータベースのテーブルに対してカラムを追加しま" +"Here is the ``People`` table definition. The ``People`` table is used in " +"examples:" +msgstr "" +"以下は ``People`` テーブルの定義です。例ではこの ``People`` テーブルを使いま" "す。" + +msgid "Create a scalar column" +msgstr "スカラーカラムを作成" + +msgid "" +"Groonga provides scalar column to store one value. For example, scalar " +"column should be used for storing age into a person record. Because a person " +"record must have only one age." msgstr "" +"Groongaは1つの値を保存する用途としてスカラーカラムを提供しています。たとえ" +"ば、「人」レコードに「年齢」情報を保存するときはスカラーカラムが適切です。な" +"ぜなら「人」レコードは「年齢」を1つだけ持つからです。" -msgid "テーブルEntryに、ShortText型の値を格納するカラム、bodyを作成します。::" +msgid "" +"If you want to store multiple values into a record, scalar column isn't " +"suitable. Use :ref:`column-create-vector` instead." msgstr "" +"1つのレコードに複数の値を保存したい場合には、スカラーカラムは適していません。" +"代わりに :ref:`column-create-vector` を使ってください。" msgid "" -"テーブルTermに、Entryテーブルのbodyカラムの値を対象とする完全転置インデックス" -"型カラム、entry_bodyを作成します。::" +"You must specify ``COLUMN_SCALAR`` to the ``flags`` parameter to create a " +"scalar column." msgstr "" +"スカラーカラムを作成するには ``flags`` 引数に ``COLUMN_SCALAR`` を指定しま" +"す。" -msgid "``table``" +msgid "" +"Here is an example to create the ``age`` column to the ``People`` table. " +"``age`` column is a scalar column. It can store one ``UInt8`` (``0-255``) " +"value as its value:" +msgstr "" +"以下は ``People`` テーブルに ``age`` カラムを作成する例です。 ``age`` カラム" +"はスカラーカラムです。このカラムには ``UInt8`` （ ``0-255`` ）の値を1つ保存で" +"きます。" + +msgid "You can store one value (``7``) by the following :doc:`load` command:" +msgstr "以下の :doc:`load` コマンドで1つの値（ ``7`` ）を保存できます。" + +msgid "" +"You can confirm the stored one value (``7``) by the following :doc:`select` " +"command:" +msgstr "" +"以下の :doc:`select` コマンドで保存された1つの値（ ``7`` ）を確認できます。" + +msgid "Create a vector column" +msgstr "ベクターカラムを作成" + +msgid "" +"Groonga provides vector column to store multiple values. For example, vector " +"column may be used for storing roles into a person record. Because a person " +"record may have multiple roles." +msgstr "" +"Groongaは複数の値を保存する用途としてベクターカラムを提供しています。たとえ" +"ば、「人」レコードに複数の「役割」を保存する場合はベクターカラムが適切です。" +"なぜなら「人」レコードは複数の「役割」を持つかもしれないからです。" + +msgid "" +"If you want to store only one value into a record, vector column isn't " +"suitable. Use :ref:`column-create-scalar` instead." +msgstr "" +"もし1つのレコードに値を1つだけ保存したい場合はベクターカラムは向いていませ" +"ん。代わりに :ref:`column-create-scalar` を使ってください。" + +msgid "" +"You must specify ``COLUMN_VECTOR`` to the ``flags`` parameter to create a " +"vector column." +msgstr "" +"ベクターカラムを作成するには ``flags`` パラメーターに ``COLUMN_VECTOR`` を指" +"定します。" + +msgid "" +"Here is an example to create the ``roles`` column to the ``People`` table. " +"``roles`` column is a vector column. It can store zero or more ``ShortText`` " +"values as its value:" +msgstr "" +"以下は ``People`` テーブルに ``roles`` カラムを作成する例です。 ``roles`` カ" +"ラムはベクターカラムです。カラムの値として0個以上の ``ShortText`` の値を保存" +"できます。" + +msgid "" +"You can store multiple values (``[\"adventurer\", \"younger-sister\"]``) by " +"the following :doc:`load` command:" +msgstr "" +"以下の :doc:`load` コマンドで複数の値（ ``[\"adventurer\", \"younger-sister" +"\"]`` ）を保存できます。" + +msgid "" +"You can confirm the stored multiple values (``[\"adventurer\", \"younger-" +"sister\"]``) by the following :doc:`select` command:" +msgstr "" +"保存した複数の値（ ``[\"adventurer\", \"younger-sister\"]`` ）は以下の :doc:" +"`select` コマンドで確認できます。" + +msgid "Create a weight vector column" +msgstr "重み付きベクターカラムの作成" + +msgid "TODO: See also :ref:`weight-vector-column` and :ref:`select-adjuster`." +msgstr "" + +msgid "Create a column that refers a table's record" +msgstr "テーブルのレコードを参照するカラムを作成" + +msgid "" +"Both scalar column and vector column can store reference to record of an " +"existing table as column value. It's useful to store relationship between " +"records." +msgstr "" +"スカラーカラムもベクターカラムも既存のテーブルのレコードへの参照を保存するこ" +"とができます。これはレコード間の参照関係を保存する場合に便利です。" + +msgid "" +"For example, using a column that refers a person record is better for " +"storing a character into a book record. Because one person may be appeared " +"in some books." +msgstr "" +"たとえば、「本」レコードで登場人物を保存する場合は、「人」レコードを参照する" +"カラムを使うとよいです。なぜなら、同じ「人」が複数の本に登場するかもしれない" +"からです。" + +msgid "" +"You must specify table name to be referenced to the ``type`` parameter to " +"create a column that refers a table's record." +msgstr "" +"テーブルのレコードを参照するカラムを作成するには ``type`` パラメーターに参照" +"するテーブルの名前を指定します。" + +msgid "" +"Here is an example to create the ``character`` column to the ``Books`` " +"table. The ``character`` column refers the ``People`` table. It can store " +"one ``People`` table's record." +msgstr "" +"以下は ``Books`` テーブルに ``character`` カラムを作成する例です。 " +"``character`` カラムは ``People`` テーブルを参照しています。 ``character`` カ" +"ラムには ``People`` テーブルのレコードを1つ保存できます。" + +msgid "Here is the ``Books`` table definition:" +msgstr "以下が ``Books`` テーブルの定義です。" + +msgid "" +"Here is the ``character`` column definition in the ``Books`` table. ``--type " +"People`` is important:" +msgstr "" +"以下は ``Books`` テーブルにある ``character`` カラムの定義です。 ``--type " +"People`` がポイントです。" + +msgid "" +"You can store one reference (``\"alice\"``) by the following :doc:`load` " +"command. You can use key value (``People._key`` value) for referring a " +"record:" +msgstr "" +"以下の :doc:`load` コマンドで1つの参照（ ``\"alice\"`` ）を保存できます。レ" +"コードを参照するにはキーの値（ ``People._key`` の値）を使います。" + +msgid "" +"You can confirm the stored reference (``\"alice\"`` record) by the " +"following :doc:`select` command. It retrieves the ``age`` column and the " +"``roles`` column values:" +msgstr "" +"保存した参照（ ``\"alice\"`` レコード）は以下の :doc:`select` コマンドで確認" +"できます。以下の例では ``age`` カラムの値と ``roles`` カラムの値を取得してい" +"ます。" + +msgid "Create an index column" +msgstr "インデックスカラムを作成" + +msgid "" +"Groonga provides index column for fast search. It doesn't store your data. " +"It stores data for fast search." +msgstr "" +"Groongaは高速に検索する用途としてインデックスカラムを提供しています。インデッ" +"クスカラムはあなたのデータを保存しません。インデックスカラムは高速な検索に必" +"要なデータを保存します。" + +msgid "" +"You don't need to update index column by yourself. Index column is updated " +"automatically when you store data into a data column (scalar column or " +"vector column) that is marked as index target column. You can set multiple " +"columns as index target columns to one index column." +msgstr "" +"インデックスカラムは自分で更新する必要はありません。インデックス対象のデータ" +"カラム（スカラーカラムまたはベクターカラム）にデータを入れると、インデックス" +"カラムは自動で更新されます。1つのインデックスカラムに複数のインデックス対象の" +"カラムを指定することもできます。" + +msgid "" +"If Groonga has an index column for the ``age`` column of the ``People`` " +"table, Groonga can do fast equal search, fast comparison search and fast " +"range search against ``age`` column values." +msgstr "" +"もし、 ``People`` テーブルの ``age`` カラム用のインデックスカラムがあると、 " +"``age`` カラムの値に対する完全一致検索・比較検索・範囲検索を高速に処理するこ" +"とができます。" + +msgid "You must specify the following parameters to create an index column:" +msgstr "インデックスカラムを作成するには次のパラメーターを指定します。" + +msgid "The ``flags`` parameter: ``COLUMN_INDEX``" +msgstr "``flags`` パラメーター： ``COLUMN_INDEX``" + +msgid "" +"The ``type`` parameter: The table name of index target column such as " +"``People``" +msgstr "" +"``type`` パラメーター： インデックス対象カラムのテーブル名（たとえば " +"``People`` ）" + +msgid "The ``source`` parameter: The index target column name such as ``age``" +msgstr "``source`` パラメーター：インデックス対象カラム名（たとえば ``age`` ）" + +msgid "" +"You don't need additional flags to the ``flags`` parameter for equal search, " +"comparison search and range search index column. You need additional flags " +"to the ``flags`` parameter for full text search index column or multiple " +"column index column. See :ref:`column-create-index-full-text-search` and :" +"ref:`column-create-index-multiple-columns` for details." +msgstr "" +"完全一致検索・比較検索・範囲検索用のインデックスカラムには ``flags`` パラメー" +"ターに追加のフラグは必要ありません。全文検索用のインデックスカラム、マルチカ" +"ラムインデックスカラムには追加のフラグが必要になります。詳細は :ref:`column-" +"create-index-full-text-search` と :ref:`column-create-index-multiple-" +"columns` を見てください。" + +msgid "" +"Here is an example to create an index column for the ``age`` column of the " +"``People`` table." +msgstr "" +"以下は ``People`` テーブルの ``age`` カラム用のインデックスカラムを作成する例" +"です。" + +msgid "" +"First, you need to create a table for range index column. See :ref:`table-" +"create-range-index-table` for details. This example creates the ``Ages`` " +"table as :ref:`table-pat-key`:" +msgstr "" +"はじめに範囲インデックスカラム用のテーブルを作成します。詳細は :ref:`table-" +"create-range-index-table` を見てください。この例では :ref:`table-pat-key` と" +"して ``Ages`` テーブルを作成します。" + +msgid "" +"Now, you can create an index column for the ``age`` column of the ``People`` " +"table. ``COLUMN_INDEX`` in the ``flags`` parameter, ``People`` in the " +"``type`` parameter and ``age`` in the ``source`` parameter are important:" +msgstr "" +"これで ``People`` テーブルの ``age`` カラム用のインデックスカラムを作れるよう" +"になりました。 ``flags`` パラメーターの ``COLUMN_INDEX`` 、 ``type`` パラメー" +"ターの ``People`` 、 ``source`` パラメーターの ``age`` がポイントです。" + +msgid "" +"You can confirm that ``age > 5`` is evaluated by the ``Ages." +"people_age_index`` newly created index column from log. Groonga reports used " +"index columns in ``info`` log level. You can change log level dynamically " +"by :doc:`log_level` command." +msgstr "" +"ログを確認すると、新しく作成した ``Ages.people_age_index`` インデックスカラム" +"を使って ``age > 5`` を評価していることがわかります。Groongaは使用したイン" +"デックスカラムを ``info`` ログレベルでログに出力します。ログレベルは :doc:" +"`log_level` コマンドを使うと動的に変更できます。" + +msgid "" +"You can confirm that the ``Ages.people_age_index`` is used from the " +"following log::" +msgstr "" +"以下のログから ``Ages.people_age_index`` が使われたことを確認できます。" + +msgid "" +"The log says ``Ages.people_age_index`` index column is used for range search." +msgstr "" +"このログは範囲検索に ``Ages.people_age_index`` インデックスカラムを使ったこと" +"を示しています。" + +msgid "Create an index column for full text search" +msgstr "全文検索用のインデックスカラムを作成" + +msgid "" +"There is a difference between for non full text search (equal search, " +"comparison search or range search) index column and for full text search " +"index column. You need to add ``WITH_POSITION`` to the ``flags`` parameter. " +"It means that you need to specify ``COLUMN_INDEX|WITH_POSITION`` to the " +"``flags`` parameter. It's the difference." +msgstr "" +"非全文検索（完全一致検索・比較検索・範囲検索）用インデックスカラムと全文検索" +"用インデックスカラムには1つ違いがあります。全文検索用インデックスカラムでは " +"``flags`` パラメーターに ``WITH_POSITION`` を追加する必要があります。つま" +"り、 ``flags`` パラメーターに ``COLUMN_INDEX|WITH_POSITION`` を指定するという" +"ことです。これが違いです。" + +msgid "" +"Here is an example to create a full text search index column for the " +"``roles`` column of the ``People`` table." +msgstr "" +"以下は ``People`` テーブルの ``roles`` カラム用の全文検索インデックスカラムを" +"作成する例です。" + +msgid "" +"First, you need to create a table for full text search index column. See :" +"ref:`table-create-lexicon` for details. This example creates the ``Terms`` " +"table as :ref:`table-pat-key` with :ref:`token-bigram` tokenizer and :ref:" +"`normalizer-auto` normalizer:" +msgstr "" +"はじめに全文検索インデックスカラム用のテーブルを作成します。詳細は :ref:" +"`table-create-lexicon` を見てください。この例では :ref:`table-pat-key` に :" +"ref:`token-bigram` トークナイザーと :ref:`normalizer-auto` ノーマライザーを指" +"定した ``Terms`` テーブルを作成しています。" + +msgid "" +"Now, you can create a full text search index column for the ``roles`` column " +"of the ``People`` table. ``COLUMN_INDEX|WITH_POSITION`` in the ``flags`` " +"parameter, ``People`` in the ``type`` parameter and ``roles`` in the " +"``source`` parameter are important:" +msgstr "" +"これで ``Poeple`` テーブルの ``roles`` カラム用の全文検索インデックスカラムを" +"作成できるようになりました。 ``flags`` パラメーターの ``COLUMN_INDEX|" +"WITH_POSITION`` 、 ``type`` パラメーターの ``People`` 、 ``source`` パラメー" +"ターの ``roles`` がポイントです。" + +msgid "" +"You can confirm that ``--match_columns roles`` and ``--query Sister`` are " +"evaluated by the ``Terms.people_roles_index`` newly created full text search " +"index column from log. Groonga reports used index columns in ``info`` log " +"level. You can change log level dynamically by :doc:`log_level` command." +msgstr "" +"ログを確認すると、新しく作成した ``Terms.people_roles_index`` 全文検索イン" +"デックスカラムで ``--match_columns roles`` と ``--query Sister`` を処理してい" +"ることがわかります。Groongaは使用したインデックスカラムを ``info`` ログレベル" +"でログに出力します。ログレベルは :doc:`log_level` コマンドを使うと動的に変更" +"できます。" + +msgid "" +"You can confirm that the ``Terms.people_roles_index`` is used from the " +"following log::" +msgstr "" +"以下のログから ``Terms.people_roles_index`` を使ったことを確認できます。" + +msgid "" +"The log says ``Terms.people_roles_index`` index column is used for full text " +"search. (To be precise, the index column is used for exact term search by " +"inverted index.)" +msgstr "" +"このログは全文検索に ``Terms.people_roles_index`` インデックスカラムを使った" +"ことを示しています。（正確に言うと転置索引を使った完全一致検索にこのインデッ" +"クスカラムを使っています。）" + +msgid "Create a multiple columns index column" +msgstr "マルチカラムインデックスカラムを作成" + +msgid "" +"You can create an index column for multiple columns. It means that you can " +"do fast search for multiple columns with one index column. Multiple columns " +"index column has better space efficiency than single column index column " +"only when multiple columns have many same tokens. Multiple columns index " +"column may be slower than single column index column. Because multiple " +"columns index column will be a bigger index column." +msgstr "" +"複数のカラム用のインデックスカラムを作成できます。これは1つのインデックスカラ" +"ムで複数のカラムに対して高速に検索できるということです。インデックス対象の複" +"数のカラムが多くの同じトークンを共有しているときは、マルチカラムインデックス" +"カラムはシングルカラムインデックスカラムよりも空間効率がよくなります。一方、" +"検索速度はシングルから無インデックスカラムの方が速くなることが多いです。理由" +"はマルチカラムインデックスカラムは大きくなりがちだからです。" + +msgid "" +"You can't use multiples columns in different tables as index target columns " +"in the same multiple columns index column. You must specify columns in the " +"same tables as index target columns to one multiple columns index column. " +"For example, you can't create a multiple columns index for ``People._key`` " +"and ``Books._key`` because they are columns of different tables. You can " +"create a multiple columns index column for ``People._key`` and ``People." +"roles`` because they are columns of the same table." +msgstr "" +"1つのマルチカラムインデックスカラムで、異なるテーブルの複数のカラムをインデッ" +"クス対象にすることはできません。1つのマルチカラムインデックスカラムでは同じ" +"テーブルの複数のカラムをインデックス対象に指定してください。たとえば、 " +"``People._key`` と ``Books._key`` をインデックス対象としたマルチカラムイン" +"デックスカラムは作成できません。なぜなら、違うテーブルのカラムだからです。 " +"``People._key`` と ``People.roles`` をインデックス対象としたマルチカラムイン" +"デックスカラムは作成できます。なぜなら同じテーブルのカラムだからです。" + +msgid "" +"There is a difference between for single column index column and for " +"multiple columns index column. You need to add ``WITH_SECTION`` to the " +"``flags`` parameter. It means that you need to specify ``COLUMN_INDEX|" +"WITH_SECTION`` to the ``flags`` parameter. It's the difference." +msgstr "" +"シングルカラムインデックスカラムとマルチカラムインデックスカラムでは違いがあ" +"ります。マルチカラムインデックスカラムのときは ``flags`` パラメーターに " +"``WITH_SECTION`` を追加しなければいけません。つまり、 ``flags`` パラメーター" +"に ``COLUMN_INDEX|WITH_SECTION`` と指定するということです。これが違いです。" + +msgid "" +"If you want to create a multiple columns index column for full text search, " +"you need to specify ``COLUMN_INDEX|WITH_POSITION|WITH_SECTION`` to the " +"``flags`` parameter. See :ref:`column-create-index-full-text-search` for " +"full text search index column details." +msgstr "" +"全文検索用のマルチカラムインデックスカラムを作成する場合は ``flags`` パラメー" +"ターに ``COLUMN_INDEX|WITH_POSITION|WITH_SECTION`` と指定します。全文検索イン" +"デックスカラムの詳細は :ref:`column-create-index-full-text-search` を見てくだ" +"さい。" + +msgid "" +"Here is an example to create a multiple columns full text search index " +"column for the key of the ``People`` table and the ``roles`` column of the " +"``People`` table." +msgstr "" +"以下は ``People`` テーブルのキーと ``roles`` カラム用のマルチカラム全文検索イ" +"ンデックスカラムを作成する例です。" + +msgid "" +"There is no difference between index table for single column index column " +"and multiple columns index column. In this example, the ``Terms`` table " +"created at :ref:`column-create-index-full-text-search` is used." +msgstr "" +"インデックス用のテーブルは、シングルカラムインデックスとマルチカラムインデッ" +"クスカラムで違いはありません。この例では :ref:`column-create-index-full-text-" +"search` で使った ``Terms`` テーブルを使います。" + +msgid "" +"You can create a multiple columns full text search index column for the key " +"of the ``People`` table and ``roles`` column of the ``People`` table. " +"``COLUMN_INDEX|WITH_POSITION|WITH_SECTION`` in the ``flags`` parameter, " +"``People`` in the ``type`` parameter and ``_key,roles`` in the ``source`` " +"parameter are important:" +msgstr "" +"``People`` テーブルのキーと ``roles`` カラム用のマルチカラム全文検索インデッ" +"クスカラムを作成します。 ``flags`` パラメーターの ``COLUMN_INDEX|" +"WITH_POSITION|WITH_SECTION`` 、 ``type`` パラメーターの ``People`` 、 " +"``source`` パラメーターの ``_key,roles`` がポイントです。" + +msgid "" +"You can confirm that ``--match_columns _key`` and ``--query Alice`` are " +"evaluated by the ``Terms.people_key_roles_index`` newly created multiple " +"columns full text search index column from log. Groonga reports used index " +"columns in ``info`` log level. You can change log level dynamically by :doc:" +"`log_level` command." +msgstr "" +"ログを確認すると、新しく作成した ``Terms.people_key_roles_index`` マルチカラ" +"ム全文検索インデックスカラムを使って ``--match_columns _key`` と ``--query " +"Alice`` を評価していることがわかります。Groongaは使用したインデックスカラム" +"を ``info`` ログレベルでログに出力します。ログレベルは :doc:`log_level` コマ" +"ンドを使うと動的に変更できます。" + +msgid "Create a small index column" +msgstr "小さなインデックスカラムを作成" + +msgid "" +"If you know index target data are small, you can reduce memory usage for the " +"index column. Memory usage is ``1/256`` of the default index column." +msgstr "" +"もし、インデックス対象のデータが小さいことがわかっているならインデックスカラ" +"ムが使用するメモリー量を減らせます。デフォルトのインデックスカラムと比べて " +"``1/256`` のメモリー使用量になります。" + +msgid "" +"How many data are small? It depends on data. Small index column can't handle " +"1 billion records at least. If index target is only one scalar column with " +"no text family type (``ShortText``, ``Text`` or ``LongText``), the maximum " +"handleable records are depends of the number of kinds of index target data. " +"If index target column has ``1``, ``1``, ``2`` and ``3``, the number of " +"kinds of them are ``3`` (``1`` and ``2`` and ``3``). The following table " +"shows the relationship between the number of kinds of index target data and " +"the number of handleable records:" +msgstr "" +"ではどのくらいのデータなら小さいのでしょうか。それはデータによります。小さな" +"インデックスカラムは少なくとも10億レコードを扱えません。もし、インデックス対" +"象がテキスト系の型（``ShortText`` 、 ``Text`` 、 ``LongText`` のどれか）では" +"ないスカラーカラムだけの場合、扱える最大レコード数はインデックス対象のデータ" +"の種類に依存します。もし、インデックス対象のカラムに ``1`` 、 ``1`` 、 " +"``2`` 、 ``3`` というデータが入っていたとすると、種類数は ``3`` （ ``1`` と " +"``2`` と ``3`` ）になります。以下の表はインデックス対象データの種類数と扱える" +"最大レコード数の関係を示しています。" + +msgid "The number of kinds of index target data" +msgstr "インデックス対象のデータの種類数" + +msgid "The number of hanleable records" +msgstr "処理できるレコード数" + +msgid "1" +msgstr "" + +msgid "16779234" +msgstr "" + +msgid "2" +msgstr "" + +msgid "4648070" +msgstr "" + +msgid "4" +msgstr "" + +msgid "7238996" +msgstr "" + +msgid "8" +msgstr "" + +msgid "8308622" +msgstr "" + +msgid "16" +msgstr "" + +msgid "11068624" +msgstr "" + +msgid "32" +msgstr "" + +msgid "12670817" +msgstr "" + +msgid "64" +msgstr "" + +msgid "18524211" +msgstr "" + +msgid "128" +msgstr "" + +msgid "38095511" +msgstr "" + +msgid "256" msgstr "" -msgid "カラムを追加するテーブルの名前を指定します。" +msgid "51265384" msgstr "" +msgid "" +"You need to add ``INDEX_SMALL`` to the ``flags`` parameter such as " +"``COLUMN_INDEX|INDEX_SMALL`` to create a small index column." +msgstr "" +"小さなインデックスカラムを作成するには ``COLUMN_INDEX|INDEX_SMALL`` というよ" +"うに ``flags`` パラメーターに ``INDEX_SMALL`` を追加します。" + +msgid "" +"If the ``People`` table has only 1 million records, you can use a small " +"index column for the ``age`` column:" +msgstr "" +"``People`` テーブルが100万レコードしかないなら、 ``age`` カラム用に小さなイン" +"デックスカラムを使うことができます。" + +msgid "Create a medium index column" +msgstr "中サイズのインデックスカラムを作成" + +msgid "" +"If you know index target data are medium, you can reduce memory usage for " +"the index column. Memory usage is ``5/24`` of the default index column." +msgstr "" +"インデックス対象のデータが中サイズならインデックスカラムが使うメモリー使用量" +"を減らすことができます。デフォルトのインデックスカラムよりも ``5/24`` のメモ" +"リー使用量になります。" + +msgid "How many data are medium? It depends on data." +msgstr "" +"どのくらいのデータが中サイズのデータでしょうか。それはデータによります。" + +msgid "" +"If index target is only one scalar column, a medium index column can handle " +"all records." +msgstr "" +"もし、インデックス対象がスカラーカラム1つだけであれば、中サイズのインデックス" +"カラムはすべてのレコードを処理できます。" + +msgid "" +"A medium index column may not handle all records at the following cases:" +msgstr "" +"以下のケースでは中サイズのインデックスカラムはすべてのレコードを処理できない" +"かもしれません。" + +msgid "" +"Index target is one text family (``ShortText``, ``Text`` or ``LongText``) " +"scalar column" +msgstr "" +"インデックス対象がテキスト系の型（ ``ShortText`` 、 ``Text`` 、 ``LongText`` " +"のどれか）のスカラーカラム1つ" + +msgid "Index target is one vector column" +msgstr "インデックス対象がベクターカラム1つ" + +msgid "Index targets are multiple columns" +msgstr "インデックス対象が複数のカラム" + +msgid "Index table has tokenizer" +msgstr "インデックステーブルにトークナイザーが付いている" + +msgid "" +"You need to add ``INDEX_MEDIUM`` to the ``flags`` parameter such as " +"``COLUMN_INDEX|INDEX_MEDIUM`` to create a medium index column." +msgstr "" +"中サイズのインデックスカラムを作成するには ``COLUMN_INDEX|INDEX_MEDIUM`` とい" +"うように ``flags`` パラメーターに ``INDEX_MEDIUM`` を追加します。" + +msgid "" +"You can use a medium index column for an index column of the ``age`` column " +"of the ``People`` table safely. Because it's one scalar column with " +"``UInt8`` type." +msgstr "" +"``People`` テーブルの ``age`` カラム用のインデックスカラムであれば中サイズの" +"インデックスカラムでも安全です。なぜなら、 ``UInt8`` 型のスカラーカラム1つだ" +"からです。" + +msgid "Here is an example to create a medium index column:" +msgstr "以下は中サイズのインデックスカラムを作る例です。" + +msgid "There are some required parameters." +msgstr "いくつか必須の引数があります。" + +msgid "``table``" +msgstr "" + +msgid "Specifies an existing table name for the new column." +msgstr "新しいカラムを追加する対象となる既存のテーブル名を指定します。" + msgid "``name``" msgstr "" +msgid "Specifies the column name to be created." +msgstr "作成するカラム名を指定します。" + +msgid "The column name must be unique in the same table." +msgstr "カラム名は同じテーブル内で一意でなければいけません。" + +msgid "Here are available characters:" +msgstr "利用可能な文字は以下の通りです。" + +msgid "``0`` .. ``9`` (digit)" +msgstr "``0`` .. ``9`` （数字）" + +msgid "``a`` .. ``z`` (alphabet, lower case)" +msgstr "``a`` .. ``z`` （アルファベット。小文字）" + +msgid "``A`` .. ``Z`` (alphabet, upper case)" +msgstr "``A`` .. ``Z`` （アルファベット。大文字）" + +msgid "``#`` (hash)" +msgstr "``#`` （シャープ）" + +msgid "``@`` (at mark)" +msgstr "``@`` （アットマーク）" + +msgid "``-`` (hyphen)" +msgstr "``-`` （ハイフン）" + +msgid "" +"``_`` (underscore) (NOTE: Underscore can't be used as the first character.)" +msgstr "" +"``_`` （アンダースコア）（注: 最初の文字としてアンダースコアを使うことはでき" +"ません。）" + msgid "" -"作成するカラムの名前を指定します。カラム名は、テーブルの中で一意でなければな" -"りません。" +"You need to create a name with one or more the above characters. Note that " +"you can't use ``_`` as the first character such as ``_name``." +msgstr "" +"上記の文字を1つ以上使って名前を決めます。 ``_name`` というように、最初の文字" +"に ``_`` を使えないことに注意してください。" + +msgid "Specifies the column type and column customize options." +msgstr "カラムの種類とカラムをカスタマイズするオプションを指定します。" + +msgid "Here are available flags:" +msgstr "指定可能なフラグは以下の通りです。" + +msgid "Flag" +msgstr "フラグ" + +msgid "Description" +msgstr "説明" + +msgid "``COLUMN_SCALAR``" msgstr "" msgid "" -"ピリオド('.'), コロン(':')を含む名前のカラムは作成できません。また、アンダー" -"スコア('_')で始まる名前は予約済みであり、使用できません。" +"Scalar column. It can store one value. See also :doc:`/reference/columns/" +"scalar` or :ref:`column-create-scalar`." +msgstr "" +"スカラーカラム。値を1つ保存できます。 :doc:`/reference/columns/scalar` あるい" +"は :ref:`column-create-scalar` も見てください。" + +msgid "``COLUMN_VECTOR``" +msgstr "" + +msgid "" +"Vector column. It can store multiple values. See also :doc:`/reference/" +"columns/vector` or :ref:`column-create-vector`." +msgstr "" +"ベクターカラム。複数の値を保存できます。 :doc:`/reference/columns/vector` あ" +"るいは :ref:`column-create-vector` も見てください。" + +msgid "``COLUMN_INDEX``" +msgstr "" + +msgid "" +"Index column. It stores data for fast search. See also :doc:`/reference/" +"columns/index` or :ref:`column-create-index`." +msgstr "" +"インデックスカラム。高速に検索するためのデータを保存します。 :doc:`/" +"reference/columns/index` あるいは :ref:`column-create-index` も見てください。" + +msgid "``COMPRESS_ZLIB``" +msgstr "" + +msgid "" +"It enables column value compression by zlib. You need Groonga that enables " +"zlib support." +msgstr "" +"zlibを使ったカラム値圧縮機能を有効にします。zlibサポート付きのGroongaが必要で" +"す。" + +msgid "" +"Compression by zlib is higher space efficiency than compression by LZ4. But " +"compression by zlib is slower than compression by LZ4." +msgstr "" +"zlibを使った圧縮はLZ4を使った圧縮よりも空間効率がよいです。しかし、zlibを使っ" +"た圧縮はLZ4を使った圧縮よりも遅いです。" + +msgid "" +"This flag is available only for ``COLUMN_SCALAR`` and ``COLUMN_VECTOR``." +msgstr "このフラグは ``COLUMN_SCALAR`` と ``COLUMN_VECTOR`` でだけ使えます。" + +msgid "``COMPRESS_LZ4``" msgstr "" msgid "" -"カラムの属性を表す以下の数値か、パイプ('|')で組み合わせたシンボル名を指定しま" +"It enables column value compression by LZ4. You need Groonga that enables " +"LZ4 support." +msgstr "" +"LZ4を使ったカラム値圧縮機能を有効にします。LZ4サポート付きのGroongaが必要で" "す。" + +msgid "" +"Compression by LZ4 is faster than compression by zlib. But compression by " +"LZ4 is lower space efficiency than compression by zlib." +msgstr "" +"LZ4を使った圧縮はzlibを使った圧縮よりも速いです。しかし、LZ4を使った圧縮は" +"zlibを使った圧縮よりも空間効率が低いです。" + +msgid "``WITH_SECTION``" msgstr "" -msgid "0, ``COLUMN_SCALAR``" +msgid "It enables section support to index column." +msgstr "インデックスカラムのセクションサポートを有効にします。" + +msgid "" +"If section support is enabled, you can support multiple documents in the " +"same index column." msgstr "" +"セクションサポートが有効になると、同じインデックスカラムで複数の文書をサポー" +"トできます。" -msgid "単一の値が格納できるカラムを作成します。" +msgid "" +"You must specify this flag to create a multiple columns index column. See " +"also :ref:`column-create-index-multiple-columns` for details." msgstr "" +"マルチカラムインデックスカラムを作成するときはこのフラグを指定しなければいけ" +"ません。詳細は :ref:`column-create-index-multiple-columns` を見てください。" -msgid "1, ``COLUMN_VECTOR``" +msgid "" +"Section support requires additional spaces. If you don't need section " +"support, you should not enable section support." msgstr "" +"セクションサポートを有効にするとインデックスカラムが使う領域が増えます。セク" +"ションサポートが必要ない場合は有効にしないでください。" + +msgid "This flag is available only for ``COLUMN_INDEX``." +msgstr "このフラグは ``COLUMN_INDEX`` でだけ有効です。" -msgid "複数の値の配列を格納できるカラムを作成します。" +msgid "``WITH_WEIGHT``" msgstr "" -msgid "2, ``COLUMN_INDEX``" +msgid "It enables weight support to vector column or index column." +msgstr "ベクターカラム・インデックスカラムの重みサポートを有効にします。" + +msgid "" +"If weight support is enabled for vector column, you can add weight for each " +"element. If weight support is enabled for index column, you can add weight " +"for each posting. They are useful to compute suitable search score." msgstr "" +"ベクターカラムの重みサポートを有効にすると各要素に重みを追加できます。イン" +"デックスカラムの重みサポートを有効にすると各ポスティングに重みを追加できま" +"す。これらは検索スコアの調整に役立ちます。" -msgid "インデックス型のカラムを作成します。" +msgid "" +"You must specify this flag to use :ref:`select-adjuster`. See also :ref:" +"`column-create-vector-weight` for details." msgstr "" +":ref:`select-adjuster` を使う場合はこのフラグを指定します。詳細は :ref:" +"`column-create-vector-weight` を見てください。" msgid "" -"There are two flags to compress the value of column, but you can't specify " -"these flags for now because there are memory leaks issue `GitHub#6 <https://" -"github.com/groonga/groonga/issues/6>`_ when refers the value of column. This " -"issue occurs both of them (zlib and lzo)." +"Weight support requires additional spaces. If you don't need weight support, " +"you should not enable weight support." msgstr "" -"カラムの値を圧縮するためのフラグが2つあります。ただしそれらのフラグを指定する" -"ことは今のところできません。これはカラムの値を参照するときにメモリリークする" -"問題 `GitHub#6 <https://github.com/groonga/groonga/issues/6>`_ があるためで" -"す。 この問題はzlib、lzoいずれでも発生します。" +"重みをサポートすると使用する領域が増えます。重みが必要ない場合は有効にしない" +"でください。" -msgid "16, ``COMPRESS_ZLIB``" +msgid "This flag is available only for ``COLUMN_VECTOR`` or ``COLUMN_INDEX``." +msgstr "``COLUMN_VECTOR`` と ``COLUMN_INDEX`` でだけこのフラグは有効です。" + +msgid "``WITH_POSITION``" msgstr "" msgid "" -"Compress the value of column by using zlib. This flag is enabled when you " -"build Groonga with ``--with-zlib``." +"It enables position support to index column. It means that the index column " +"is full inverted index. (Index column is implemented as inverted index.)" msgstr "" -"zlibを使ってカラムの値を圧縮します。このフラグはGroongaを ``--with-zlib`` つ" -"きでビルドすると有効になります。" +"インデックスカラムの位置情報サポートを有効にします。これはインデックスカラム" +"を完全転置インデックスにするということです。（インデックスカラムは転置イン" +"デックスとして実装されています。）" -msgid "32, ``COMPRESS_LZO``" +msgid "" +"If position support is enabled, you can add position in the document for " +"each posting. It's required for phrase search. It means that index column " +"for full text search must enable position support because most full text " +"search uses phrase search." msgstr "" +"位置情報サポートが有効だと各ポスティングにドキュメントでの出現位置を追加でき" +"ます。この情報はフレーズ検索をするときに必要になります。全文検索用のインデッ" +"クスは位置情報サポートを有効にしなければいけません。なぜなら、全文検索はフ" +"レーズ検索を使うからです。" msgid "" -"Compress the value of column by using lzo. This flag is enabled when you " -"build Groonga with ``--with-lzo``." +"You must specify this flag to create a full text search index column. See " +"also :ref:`column-create-index-full-text-search` for details." msgstr "" -"lzoを使ってカラムの値を圧縮します。このフラグはGroongaを ``--with-lzo`` つき" -"でビルドすると有効になります。" +"全文検索インデックスカラムを作成するときはこのフラグを指定してください。詳細" +"は :ref:`column-create-index-full-text-search` を見てください。" msgid "" -"インデックス型のカラムについては、flagsの値に以下の値を加えることによって、追" -"加の属 性を指定することができます。" +"Position support requires additional spaces. If you don't need position " +"support, you should not enable position support." msgstr "" +"位置情報をサポートすると使用する領域が増えます。位置情報サポートが必要ない場" +"合は有効にしないでください。" -msgid "128, ``WITH_SECTION``" +msgid "``INDEX_SMALL``" msgstr "" -msgid "段落情報を格納するインデックスを作成します。" +msgid "It requires to create a small index column." +msgstr "小さなインデックスを作成するときに指定します。" + +msgid "" +"If index target data are small, small index column is enough. Small index " +"column uses fewer memory than a normal index column or a medium index " +"column. See also :ref:`column-create-index-small` for knowing what are " +"\"small data\" and how to use this flag." msgstr "" +"インデックス対象のデータが小さいときは小さなインデックスカラムで十分です。小" +"さなインデックスカラムは通常のインデックスカラム・中サイズのインデックスカラ" +"ムよりも使用メモリーが少ないです。「小さいデータ」とはなにか、このフラグをど" +"うやって使えばよいかは :ref:`column-create-index-small` を見てください。" -msgid "256, ``WITH_WEIGHT``" +msgid "``INDEX_MEDIUM``" msgstr "" -msgid "ウェイト情報を格納するインデックスを作成します。" +msgid "It requires to create a medium index column." +msgstr "中サイズのインデックスカラムを作成するときに指定します。" + +msgid "" +"If index target data are medium, medium index column is enough. Medium index " +"column uses fewer memory than a normal index column. See also :ref:`column-" +"create-index-medium` for knowing what are \"medium data\" and how to use " +"this flag." msgstr "" +"インデックス対象のデータが中サイズなら中サイズのインデックスカラムで十分で" +"す。中サイズのインデックスカラムは通常のインデックスカラムよりも使用メモリー" +"量が少ないです。「中サイズのデータ」とはなにか、このフラグをどうやって使えば" +"よいかは :ref:`column-create-index-mediumn` を見てください。" -msgid "512, ``WITH_POSITION``" +msgid "" +"You must specify one of ``COLUMN_${TYPE}`` flags. You can't specify two or " +"more ``COLUMN_${TYPE}`` flags. For example, ``COLUMN_SCALAR|COLUMN_VECTOR`` " +"is invalid." msgstr "" +"``COLUMN_${TYPE}`` フラグのどれかを必ず指定します。2つ以上の ``COLUMN_${TYPE}" +"`` フラグを指定してはいけません。たとえば、 ``COLUMN_SCALAR|COLUMN_VECTOR`` " +"は不正な指定です。" -msgid "位置情報を格納するインデックス(完全転置インデックス)を作成します。" +msgid "" +"You can combine flags with ``|`` (vertical bar) such as ``COLUMN_INDEX|" +"WITH_SECTION|WITH_POSITION``." msgstr "" +"``WITH_SECTION|WITH_POSITION`` というように、 ``|`` （縦棒）で複数のフラグを" +"組み合わせることができます。" msgid "``type``" msgstr "" +msgid "Specifies type of the column value." +msgstr "カラムの値の型を指定します。" + msgid "" -"値の型を指定します。Groongaの組込型か、同一データベースに定義済みのユーザ定義" -"型、定義済みのテーブルを指定することができます。" -msgstr "" +"If the column is scalar column or vector column, here are available types:" +msgstr "カラムがスカラーカラムかベクターカラムなら利用可能な型は次の通りです。" + +msgid "Builtin types described in :doc:`/reference/types`" +msgstr ":doc:`/reference/types` で説明している組み込みの型" + +msgid "Tables defined by users" +msgstr "ユーザーが定義したテーブル" + +msgid "If the column is index column, here are available types:" +msgstr "カラムがインデックスカラムのときの利用可能な型は次の通りです。" + +msgid "See also the followings:" +msgstr "以下も見てください。" + +msgid "There is an optional parameter." +msgstr "省略可能な引数があります。" msgid "``source``" msgstr "" msgid "" -"インデックス型のカラムを作成した場合は、インデックス対象となるカラムをsource" -"引数に指定します。" +"Specifies index target columns. You can specify one or more columns to the " +"``source`` parameter." msgstr "" +"インデックス対象のカラムを指定します。 ``source`` パラメーターには1つ以上のカ" +"ラムを指定できます。" + +msgid "This parameter is only available for index column." +msgstr "このパラメーターはインデックスカラムでだけ利用可能です。" -msgid "``SUCCEEDED``" +msgid "" +"You can only specify columns of the table specified as :ref:`column-create-" +"type`. You can also use the ``_key`` pseudo column for specifying the table " +"key as index target." msgstr "" +":ref:`column-create-type` で指定したテーブルのカラムだけ指定できます。テーブ" +"ルのキーをインデックス対象にしたい場合は ``_key`` 疑似カラムを指定します。" -msgid "If command is succeeded, it returns true on success, false otherwise." +msgid "" +"If you specify multiple columns to the ``source`` parameter, separate " +"columns with ``,`` (comma) such as ``_key,roles``." +msgstr "" +"``source`` パラメーターに複数のカラムを指定するときは ``_key,roles`` というよ" +"うに ``,`` （コンマ）で区切ります。" + +msgid "``column_create`` returns ``true`` as body on success such as::" +msgstr "" +"``column_create`` が成功したときは以下のようにボディは ``true`` になります::" + +msgid "" +"If ``column_create`` fails, ``column_create`` returns ``false`` as body::" +msgstr "``column_create`` が失敗したときはボディは ``false`` になります::" + +msgid "Error details are in ``HEADER``." +msgstr "``HEADER`` にエラーの詳細が含まれます。" + +msgid ":doc:`/reference/column`" msgstr "" -"コマンドの実行が成功するとtrueを返します。失敗するとエラーとしてfalseを返しま" -"す。" msgid "``column_list``" msgstr "" @@ -4718,9 +5602,6 @@ msgstr "カラムの型。次のうちのどれかです。" msgid "Value" msgstr "" -msgid "Description" -msgstr "説明" - msgid "``fix``" msgstr "" @@ -4764,27 +5645,12 @@ msgstr "" msgid "Here is the available flags:" msgstr "有効なフラグは以下の通りです。" -msgid "Flag" -msgstr "フラグ" - -msgid "``COLUMN_SCALAR``" -msgstr "" - msgid "The column is a scalar column." msgstr "このカラムはスカラーカラムです。" -msgid "``COLUMN_VECTOR``" -msgstr "" - msgid "The column is a vector column." msgstr "このカラムはベクターカラムです。" -msgid "``COLUMN_INDEX``" -msgstr "" - -msgid "``WITH_WEIGHT``" -msgstr "" - msgid "" "The column can have weight. ``COLUMN_VECTOR`` and ``COLUMN_INDEX`` may have " "it. ``COLUMN_SCALAR`` doesn't have it." @@ -4792,9 +5658,6 @@ msgstr "" "このカラムは、重みを持つことができます。 ``COLUMN_VECTOR`` と " "``COLUMN_INDEX`` は重みを持てます。 ``COLUMN_SCALAR`` は、重みを持ちません。" -msgid "``WITH_SECTION``" -msgstr "" - msgid "" "The column can have section information. ``COLUMN_INDEX`` may have it. " "``COLUMN_SCALAR`` and ``COLUMN_VECTOR`` don't have it." @@ -4806,9 +5669,6 @@ msgstr "" msgid "Multiple column index has it." msgstr "マルチカラムインデックスはこのフラグを持ちます。" -msgid "``WITH_POSITION``" -msgstr "" - msgid "" "The column can have position information. ``COLUMN_INDEX`` may have it. " "``COLUMN_SCALAR`` and ``COLUMN_VECTOR`` don't have it." @@ -4856,9 +5716,6 @@ msgid "" "It is always an empty array for ``COLUMN_SCALAR`` and ``COLUMN_VECTOR``." msgstr "``COLUMN_SCALAR`` と ``COLUMN_VECTOR`` では常に空の配列です。" -msgid ":doc:`/reference/column`" -msgstr "" - msgid "``column_remove``" msgstr "" @@ -6064,9 +6921,6 @@ msgstr "" msgid "Load proper data into parted tables on your own." msgstr "自分で個々のテーブルへ適切なデータをロードしないといけない" -msgid "This command takes many parameters." -msgstr "このコマンドにはたくさんの引数があります。" - msgid "The required parameters are ``logical_table`` and ``shard_key``::" msgstr "必須引数は2つあります。 ``logical_table`` と ``shard_key`` です。" @@ -7051,9 +7905,6 @@ msgstr "" msgid "You specify logical table name and shard key what you want to remove." msgstr "削除したい論理テーブル名とシャードキーを指定します。" -msgid "This section describes about the followings:" -msgstr "このセクションでは次のことについて説明します。" - msgid "Basic usage" msgstr "基本的な使い方" @@ -12480,46 +13331,12 @@ msgid "Specifies a table name to be created. ``name`` must be specified." msgstr "" "作成するテーブル名を指定します。 ``name`` は必ず指定しなければいけません。" -msgid "Here are available characters:" -msgstr "利用可能な文字は以下の通りです。" - -msgid "``0`` .. ``9`` (digit)" -msgstr "``0`` .. ``9`` （数字）" - -msgid "``a`` .. ``z`` (alphabet, lower case)" -msgstr "``a`` .. ``z`` （アルファベット。小文字）" - -msgid "``A`` .. ``Z`` (alphabet, upper case)" -msgstr "``A`` .. ``Z`` （アルファベット。大文字）" - -msgid "``#`` (hash)" -msgstr "``#`` （シャープ）" - -msgid "``@`` (at mark)" -msgstr "``@`` （アットマーク）" - -msgid "``-`` (hyphen)" -msgstr "``-`` （ハイフン）" - -msgid "" -"``_`` (underscore) (NOTE: Underscore can't be used as the first character.)" -msgstr "" -"``_`` （アンダースコア）（注: 最初の文字としてアンダースコアを使うことはでき" -"ません。）" - -msgid "" -"You need to create a name with one or more the above characters. Note that " -"you cannot use ``_`` as the first character such as ``_name``." -msgstr "" -"上記の文字を1つ以上使って名前を決めます。 ``_name`` というように、最初の文字" -"に ``_`` を使えないことに注意してください。" +msgid "There are some optional parameters." +msgstr "いくつか省略可能な引数があります。" msgid "Specifies a table type and table customize options." msgstr "テーブルの型とテーブルをカスタマイズするオプションを指定します。" -msgid "Here are available flags:" -msgstr "指定可能なフラグは以下の通りです。" - msgid "``TABLE_NO_KEY``" msgstr "" @@ -17186,9 +18003,6 @@ msgstr "" "``select`` コマンドの ``query`` については :ref:`select-match-columns` を参照" "してください。" -msgid "There are some optional parameters." -msgstr "いくつか省略可能な引数があります。" - msgid "Specifies the plugin name for query expansion." msgstr "クエリ展開に使うプラグイン名を指定します。" Modified: doc/source/reference/commands/column_create.rst (+97 -88) =================================================================== --- doc/source/reference/commands/column_create.rst 2016-10-14 19:03:42 +0900 (4377dfb) +++ doc/source/reference/commands/column_create.rst 2016-10-14 19:26:02 +0900 (62f711b) @@ -26,7 +26,9 @@ See :doc:`/reference/column` for column details. Syntax ------ -This command takes many parameters:: +This command takes many parameters. + +Most parameters are required:: column_create table name @@ -162,16 +164,16 @@ Both scalar column and vector column can store reference to record of an existing table as column value. It's useful to store relationship between records. -For example, using a column that refers is better for storing a -character into a book record. Because one person may be appeared in -some books. +For example, using a column that refers a person record is better for +storing a character into a book record. Because one person may be +appeared in some books. -You must specify table name to ``type`` parameter to create a column -that refers a table's record. +You must specify table name to be referenced to the ``type`` parameter +to create a column that refers a table's record. Here is an example to create the ``character`` column to the ``Books`` -table. ``character`` column refers ``People`` table. It can store -one ``People`` table's record. +table. The ``character`` column refers the ``People`` table. It can +store one ``People`` table's record. Here is the ``Books`` table definition: @@ -205,8 +207,8 @@ record: .. ] You can confirm the stored reference (``"alice"`` record) by the -following :doc:`select` command. It retrieves ``age`` column and -``roles`` column values: +following :doc:`select` command. It retrieves the ``age`` column and +the ``roles`` column values: .. groonga-command .. include:: ../../example/reference/commands/column_create/usage_reference_select.log @@ -227,29 +229,31 @@ updated automatically when you store data into a data column (scalar column or vector column) that is marked as index target column. You can set multiple columns as index target columns to one index column. -If Groonga has an index for the ``age`` column of the ``People`` -table, Groonga can do fast equal search, fast comparison search and -fast range search against ``age`` column values. +If Groonga has an index column for the ``age`` column of the +``People`` table, Groonga can do fast equal search, fast comparison +search and fast range search against ``age`` column values. You must specify the following parameters to create an index column: * The ``flags`` parameter: ``COLUMN_INDEX`` - * The ``type`` parameter: The table name of source column such as - ``People`` + * The ``type`` parameter: The table name of index target column such + as ``People`` - * The ``source`` parameter: The source column name such as ``age`` + * The ``source`` parameter: The index target column name such as + ``age`` You don't need additional flags to the ``flags`` parameter for equal -search, comparison search and range search index. You need additional -flags to the ``flags`` parameter for full text search index or -multiple column index. See :ref:`column-create-index-full-text-search` -and :ref:`column-create-index-multiple-columns` for details. +search, comparison search and range search index column. You need +additional flags to the ``flags`` parameter for full text search index +column or multiple column index column. See +:ref:`column-create-index-full-text-search` and +:ref:`column-create-index-multiple-columns` for details. -Here is an example to create an index for the ``age`` column of the -``People`` table. +Here is an example to create an index column for the ``age`` column of +the ``People`` table. -First, you need to create a range index table. See +First, you need to create a table for range index column. See :ref:`table-create-range-index-table` for details. This example creates the ``Ages`` table as :ref:`table-pat-key`: @@ -275,9 +279,9 @@ parameter are important: .. --source age You can confirm that ``age > 5`` is evaluated by the -``Ages.people_age_index`` newly created index from log. Groonga -reports used indexes in ``info`` log level. You can change log level -dynamically by :doc:`log_level` command. +``Ages.people_age_index`` newly created index column from log. Groonga +reports used index columns in ``info`` log level. You can change log +level dynamically by :doc:`log_level` command. .. groonga-command .. log: true @@ -294,7 +298,8 @@ following log:: [table][select][index][range] <Ages.people_age_index> -The log says ``Ages.people_age_index`` index is used for range search. +The log says ``Ages.people_age_index`` index column is used for range +search. .. _column-create-index-full-text-search: @@ -302,19 +307,19 @@ Create an index column for full text search ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ There is a difference between for non full text search (equal search, -comparison search or range search) index and for full text search -index. You need to add ``WITH_POSITION`` to the ``flags`` -parameter. It means that you need to specify +comparison search or range search) index column and for full text +search index column. You need to add ``WITH_POSITION`` to the +``flags`` parameter. It means that you need to specify ``COLUMN_INDEX|WITH_POSITION`` to the ``flags`` parameter. It's the difference. -Here is an example to create a full text search index for the +Here is an example to create a full text search index column for the ``roles`` column of the ``People`` table. -First, you need to create a table for full text search index. See -:ref:`table-create-lexicon` for details. This example creates the -``Terms`` table as :ref:`table-pat-key` with :ref:`token-bigram` -tokenizer and :ref:`normalizer-auto` normalizer: +First, you need to create a table for full text search index +column. See :ref:`table-create-lexicon` for details. This example +creates the ``Terms`` table as :ref:`table-pat-key` with +:ref:`token-bigram` tokenizer and :ref:`normalizer-auto` normalizer: .. groonga-command .. include:: ../../example/reference/commands/column_create/usage_full_text_search_index_create_table.log @@ -341,9 +346,9 @@ column of the ``People`` table. ``COLUMN_INDEX|WITH_POSITION`` in the You can confirm that ``--match_columns roles`` and ``--query Sister`` are evaluated by the ``Terms.people_roles_index`` newly created full -text search index from log. Groonga reports used indexes in ``info`` -log level. You can change log level dynamically by :doc:`log_level` -command. +text search index column from log. Groonga reports used index columns +in ``info`` log level. You can change log level dynamically by +:doc:`log_level` command. .. groonga-command .. log: true @@ -361,9 +366,9 @@ following log:: [object][search][index][key][exact] <Terms.people_roles_index> -The log says ``Terms.people_roles_index`` index is used for full text -search. (To be precise, the index is used for exact term search by -inverted index.) +The log says ``Terms.people_roles_index`` index column is used for +full text search. (To be precise, the index column is used for exact +term search by inverted index.) .. _column-create-index-multiple-columns: @@ -372,37 +377,41 @@ Create a multiple columns index column You can create an index column for multiple columns. It means that you can do fast search for multiple columns with one index -column. Multiple columns index has better space efficiency than single -column index only when multiple columns have many same -tokens. Multiple columns index may be slower than single column -index. Because multiple columns index will be a bigger index. - -You can't use multiples columns in different tables as source columns -in the same multiple columns index. You must specify columns in the -same tables as source columns to one multiple columns index. For -example, you can't create a multiple columns index for ``People._key`` -and ``Books._key`` because they are columns of different tables. You -can create a multiple columns index for ``People._key`` and -``People.roles`` because they are columns of the same table. - -There is a difference between for single column index and for multiple -columns index. You need to add ``WITH_SECTION`` to the ``flags`` -parameter. It means that you need to specify +column. Multiple columns index column has better space efficiency than +single column index column only when multiple columns have many same +tokens. Multiple columns index column may be slower than single column +index column. Because multiple columns index column will be a bigger +index column. + +You can't use multiples columns in different tables as index target +columns in the same multiple columns index column. You must specify +columns in the same tables as index target columns to one multiple +columns index column. For example, you can't create a multiple columns +index for ``People._key`` and ``Books._key`` because they are columns +of different tables. You can create a multiple columns index column +for ``People._key`` and ``People.roles`` because they are columns of +the same table. + +There is a difference between for single column index column and for +multiple columns index column. You need to add ``WITH_SECTION`` to the +``flags`` parameter. It means that you need to specify ``COLUMN_INDEX|WITH_SECTION`` to the ``flags`` parameter. It's the difference. -If you want to create a multiple columns index for full text search, -you need to specify ``COLUMN_INDEX|WITH_POSITION|WITH_SECTION`` to -the ``flags`` parameter. See :ref:`column-create-full-text-search` for -full text search index column details. +If you want to create a multiple columns index column for full text +search, you need to specify +``COLUMN_INDEX|WITH_POSITION|WITH_SECTION`` to the ``flags`` +parameter. See :ref:`column-create-index-full-text-search` for full +text search index column details. Here is an example to create a multiple columns full text search index -for the key of the ``People`` table and the ``roles`` column of the -``People`` table. +column for the key of the ``People`` table and the ``roles`` column of +the ``People`` table. -There is no difference between index table for single column index and -multiple columns index. In this example, the ``Terms`` table created -at :ref:`column-create-full-text-search` is used. +There is no difference between index table for single column index +column and multiple columns index column. In this example, the +``Terms`` table created at :ref:`column-create-index-full-text-search` +is used. You can create a multiple columns full text search index column for the key of the ``People`` table and ``roles`` column of the ``People`` @@ -421,8 +430,8 @@ the ``source`` parameter are important: You can confirm that ``--match_columns _key`` and ``--query Alice`` are evaluated by the ``Terms.people_key_roles_index`` newly -created multiple columns full text search index from log. Groonga -reports used indexes in ``info`` log level. You can change log level +created multiple columns full text search index column from log. Groonga +reports used index columns in ``info`` log level. You can change log level dynamically by :doc:`log_level` command. .. groonga-command @@ -441,9 +450,9 @@ following log:: [object][search][index][key][exact] <Terms.people_key_roles_index> -The log says ``Terms.people_roles_index`` index is used for full text -search. (To be precise, the index is used for exact term search by -inverted index.) +The log says ``Terms.people_roles_index`` index column is used for +full text search. (To be precise, the index column is used for exact +term search by inverted index.) .. _column-create-index-small: @@ -454,12 +463,12 @@ If you know index target data are small, you can reduce memory usage for the index column. Memory usage is ``1/256`` of the default index column. -How many data are small? It's depend on data. Small index column can't -handle 10 billions records at least. If index target is only one +How many data are small? It depends on data. Small index column can't +handle 1 billion records at least. If index target is only one scalar column with no text family type (``ShortText``, ``Text`` or ``LongText``), the maximum handleable records are depends of the number of kinds of index target data. If index target column has -``1``, ``1``, ``22`` and ``3``, the number of kinds of them are ``3`` +``1``, ``1``, ``2`` and ``3``, the number of kinds of them are ``3`` (``1`` and ``2`` and ``3``). The following table shows the relationship between the number of kinds of index target data and the number of handleable records: @@ -488,8 +497,8 @@ number of handleable records: * - 256 - 51265384 -You need to add ``INDEX_SMALL`` to the ``flags`` parameter such s -``COLUMN_INDEX|INDEX_SMALL``. +You need to add ``INDEX_SMALL`` to the ``flags`` parameter such as +``COLUMN_INDEX|INDEX_SMALL`` to create a small index column. If the ``People`` table has only 1 million records, you can use a small index column for the ``age`` column: @@ -512,7 +521,7 @@ If you know index target data are medium, you can reduce memory usage for the index column. Memory usage is ``5/24`` of the default index column. -How many data are medium? It's depend on data. +How many data are medium? It depends on data. If index target is only one scalar column, a medium index column can handle all records. @@ -526,8 +535,8 @@ cases: * Index targets are multiple columns * Index table has tokenizer -You need to add ``INDEX_MEDIUM`` to the ``flags`` parameter such s -``COLUMN_INDEX|INDEX_MEDIUM``. +You need to add ``INDEX_MEDIUM`` to the ``flags`` parameter such as +``COLUMN_INDEX|INDEX_MEDIUM`` to create a medium index column. You can use a medium index column for an index column of the ``age`` column of the ``People`` table safely. Because it's one scalar column @@ -559,7 +568,7 @@ There are some required parameters. ``table`` """"""""" -Specifies an existing table name for the newly created column. +Specifies an existing table name for the new column. .. _column-create-name: @@ -620,7 +629,7 @@ Here are available flags: that enables zlib support. Compression by zlib is higher space efficiency than compression - by LZ4. But Compression by zlib is slower than compression by + by LZ4. But compression by zlib is slower than compression by LZ4. This flag is available only for ``COLUMN_SCALAR`` and @@ -631,7 +640,7 @@ Here are available flags: that enables LZ4 support. Compression by LZ4 is faster than compression by zlib. But - Compression by LZ4 is lower space efficiency than compression + compression by LZ4 is lower space efficiency than compression by zlib. This flag is available only for ``COLUMN_SCALAR`` and @@ -644,7 +653,7 @@ Here are available flags: documents in the same index column. You must specify this flag to create a multiple columns index - column. See also ref:`column-create-index-multiple-columns` for + column. See also :ref:`column-create-index-multiple-columns` for details. Section support requires additional spaces. If you don't need @@ -661,7 +670,7 @@ Here are available flags: compute suitable search score. You must specify this flag to use :ref:`select-adjuster`. See - also ref:`column-create-vector-weight` for details. + also :ref:`column-create-vector-weight` for details. Weight support requires additional spaces. If you don't need weight support, you should not enable weight support. @@ -681,7 +690,7 @@ Here are available flags: search. You must specify this flag to create a full text search index - column. See also ref:`column-create-index-full-text-search` for + column. See also :ref:`column-create-index-full-text-search` for details. Position support requires additional spaces. If you don't need @@ -697,7 +706,7 @@ Here are available flags: If index target data are small, small index column is enough. Small index column uses fewer memory than a normal index column or a medium index column. See also - ref:`column-create-index-small` for knowing what are "small + :ref:`column-create-index-small` for knowing what are "small data" and how to use this flag. This flag is available only for ``COLUMN_INDEX``. @@ -709,7 +718,7 @@ Here are available flags: If index target data are medium, medium index column is enough. Medium index column uses fewer memory than a normal index - column. See also ref:`column-create-index-mediumn` for knowing + column. See also :ref:`column-create-index-medium` for knowing what are "medium data" and how to use this flag. This flag is available only for ``COLUMN_INDEX``. @@ -748,7 +757,7 @@ See also the followings: Optional parameters ^^^^^^^^^^^^^^^^^^^ -There are an optional parameter. +There is an optional parameter. .. _column-create-source: -------------- next part -------------- HTML����������������������������...Download