1.2.1 - en to ja translation catalogue (85 entries)

en: Execution example::
ja: 実行例::

en: Basic operations
ja: 基本的な操作

en: A Groonga package provides a C library (libgroonga) and a command line tool (groonga). This tutorial explains how to use the command line tool, with which you can create/operate databases, start a server, establish a connection with a server, etc.
ja: Groongaには、Cのライブラリとして使用する方法と、groonga実行ファイルを通して使用する方法があります。本チュートリアルでは、groonga実行ファイルを使用する方法について説明します。groonga実行ファイルを使って、データベースの作成・操作・サーバの起動・サーバへの接続などの操作が行えます。

en: Create a database
ja: データベースの作成

en: The first step to using Groonga is to create a new database. The following shows how to do it.
ja: Groongaユーザへの第一歩はデータベースの作成です。まずは以下の書式をご覧ください。

en: Form::
ja: 書式::

en: The ``-n`` option specifies to create a new database and DB_PATH specifies the path of the new database. Actually, a database consists of a series of files and DB_PATH specifies the file which will be the entrance to the new database. DB_PATH also specifies the path prefix for other files. Note that database creation fails if DB_PATH points to an existing file (For example, ``db open failed (DB_PATH): syscall error 'DB_PATH' (File exists)``. You can operate an existing database in a way that is in the next chapter).
ja: ``-n`` オプションは、データベースの作成を指示します。DB_PATHは、新しく作成するデータベースのパスを指定します。データベースは複数のファイルによって構成されるため、正確には、データベースの入り口となるファイルのパスとして使用されます。また、データベースを構成する他のファイルについては、DB_PATHがパスのプレフィックスとして使用されます。指定されたパスにファイルが存在しているときは失敗するので注意してください（失敗例: ``db open failed (DB_PATH): syscall error 'DB_PATH' (ファイルが存在します)``。 次の章で、既存のデータベースを開く方法を説明します）。

en: This command creates a new database and then enters into interactive mode in which Groonga prompts you to enter commands for operating that database. You can terminate this mode with Ctrl-d.
ja: 上記のコマンドは、データベースを作成してから、コマンドの入力を受け付ける対話モードに入ります。Ctrlキーを押しながらdキーを押すと、対話モードから抜けることができます。

en: After this database creation, you can find a series of files in /tmp/groonga-databases.
ja: データベースの作成に成功すれば、/tmp/groonga-databases以下にデータベースを構成するファイルが配置されます。

en: Operate a database
ja: データベースの操作

en: The following shows how to operate an existing database.
ja: 以下の書式は、既存のデータベースを操作する方法を示しています。

en: DB_PATH specifies the path of a target database. This command fails if the specified database does not exist.
ja: DB_PATHには操作対象のデータベースを指定します。指定したデータベースが存在しないときは失敗します。

en: If COMMAND is specified, Groonga executes COMMAND and returns the result. Otherwise, Groonga starts in interactive mode that reads commands from the standard input and executes them one by one. This tutorial focuses on the interactive mode.
ja: COMMAND が指定された場合、COMMAND を実行した後、実行結果を返します。指定されなかった場合には、対話モードに入ります。対話モードでは、標準入力からコマンドを読み込み、順次実行します。本チュートリアルでは、対話モードを主に使用します。

en: Let's see the status of a Groonga process by using a :doc:`/reference/commands/status` command.
ja: それでは、 :doc:`/reference/commands/status` コマンドを実行して、Groongaの実行状態を確認してみましょう。

en: As shown in the above example, a command returns a JSON array. The first element contains an error code, execution time, etc. The second element is the result of an operation.
ja: 以上のように、コマンドの実行結果は基本的にjson形式の配列として返却されます。配列の先頭には、エラーコードや実行時間などの情報が入ります。2番目の要素には、指示された操作の実行結果が入ります。

en: You can format a JSON using additional tools. For example, `grnwrap <https://github.com/michisu/grnwrap>`_, `Grnline <https://github.com/yoshihara/grnline>`_, `jq <http://stedolan.github.io/jq/>`_ and so on.
ja: 他のツールを使うことで、JSONを整形できます。例えば、 `grnwrap <https://github.com/michisu/grnwrap>`_ や `Grnline <https://github.com/yoshihara/grnline>`_ 、 `jq <http://stedolan.github.io/jq/>`_ などが使えます。

en: Command format
ja: コマンドの書式

en: Commands for operating a database accept arguments as follows::
ja: データベースを操作するコマンドには、以下の書式で引数を与えます。::

en: In the first form, arguments must be passed in order. This kind of arguments are called positional arguments because the position of each argument determines its meaning.
ja: 書式1では値を適切な順番で渡す必要があります。このような引数は、位置によって値の意味が決まるため、位置固定引数などと呼ばれることもあります。

en: In the second form, you can specify a parameter name with its value. So, the order of arguments is not defined. This kind of arguments are known as named parameters or keyword arguments.
ja: 書式2では値を名前と一緒に渡します。そのため、任意の順序で引数を指定することができます。このような引数は、名前付き引数やキーワード引数と呼ばれることもあります。

en: If you want to specify a value which contains white-spaces or special characters, such as quotes and parentheses, please enclose the value with single-quotes or double-quotes.
ja: 空白や特殊な記号（ダブルクォート、シングルクォート、および丸括弧）を含む値を指定したいときは、シングルクォート(')かダブルクォート(")で値を囲むようにしてください。

en: For details, see also the paragraph of "command" in :doc:`/reference/executables/groonga`.
ja: 詳しくは、 :doc:`/reference/executables/groonga` のコマンドの項を参考にしてください。

en: Basic commands
ja: 主なコマンド

en: shows status of a Groonga process.
ja: Groongaプロセスの状態を表示します。

en: shows a list of tables in a database.
ja: データベースに定義されているテーブルのリストを表示します。

en: shows a list of columns in a table.
ja: テーブルに定義されているカラムのリストを表示します。

en: adds a table to a database.
ja: データベースにテーブルを追加します。

en: adds a column to a table.
ja: テーブルにカラムを追加します。

en: searches records from a table and shows the result.
ja: テーブルに含まれるレコードを検索して表示します。

en: inserts records to a table.
ja: テーブルにレコードを挿入します。

en: Create a table
ja: テーブルの作成

en: A :doc:`/reference/commands/table_create` command creates a new table.
ja: :doc:`/reference/commands/table_create` コマンドを使用してテーブルを作成します。

en: In most cases, a table has a primary key which must be specified with its data type and index type.
ja: Groongaのテーブルには基本的に主キーが必要であり、テーブルを作成する際には型と格納方法も併せて指定する必要があります。

en: 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.
ja: 型には数値や文字列などがあります。ここではデータの種類を表しているものという程度に考えてください。詳細は :doc:`/reference/types` に記述されています。主キーの格納方法は、主キーを条件とする検索にかかる時間や、前方一致検索の可否などを左右します。こちらも後で説明します。

en: 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.
ja: それでは、テーブルを作成してみましょう。以下の例では、主キーのあるテーブルを作成します。 ``name`` 引数はテーブルの名前を指定します。 ``flags`` 引数は主キーの格納方法を指定するために使っています。 ``key_type`` 引数は主キーの型を指定します。

en: The second element of the result indicates that the operation succeeded.
ja: 実行結果の第2要素は、操作が成功したことを示しています。

en: View a table
ja: テーブルの表示

en: A :doc:`/reference/commands/select` command can enumerate records in a table.
ja: :doc:`/reference/commands/select` コマンドを用いて、テーブルの中身を表示することができます。

en: When only a table name is specified with a ``table`` parameter, a :doc:`/reference/commands/select` command returns the first (at most) 10 records in the table. [0] in the result shows the number of records in the table. The next array is a list of columns. ["_id","Uint32"] is a column of UInt32, named _id. ["_key","ShortText"] is a column of ShortText, named _key.
ja: :doc:`/reference/commands/select` に ``table`` 引数のみを指定すると、指定したテーブルの中身を10件まで表示します。実行結果の[0]はテーブルに含まれるレコードの数を示しています。今回は何も登録されていないため0件です。レコード数の次に表示されている配列はテーブルの構成を示しています。["_id","Uint32"]はUInt32型の値を持つ_idという名前のカラム、["_key","ShortText"]はShortText型の値を持つ_keyという名前のカラムをそれぞれ表しています。

en: The above two columns, _id and _key, are the necessary columns. The _id column stores IDs those are automatically allocated by Groonga. The _key column is associated with the primary key. You are not allowed to rename these columns.
ja: 上記の_idカラムと_keyカラムの2つのカラムは必須のカラムです。_idカラムはGroongaが自動的に割り当てるIDを格納します。_keyカラムは主キーを格納します。これらのカラム名を変更することはできません。

en: Create a column
ja: カラムの作成

en: A :doc:`/reference/commands/column_create` command creates a new column.
ja: :doc:`/reference/commands/column_create` コマンドを用いて、カラムを作成することができます。

en: Let's add a column. The following example adds a column to the Site table. The ``table`` parameter specifies the target table. The ``name`` parameter specifies the name of the column. The ``type`` parameter specifies the data type of the column.
ja: それでは、カラムを作成してみましょう。以下の例では、新しいカラムをSiteテーブルに追加します。 ``table`` 引数はテーブルの名前を指定します。 ``name`` 引数は新しいカラムの名前を指定します。 ``type`` 引数はカラムに格納する値の型を指定します。

en: Load records
ja: データのロード

en: A :doc:`/reference/commands/load` command loads JSON-formatted records into a table.
ja: :doc:`/reference/commands/load` コマンドは、JSON形式のレコードを受け取り、テーブルに格納します。

en: The following example loads nine records into the Site table.
ja: 以下の例では9つのレコードをSiteテーブルに格納します。

en: The second element of the result indicates how many records were successfully loaded. In this case, all the records are successfully loaded.
ja: 実行結果の第2要素はロードされたレコードの数を示しています。上記の操作では、すべてのレコードを問題なくロードできています。

en: Let's make sure that these records are correctly stored.
ja: 念のため、データが入っていることを確認してみましょう。

en: Get a record
ja: レコードの取得

en: A :doc:`/reference/commands/select` command can search records in a table.
ja: :doc:`/reference/commands/select` コマンドを用いて、テーブルの中身を表示することができます。

en: If a search condition is specified with a ``query`` parameter, a :doc:`/reference/commands/select` command searches records matching the search condition and returns the matched records.
ja: ``query`` 引数を使って検索条件が指定された場合、 :doc:`/reference/commands/select` コマンドは検索条件に適合するレコードを検索し、検索結果を出力します。

en: Let's get a record having a specified record ID. The following example gets the first record in the Site table. More precisely, the ``query`` parameter specifies a record whose _id column stores 1.
ja: それでは、IDを指定してレコードを取り出してみましょう。以下の例では、Siteテーブルの先頭レコードを取り出します。正確には、 ``query`` 引数を使って _id カラムに1が格納されているレコードを要求しています。

en: Next, let's get a record having a specified key. The following example gets the record whose primary key is "http://example.org/". More precisely, the ``query`` parameter specifies a record whose _key column stores "http://example.org/".
ja: 次に、主キーを指定してレコードを取り出してみましょう。以下の例では、主キーが "http://example.org/" のキーを取り出します。正確には、 ``query`` 引数を使って _key カラムに "http://example.org/" が格納されているレコードを要求しています。

en: Create a lexicon table for full text search
ja: 全文検索用の語彙表の作成

en: Let's go on to how to make full text search.
ja: そろそろ全文検索の使い方について見ていきましょう。

en: Groonga uses an inverted index to provide fast full text search. So, the first step is to create a lexicon table which stores an inverted index, also known as postings lists. The primary key of this table is associated with a vocabulary made up of index terms and each record stores postings lists for one index term.
ja: Groongaでは転置インデックスを使って高速な全文検索を実現しています。そのため、まずは転置インデックスとして用いるテーブルを作成する必要があります。テーブルの内容は、文書に含まれる単語やN-gramなどの索引語を主キーとして、各カラムに索引語の位置情報を格納するという構成になります。結果として、主キーのカラムは全文検索における語彙表の役割を果たします。

en: The following shows a command which creates a lexicon table named Terms. The data type of its primary key is ShortText.
ja: 以下の例では、Termsという名前のテーブルを転置インデックスの語彙表として作成しています。索引語を格納するため、主キーの型はShortTextです。

en: The :doc:`/reference/commands/table_create` command takes many parameters but you don't need to understand all of them. Please skip the next paragraph if you are not interested in how it works.
ja: :doc:`/reference/commands/table_create` には多くの引数が指定されているものの、本チュートリアルではすべてを理解する必要はありません。以下に簡単な説明を述べますが、読み飛ばしてもらってかまいません。

en: The TABLE_PAT_KEY flag specifies to store index terms in a patricia trie. The ``default_tokenizer`` parameter specifies the method for tokenizing text. This example uses TokenBigram that is generally called N-gram.
ja: TABLE_PAT_KEYフラグは、主キーをパトリシア木に格納することを指示しています。 ``default_tokenizer`` 引数には、検索対象の文書をトークナイズする方式を指定するようになっています。上記の例では、一般的にN-gramと呼ばれるインデックス方式に対応するTokenBigramを指定しています。

en: The ``normalizer`` parameter specifies to normalize index terms.
ja: ``normalizer`` 引数はインデックスの単語をノーマライズするかどうかを指定しています。

en: Create an index column for full text search
ja: 全文検索用のインデックスカラムの作成

en: The second step is to create an index column, which allows you to search records from its associated column. That is to say this step specifies which column needs an index.
ja: 次に必要なのは、インデックス型のカラムを作成することです。このカラムは、関連付けられたカラムに対する全文検索に利用されます。つまり、全文検索を行いたいカラムに対してインデックスを作成することに相当します。

en: Let's create an index column. The following example creates an index column for a column in the Site table.
ja: それでは、インデックスカラムを作成してみましょう。以下の例では、Siteテーブルのカラムに対するインデックスカラムを作成します。それでは、Siteテーブルのtitleカラムを全文検索の対象とするべく、インデックス型のカラムを作成してみましょう。

en: The ``table`` parameter specifies the index table and the ``name`` parameter specifies the index column. The ``type`` parameter specifies the target table and the ``source`` parameter specifies the target column. The COLUMN_INDEX flag specifies to create an index column and the WITH_POSITION flag specifies to create a full inverted index, which contains the positions of each index term. This combination, COLUMN_INDEX|WITH_POSITION, is recommended for the general purpose.
ja: ``table`` 引数は語彙表を指定し、 ``name`` 引数はインデックスカラムを指定します。また、 ``type`` 引数はインデックスの対象となるテーブルを指定し、 ``source`` 引数はインデックスの対象となるカラムを指定します。COLUMN_INDEXフラグはインデックスカラムの作成を指示し、WITH_POSITIONフラグは各索引語の位置情報をインデックスに含めることを指示します。一般的な全文検索インデックスを作成したいときは、COLUMN_INDEX|WITH_POSITIONを指定してください。索引語の位置情報については、本チュートリアルでは触れません。

en: You can create a lexicon table and index columns before/during/after loading records. If a target column already has records, Groonga creates an inverted index in a static manner. In contrast, if you load records into an already indexed column, Groonga updates the inverted index in a dynamic manner.
ja: 語彙表とインデックスカラムを作成するタイミングは、データをロードする前後のどちらでも問題ありません。データをロードした後でインデックスを作成し、さらに新しいデータをロードすることもできます。インデックスの作成を指示したタイミングでレコードが既に存在するときは、静的にインデックスを作成します。一方、インデックスを作成した後で追加されたレコードについては、動的にインデックスを更新します。

en: Full text search
ja: 全文検索

en: It's time. You can make full text search with a :doc:`/reference/commands/select` command.
ja: インデックスを作成したことにより、 :doc:`/reference/commands/select` コマンドによる全文検索が可能になります。

en: A query for full text search is specified with a ``query`` parameter. The following example searches records whose "title" column contains "this". The '@' specifies to make full text search. Note that a lower case query matches upper case and capitalized terms in a record if NormalizerAuto was specified when creating a lexcon table.
ja: 全文検索のクエリは ``query`` 引数により指定することができます。以下の例では、titleカラムに "this" という文字列が含まれているレコードを検索します。 ``query`` 引数に含まれる '@' は、全文検索を指示しています。語彙表の作成において NormalizerAuto を指定したときは、全角・半角や大文字・小文字などの違いが吸収されることに注意してください。

en: In this example, the first record matches the query because its title contains "This", that is the capitalized form of the query.
ja: 上記の例では、"This" という単語を含む先頭レコードのみが検索条件に適合します。

en: A :doc:`/reference/commands/select` command accepts an optional parameter, named `match_columns`, that specifies the default target columns. This parameter is used if target columns are not specified in a query. [#]_
ja: :doc:`/reference/commands/select` コマンドには、 `match_columns` という引数が存在します。このパラメータはデフォルトで検索対象にするカラムを指定するもので、カラム名を指定しない検索条件にのみ適用されます。 [#]_

en: The combination of "`--match_columns` title" and "`--query` this" brings you the same result that "`--query` title:@this" does.
ja: "`--match_columns` title" と "`--query` this" の組み合わせを指定すると、 "`--query` title:@this" を指定したときと同じ検索条件になります。

en: Specify output columns
ja: 出力カラムの指定

en: An ``output_columns`` parameter of a :doc:`/reference/commands/select` command specifies columns to appear in the search result. If you want to specify more than one columns, please separate column names by commas (',').
ja: :doc:`/reference/commands/select` コマンドにおいて ``output_columns`` 引数を用いることで、検索結果に含めるカラムを指定することができます。複数のカラムを指定するときは、カンマ（,）区切りでカラムを列挙します。

en: This example specifies three output columns including the _score column, which stores the relevance score of each record.
ja: 上記の例では、_scoreカラムを含む3つのカラムを指定しています。_scoreカラムはGroongaの検索結果に含まれるカラムであり、全文検索の条件に合致するレコードほど高い数値が入ります。

en: Specify output ranges
ja: 表示範囲指定

en: A :doc:`/reference/commands/select` command returns a part of its search result if ``offset`` and/or ``limit`` parameters are specified. These parameters are useful to paginate a search result, a widely-used interface which shows a search result on a page by page basis.
ja: :doc:`/reference/commands/select` コマンドにおいて ``offset`` 引数と ``limit`` 引数を用いることで、検索結果の一部のみを表示することができます。大量の検索結果を分割してページ単位で表示したい場合などに有用です。

en: An ``offset`` parameter specifies the starting point and a ``limit`` parameter specifies the maximum number of records to be returned. If you need the first record in a search result, the offset parameter must be 0 or omitted.
ja: ``offset`` 引数には、検索結果における始点を指定します。検索結果の1件目が必要な場合、 ``offset`` 引数を省略するか、0を指定するようにしてください。 ``limit`` 引数には、検索結果の表示件数を指定します。

en: Sort a search result
ja: 検索結果の並べ替え

en: A :doc:`/reference/commands/select` command sorts its result when used with a ``sort_keys`` parameter.
ja: :doc:`/reference/commands/select` コマンドに ``sort_keys`` 引数を渡すことにより、検索結果を並べ替えることができます。

en: A ``sort_keys`` parameter specifies a column as a sorting creteria. A search result is arranged in ascending order of the column values. If you want to sort a search result in reverse order, please add a leading hyphen ('-') to the column name in a parameter.
ja: ``sort_keys`` 引数には、整列の基準として用いるカラムを指定します。検索結果は指定したカラムの値が昇順になるように並べ替えられます。 ``sort_keys`` 引数の中でカラム名の前にハイフン（-）を付けることにより、降順に並べ替えることもできます。

en: The following example shows records in the Site table in reverse order.
ja: 以下の例では、Siteテーブルのレコードを逆順に表示しています。

en: The next example uses the _score column as the sorting criteria for ranking the search result. The result is sorted in relevance order.
ja: 次の例では、_scoreカラムを整列の基準とすることにより、検索結果のランキングをおこなっています。検索結果はクエリとの関連性が高い順に並べ替えられます。

en: If you want to specify more than one columns, please separate column names by commas (','). In such a case, a search result is sorted in order of the values in the first column, and then records having the same values in the first column are sorted in order of the second column values.
ja: 整列の基準となるカラムを複数指定したいときは、カンマ（,）区切りでカラムを列挙します。複数のカラムを指定したときは、最初のカラムを基準として整列した後、最初のカラムに同じ値が格納されているレコードを次のカラムを基準として整列します。

en: footnote
ja: 脚注

en: Currently, a ``match_columns`` parameter is available iff there exists an inverted index for full text search. A ``match_columns`` parameter for a regular column is not supported.
ja: 現在のバージョンでは、全文検索インデックスが存在する場合にのみ、 ``match_columns`` 引数を利用することができます。通常のカラムでの絞り込みには利用できません。
