1.2.1 - en to ja translation catalogue (119 entries)

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

en: Summary
ja: 概要

en: ``groonga-suggest-httpd`` is a program that provides HTTP interface for the following features:
ja: ``groonga-suggest-httpd`` は次の機能に対するHTTPインターフェイスを提供するプログラムです。

en: Returning :doc:`/reference/suggest` execution result
ja: :doc:`/reference/suggest` を実行した結果を返す

en: Saving logs for learning
ja: 学習用にログを保存する

en: ``groonga-suggest-httpd`` provides suggest feature like :doc:`/reference/commands/suggest` command. Note that some parameter names are different of them.
ja: ``groonga-suggest-httpd`` は :doc:`/reference/commands/suggest` コマンドのようなサジェスト機能を提供します。いくつかパラメーター名が異なることに注意してください。

en: Syntax
ja: 構文

en: ``groonga-suggest-httpd`` requires database path::
ja: ``groonga-suggest-httpd`` にはデータベースのパスを指定します。::

en: Usage
ja: 使い方

en: You need to create one or more datasets to use ``groonga-suggest-httpd``. A dataset consists of tables and columns. You can define them by :doc:`groonga-suggest-create-dataset`.
ja: ``groonga-suggest-httpd`` を使う場合は1つ以上のデータセットを作る必要があります。データセットはテーブルとカラムの集まりです。これらのテーブル・カラムは :doc:`groonga-suggest-create-dataset` で作成できます。

en: You need to use :doc:`groonga-suggest-learner` to learn suggestion data from user inputs. You doesn't need to use :doc:`groonga-suggest-learner` when you create suggestion data by hand. See :doc:`/reference/suggest` and sub documents about creating suggestion data by hand.
ja: ユーザーの入力からサジェスト用データを学習するには :doc:`groonga-suggest-learner` を使う必要があります。手動でサジェスト用データを作成する場合は :doc:`groonga-suggest-learner` を使う必要はありません。手動でサジェスト用データを作る方法については :doc:`/reference/suggest` とその関連ドキュメントを参照してください。

en: You can use ``groonga-suggest-httpd`` via HTTP after you create one or more datasets.
ja: 1つ以上のデータセットを作ったらHTTP経由で ``groonga-suggest-httpd`` を使えます。

en: The following sections describes the followings:
ja: つづくセクションでは次のことについて説明します。

en: How to set up a dataset
ja: データセットのセットアップ方法

en: How to use ``groonga-suggest-httpd`` with :doc:`groonga-suggest-learner`
ja: :doc:`groonga-suggest-learner` と一緒に ``groonga-suggest-httpd`` を使う方法

en: How to use ``groonga-suggest-httpd`` for retrieving suggestions.
ja: サジェスト結果を取得するために ``groonga-suggest-httpd`` を使う方法

en: Setup
ja: セットアップ

en: You need to create a dataset by :doc:`groonga-suggest-create-dataset`.
ja: :doc:`groonga-suggest-create-dataset` でデータセットを作ります。

en: Here is an example that creates ``query`` dataset:
ja: 以下は ``query`` データセットを作る例です。

en: :doc:`groonga-suggest-create-dataset` outputs executed commands. You can confirm that what tables and columns are created for the new dataset.
ja: :doc:`groonga-suggest-create-dataset` は実行したコマンドを出力します。新しいデータセット用にどんなテーブル・カラムを作ったかを確認できます。

en: Launch ``groonga-suggest-learner``
ja: ``groonga-suggest-learner`` を起動

en: You can choose whether you use learned suggestion data immediately or not.
ja: 学習したサジェストデータをすぐに使うかどうかを選択できます。

en: There are two ways to use learned suggestion data immediately:
ja: 学習したサジェストデータをすぐに使う方法は2つあります。

en: Both of ``groonga-suggest-httpd`` and :doc:`groonga-suggest-learner` use the same database
ja: ``groonga-suggest-httpd`` と :doc:`groonga-suggest-learner` のどちらも同じデータベースを使う

en: ``groonga-suggest-httpd`` receives learned suggestion data from :doc:`groonga-suggest-learner`
ja: ``groonga-suggest-httpd`` が :doc:`groonga-suggest-learner` から学習したサジェストデータを受け取る

en: In the former case, you must run both ``groonga-suggest-httpd`` and :doc:`groonga-suggest-learner` on the same host.
ja: 前者のケースでは、 ``groonga-suggest-httpd`` と :doc:`groonga-suggest-learner` を同じホスト上で実行しなければいけません。

en: In the latter case, you can run ``groonga-suggest-httpd`` and :doc:`groonga-suggest-learner` on different hosts.
ja: 後者のケースでは、 ``groonga-suggest-httpd`` と :doc:`groonga-suggest-learner` を違うホストで動かせます。

en: If you don't need to use learned suggestion data immediately, you need to apply learned suggestion data from database that is used by :doc:`groonga-suggest-learner` to database that is used by ``groonga-suggest-httpd`` by hand. Normally, this usage is recommended. Because learned suggestion data may have garbage data by inputs from evil users.
ja: 学習したサジェストデータをすぐに使う必要がないとき、 :doc:`groonga-suggest-learner` が使っているデータベースから ``groonga-suggest-httpd`` が使っているデータベースに学習したサジェストデータを主導で反映する必要があります。通常、こちらの使い方を推奨します。なぜなら学習したサジェストデータには悪意のあるユーザーが入力由来のゴミデータが含まれているかもしれないからです。

en: In this document, learned suggestion data are used immediately by receiving learned suggestion data from :doc:`groonga-suggest-learner`. Both ``groonga-suggest-httpd`` and :doc:`groonga-suggest-learner` are running on the same host. Because it's easy to explain.
ja: このドキュメントでは :doc:`groonga-suggest-learner` から学習したサジェストデータを受け取り、学習したサジェストデータをすぐに使います。 ``groonga-suggest-httpd`` と :doc:`groonga-suggest-learner` はどちらも同じホストで動かします。これは説明しやすいからです。

en: Here is an example that launches :doc:`groonga-suggest-learner`. You need to specify database that has ``query`` dataset. This document omits the instruction for creating ``query`` dataset:
ja: 以下は :doc:`groonga-suggest-learner` を起動する例です。 ``query`` データセットがあるデータベースを指定します。このドキュメントでは ``query`` データセットを作る手順は省略します。

en: The ``groonga-suggest-learner`` process opens two endpoints at ``1234`` port and ``1235`` port:
ja: ``groonga-suggest-learner`` プロセスは2つのエンドポイントを提供します。それぞれ ``1234`` 番ポートと ``1235`` 番ポートを使います。

en: ``1234`` port: Endpoint that accepts user input data from ``groonga-suggest-httpd``
ja: ``1234`` 番ポート： ``groonga-suggest-httpd`` からユーザーの入力を受け付けるエンドポイント

en: ``1235`` port: Endpoint that sends learned suggestion data to ``groonga-suggest-httpd``
ja: ``1235`` 番ポート： ``groonga-suggest-httpd`` に学習したサジェストデータを送信するエンドポイント

en: Launch ``groonga-suggest-httpd``
ja: ``groonga-suggest-httpd`` を起動

en: You need to launch ``groonga-suggest-httpd`` for the following proposes:
ja: 次の目的のため、 ``groonga-suggest-httpd`` を起動します。

en: Learning suggestion data from user inputs
ja: ユーザーの入力からサジェストデータを学習するため

en: Providing suggestion result to clients
ja: サジェスト結果をクライアントに提供するため

en: Here is an example that launches ``groonga-suggest-httpd`` that communicates :doc:`groonga-suggest-learner`:
ja: 以下は :doc:`groonga-suggest-learner` と通信する ``groonga-suggest-httpd`` を起動する例です。

en: The ``groonga-suggest-httpd`` process accepts HTTP requests on ``8080`` port.
ja: ``groonga-suggest-httpd`` プロセスは ``8080`` 番ポートでHTTPリクエストを受け付けます。

en: If you want to save requests into log file, use :option:`--log-base-path` option.
ja: リクエストをログファイルに保存したい場合は :option:`--log-base-path` オプションを指定してください。

en: Here is an example to save log files under ``logs`` directory with ``log`` prefix for each file::
ja: 以下は各ログファイルに ``log`` というプレフィックスをつけて ``logs`` ディレクトリーに保存する例です。::

en: ``groonga-suggest-httpd`` creates log files such as ``logYYYYmmddHHMMSS-00`` under ``logs`` directory.
ja: ``groonga-suggest-httpd`` は ``logYYYYmmddHHMMSS-00`` という名前のログファイルを作成し、 ``logs`` ディレクトリー以下に保存します。

en: Learn from user inputs
ja: ユーザーの入力から学習

en: You can learn suggestion data from user inputs.
ja: ユーザーの入力からサジェストデータを学習できます。

en: You need to specify the following parameters to learn suggestion data:
ja: サジェストデータを学習するには次のパラメーターを指定する必要があります。

en: ``l``: The dataset name
ja: ``l`` ：データセット名

en: ``s``: The timestamp of the input in seconds
ja: ``s`` ：入力のタイムスタンプ。単位は秒。

en: ``t``: The query type (It's optional. You must specify ``submit`` only when the user input is submitted.)
ja: ``t`` ：クエリーの種類。（省略可能。ユーザーの入力がサブミットされたときだけ ``submit`` を指定します。）

en: ``q``: The user input
ja: ``q`` ：ユーザーの入力

en: Here are example requests to learn user input "Groonga" in ``query`` dataset::
ja: 以下は ``query`` データセットで「Groonga」というユーザーの入力を学習するリクエスト例です。

en: Inputting data must not use ``t=submit`` parameter. In the above example, you just learn user inputs but you can learn and get complete candidates at once. It's described at the next section.
ja: 入力中のデータに ``t=submit`` パラメーターをつけてはいけません。上の例では、ユーザーの入力を学習しているだけですが、ユーザーの入力を学習しながら同時に補完候補を取得することもできます。これは次のセクションで説明します。

en: Submitted data must use ``t=submit`` parameter.
ja: サブミットされたデータには ``t=submit`` パラメーターをつけます。

en: Use suggested response
ja: サジェスト結果を使う

en: You can get suggested result from ``groonga-suggest-httpd``.
ja: ``groonga-suggest-httpd`` からのサジェスト結果を使えます。

en: You need to specify the following parameters to get suggested result:
ja: サジェスト結果を取得するには次のパラメーターを指定します。

en: ``n``: The dataset name
ja: ``n`` ：データセット名

en: ``t``: The query type (``complete``, ``correct`` and/or ``suggest``)
ja: ``t`` ：クエリーの種類（ ``complete`` 、 ``correct`` 、 ``suggest`` のどれか。複数指定も可。）

en: You can also specify parameters for :doc:`/reference/commands/suggest` as option.
ja: :doc:`/reference/commands/suggest` のパラメーターを指定することもできます。

en: Here is an example that gets :doc:`/reference/suggest/completion` result. The result is computed by using learned data at the previous section. ``frequency_threshold=1`` parameter is used because this is an example. The parameter enables input data that are occurred one or more times. Normally, you should not use the parameter for production. The parameter will increase noises:
ja: 以下は :doc:`/reference/suggest/completion` 結果を取得する例です。この結果は前のセクションで学習したデータを使って計算しています。 ``frequency_threshold=1`` パラメーターを使っているのはこれが例だからです。このパラメーターは1回以上出現した入力データも有効なデータとします。通常、プロダクション環境ではこのパラメーターを指定するべきではありません。ノイズが増える可能性が高いからです。

en: You can combine completion and learning by specifying parameters for both:
ja: 補完用と学習用のどちらのパラメーターも指定することで補完と学習を組み合わせることができます。

en: Command line parameters
ja: コマンドライン引数

en: Required parameters
ja: 必須引数

en: There is only one required parameter.
ja: 必須の引数は1つです。

en: Specifies the path to a Groonga database. This database must have one or more datasets. Each dataset must be created by :doc:`groonga-suggest-create-dataset`.
ja: Groongaのデータベースのパスを指定します。このデータベースには1つ以上のデータセットを作っておいてください。各データセットは :doc:`groonga-suggest-create-dataset` で作ります。

en: Optional parameters
ja: 省略可能引数

en: Specify HTTP server port number.
ja: HTTPサーバーのポート番号を指定します。

en: The default port number is ``8080``.
ja: デフォルトのポート番号は ``8080`` です。

en: Specify number of threads.
ja: 最大スレッド数を指定します。

en: This option accepts ``128`` as the max value, but use the number of CPU cores for performance.
ja: 最大で128を指定できますが、パフォーマンスを出すためには最大でもCPUコア数を指定する方がよいです。

en: The default value is the number of CPU cores.
ja: デフォルトはコア数です。

en: Specify endpoint URI of :doc:`groonga-suggest-learner` for sending user inputs.
ja: ユーザーの入力送信先になる :doc:`groonga-suggest-learner` のエンドポイントURIを指定します。

en: The format is ``tcp://${HOST}:${PORT}`` such as ``tcp://192.168.0.1:2929``.
ja: フォーマットは ``tcp://${HOST}:${PORT}`` です。たとえば、 ``tcp://192.168.0.1:2929`` のように指定します。

en: The default value is none.
ja: デフォルト値はありません。

en: Specify endpoint URI of :doc:`groonga-suggest-learner` for receiving learned suggestion data.
ja: :doc:`groonga-suggest-learner` が学習済みのサジェストデータを受信するために使用するURIを指定します。

en: Specify path prefix of log.
ja: ログのパス名のプレフィックスを指定します。

en: Specify the max number of lines in a log file.
ja: 1つのログファイルの最大行数を指定します。

en: The default value is ``1000000``.
ja: デフォルトは ``1000000`` （100万行）です。

en: Specify this option to daemonize.
ja: デーモン化する場合に指定します。

en: Don't daemonize by default.
ja: デフォルトではデーモン化しません。

en: Specify this option to disable checking the max number of file descriptors on start.
ja: 起動時の最大ファイルディスクリプター数のチェックを無効化する場合に指定します。

en: Check by default.
ja: デフォルトはチェックします。

en: GET parameters
ja: GETの引数

en: ``groonga-suggest-httpd`` accepts some GET parameters.
ja: ``groonga-suggest-httpd`` GETパラメーターを受け付けます。

en: There are required parameters which depend on query type.
ja: 必須の引数があります。どれが必須かはクエリーの種類に依存します。

en: In ``complete``, ``correct`` or ``suggest`` query type, unhandled parameters are passed through :doc:`/reference/commands/suggest`. It means that you can use parameters of :doc:`/reference/commands/suggest`.
ja: クエリーの種類が ``complete`` 、 ``correct`` 、 ``suggest`` のどれかのときは、道のパラメーターは :doc:`/reference/commands/suggest` にそのまま渡します。つまり、 :doc:`/reference/commands/suggest` のパラメーターを使うことができます。

en: You must specify the following parameters.
ja: 次のパラメーターを指定する必要があります。

en: Key
ja: キー

en: Description
ja: 説明

en: Note
ja: 備考

en: Input by user. It must be UTF-8 encoded string.
ja: ユーザーの入力。UTF-8でエンコードされた文字列です。

en: Required parameters for learning
ja: 学習時に必須の引数

en: You must specify the following parameters when you specify :option:`--send-endpoint`.
ja: :option:`--send-endpoint` を指定したときは次のパラメーターを指定しなければいけません。

en: Elapsed time since ``1970-01-01T00:00:00Z``.
ja: ``1970-01-01T00:00:00Z`` から経過時間。

en: The unit is millisecond.
ja: 単位はミリ秒。

en: Unique ID to distinct each user
ja: 各ユーザーを識別するユニークなID。

en: Session ID, IP address and so on will be usable for this value.
ja: セッションID、IPアドレスなどを使うことができるでしょう。

en: One or more learn target dataset names. You need to use ``|`` as separator such as ``dataset1|dataset2|dataset3``.
ja: 1つ以上の学習対象のデータセット名。複数のデータセットを指定する場合は ``dataset1|dataset2|dataset3`` のように区切り文字として ``|`` を使います。

en: Dataset name is the name that you specify to :doc:`groonga-suggest-create-dataset`.
ja: データセット名は :doc:`groonga-suggest-create-dataset` で指定した名前です。

en: Required parameters for suggestion
ja: サジェスト時に必須の引数

en: You must specify the following parameters when you specify one of ``complete``, ``correct`` and ``suggest`` to ``t`` parameter.
ja: ``t`` パラメータに ``complete`` 、 ``correct`` 、 ``suggest`` のどれかを指定したときは次のパラメーターを指定する必要があります。

en: The dataset name to use computing suggestion result.
ja: サジェスト結果を計算するときに使うデータセット名。

en: The query type.
ja: クエリーの種類。

en: Available values are ``complete``, ``correct``, ``suggest``.
ja: ``complete`` 、 ``correct`` 、 ``suggest`` のどれか。

en: You can specify multiple types. You need to use ``|`` as separator such as ``complete|correct``.
ja: 複数の種類を指定することもできます。複数指定するときは ``complete|correct`` のように ``|`` で区切ってください。

en: Here are optional parameters.
ja: いくつか省略可能な引数があります。

en: Function name for JSONP
ja: JSONPの関数名

en: Optional parameters for learning
ja: 学習時に指定可能な引数

en: Here are optional parameters when you specify :option:`--send-endpoint`.
ja: :option:`--send-endpoint` オプションを指定したときに指定可能なパラメーターは次の通りです。

en: Available value is only ``submit``.
ja: 指定可能な値は ``submit`` だけです。

en: You must specify ``submit`` when user submits the input specified as ``q``.
ja: ユーザーが ``q`` で指定した入力をサブミットしたときは ``submit`` を指定してください。

en: You must not specify ``submit`` for user inputs that aren't submitted yet. You can use suggestion by specifying ``complete``, ``correct`` and/or ``suggest`` to ``t`` when you doesn't specify ``submit``. See :ref:`groonga-suggest-httpd-required-parameters-suggestion` for details about these values.
ja: まだサブミットされていないユーザーの入力を指定するときは ``submit`` を指定しないでください。 ``submit`` を指定していないときに ``t`` に ``complete`` 、 ``correct`` 、 ``suggest`` のうち1つ以上を指定するとサジェスト結果を使えます。これらの ``t`` に指定する値については :ref:`groonga-suggest-httpd-required-parameters-suggestion` を参照してください。

en: Return value
ja: 戻り値

en: ``groonga-suggest-httpd`` returns the following format response. It's the same format as body of :doc:`/reference/commands/suggest`::
ja: ``groonga-suggest-httpd`` のレスポンスは次のフォーマットになります。 :doc:`/reference/commands/suggest` のボディ部分と同じです。::

en: Here is the response when ``t`` is ``submit``::
ja: ``t`` に ``submit`` を指定したときのレスポンスは次の通りです。::

en: One of ``complete``, ``correct`` and ``suggest``.
ja: ``complete`` 、 ``correct`` 、 ``suggest`` のどれか。

en: The string of candidate in UTF-8.
ja: UTF-8でエンコードされた候補文字列。

en: The score of the candidate.
ja: 候補のスコアー。

en: Candidates are sorted by score descendant.
ja: スコアーの降順でソートされた候補リスト。

en: See also
ja: 参考
