1.2.1 - en to ja translation catalogue (85 entries)

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

en: groonga-httpd has been extracted as `groonga-nginx <https://github.com/groonga/groonga-nginx>`_ since Groonga 13.0.3.
ja: Groonga 13.0.3からgroonga-httpdは `groonga-nginx <https://github.com/groonga/groonga-nginx>`_ に切り出されました。

en: Summary
ja: 概要

en: groonga-httpd is a program to communicate with a Groonga server using the HTTP protocol. It functions as same as :doc:`groonga-server-http`. Although :doc:`groonga-server-http` has limited support for HTTP with a minimal built-in HTTP server, groonga-httpd has full support for HTTP with an embedded `nginx <http://nginx.org/>`_. All standards-compliance and features provided by nginx is also available in groonga-httpd.
ja: groonga-httpdはGroongaサーバーとHTTPプロトコルで通信するプログラムです。 機能的には、 :doc:`groonga-server-http` と同じです。 :doc:`groonga-server-http` はHTTPサーバーとしては最小限の機能しか持ちませんが、groonga-httpdは `nginx <http://www.nginx.org/>`_ を組み込むことでnginxが準拠しているHTTPの仕様と機能をすべて利用できます。

en: groonga-httpd has an Web-based administration tool implemented with HTML and JavaScript. You can access to it from http://hostname:port/.
ja: groonga-httpdにはHTML + JavaScriptで実装された管理ツールが標準で付属しています。ウェブブラウザでhttp://hostname:port/にアクセスすると、管理ツールを利用できます。

en: Syntax
ja: 構文

en: Usage
ja: 使い方

en: Set up
ja: 設定をする

en: First, you'll need to edit the groonga-httpd configuration file to specify a database. Edit /etc/groonga/httpd/groonga-httpd.conf to enable the ``groonga_database`` directive like this::
ja: まずは、データベースを指定するためにgroonga-httpdの設定ファイルを編集する必要があります。次のように/etc/groonga/httpd/groonga-httpd.confを編集して ``groonga_database`` ディレクティブを有効にしてます。

en: Then, run groonga-httpd. Note that the control immediately returns back to the console because groonga-httpd runs as a daemon process by default.::
ja: 次に、groonga-httpdを実行してください。すぐにターミナルに制御が戻ってきます。これはgroonga-httpdはデフォルトでデーモンプロセスになるからです。

en: Request queries
ja: クエリーを実行する

en: To check, request a simple query (:doc:`/reference/commands/status`).
ja: 動作を確認するため、簡単なクエリー（ :doc:`/reference/commands/status` ）をリクエストしてみます。

en: Loading data by POST
ja: POSTでのデータロード

en: You can load data by POST JSON data.
ja: JSONデータをPOSTするとデータをロードできます。

en: Here is an example ``curl`` command line that loads two users ``alice`` and ``bob`` to ``Users`` table::
ja: ``Users`` テーブルに ``alice`` と ``bob`` ユーザーをロードする ``curl`` のコマンドライン例は次の通りです::

en: If you loads users from JSON file, prepare JSON file like this::
ja: JSONファイルからユーザーをロードする場合は、次のようなJSONファイルを準備します::

en: Then specify JSON file in ``curl`` command line::
ja: それから ``curl`` のコマンドラインでJSONファイルを指定します::

en: Browse the administration tool
ja: 管理ツールを使う

en: Also, you can browse Web-based administration tool at http://localhost:10041/.
ja: 補足ですが、 http://localhost:10041/ にアクセスすると管理ツールを利用できます。

en: Shut down
ja: 終了する

en: Finally, to terminate the running groonga-httpd daemon, run this::
ja: 最後に、次のコマンドで動作中のgroonga-httpdデーモンを終了できます。

en: Configuration directives
ja: 設定ディレクティブ

en: This section describes only important directives. They are groonga-httpd specific directives and performance related directives.
ja: このセクションでは重要なディレクティブのみ説明します。重要なディレクティブとはgroonga-http特有のディレクティブと性能に関するディレクティブです。

en: The following directives can be used in the groonga-httpd configuration file. By default, it's located at /etc/groonga/httpd/groonga-httpd.conf.
ja: 以下のディレクティブはgroonga-httpdの設定ファイル中で使用することができます。デフォルトでは、設定ファイルは/etc/groonga/httpd/groonga-httpd.confに置かれています。

en: Groonga-httpd specific directives
ja: groonga-httpd特有のディレクティブ

en: The following directives aren't provided by nginx. They are provided by groonga-httpd to configure groonga-httpd specific configurations.
ja: 以下のディレクティブはnginxが提供しているものではなく、groonga-httpd関連の設定をするためにgroonga-httpdが提供しているディレクティブです。

en: Syntax::
ja: 構文::

en: Default
ja: デフォルト

en: Context
ja: コンテキスト

en: Specifies whether Groonga is enabled in the ``location`` block. The default is ``off``. You need to specify ``on`` to enable groonga.
ja: この ``location`` ブロックでGroongaを使うかどうかを指定します。デフォルトは ``off`` です。Groongaを使うためには ``on`` を指定してください。

en: Examples::
ja: 例::

en: Specifies the path to a Groonga database. This is the required directive.
ja: Groongaデータベースのパスを指定します。このディレクティブは必須です。

en: Specifies whether Groonga database is created automatically or not. If the value is ``on`` and the Groonga database specified by :ref:`groonga-httpd-groonga-database` doesn't exist, the Groonga database is created automatically. If the Groonga database exists, groonga-httpd does nothing.
ja: Groongaのデータベースを自動で作成するかどうかを指定します。もし、この値が ``on`` で :ref:`groonga-httpd-groonga-database` に指定したGroongaのデータベースが存在しない場合は自動でGroongaのデータベースを作成します。Groongaのデータベースが存在している場合は何もしません。

en: If parent directory doesn't exist, parent directory is also created recursively.
ja: もし、親ディレクトリが存在しな場合は再帰的に親ディレクトリも作成します。

en: The default value is ``on``. Normally, the value doesn't need to be changed.
ja: デフォルト値は ``on`` です。通常、この値を変更する必要はありません。

en: The same value as ``location`` name.
ja: ``location`` の名前と同じ値。

en: Specifies the base path in URI. Groonga uses ``/d/command?parameter1=value1&...`` path to run ``command``. The form of path in used in groonga-httpd but groonga-httpd also supports ``/other-prefix/command?parameter1=value1&...`` form. To support the form, groonga-httpd removes the base path from the head of request URI and prepend ``/d/`` to the processed request URI. By the path conversion, users can use custom path prefix and Groonga can always uses ``/d/command?parameter1=value1&...`` form.
ja: URIのベースパスを指定します。Groongaは ``command`` を実行するために ``/d/command?parameter1=value1&...`` というパスを使います。groonga-httpdでもこのパスの形式を使いますが、groonga-httpdは  ``/other-prefix/command?parameter1=value1&...`` というように ``/d/`` ではなく別のプレフィックスを使った形式もサポートしています。この別の形式もサポートするために、groonga-httpdはリクエストURIの先頭からベースパスを削除し、先頭に ``/d/`` を追加します。このパスの変換をすることにより、ユーザーはプレフィックスをカスタムできるようになりますが、Groongaは常に ``/d/command?parameter1=value1&...`` という形式で処理できます。

en: Nomally, this directive isn't needed. It is needed for per command configuration.
ja: 通常、このディレクティブを使う必要はありません。このディレクティブはコマンド毎に設定をしたい場合に使います。

en: Here is an example configuration to add authorization to :doc:`/reference/commands/shutdown` command::
ja: 以下は :doc:`/reference/commands/shutdown` コマンドに認証をかける設定例です。::

en: Specifies Groonga log path in the ``http``, ``server`` or ``location`` block. The default is ``/var/log/groonga/httpd/groonga.log``. You can disable logging to specify ``off``.
ja: Groongaのログ保存先を ``http`` 、``server`` もしくは ``location`` ブロックで指定します。デフォルトは ``/var/log/groonga/httpd/groonga.log`` です。ログを無効にするには ``off`` を指定します。

en: Specifies Groonga log level in the ``http``, ``server`` or ``location`` block. The default is ``notice``. You can disable logging by specifying ``none`` as log level.
ja: Groongaのログレベルを ``http`` 、 ``server`` もしくは ``location`` ブロックで指定します。デフォルトは ``notice`` です。 ``none`` を指定することでログを無効にできます。

en: Specifies Groonga's query log path in the ``http``, ``server`` or ``location`` block. The default is ``/var/log/groonga/httpd/groonga-query.log``.  You can disable logging to specify ``off``.
ja: Groongaのクエリーログの保存先を ``http`` 、``server`` もしくは ``location`` ブロックで指定します。デフォルトは ``/var/log/groonga/httpd/groonga-query.log`` です。ログを無効にするには ``off`` を指定します。

en: Query log is useful for the following cases:
ja: クエリーログは以下のようなケースで有用です:

en: Detecting slow query.
ja: スロークエリーを見つける。

en: Debugging.
ja: デバッグ。

en: You can analyze your query log by `groonga-query-log package <https://github.com/groonga/groonga-query-log>`_. The package provides useful tools.
ja: `groonga-query-log パッケージ <https://github.com/groonga/groonga-query-log>`_ でクエリーログを解析できます。このパッケージは有用なツールを提供しています。

en: For example, there is a tool that analyzing your query log. It can detect slow queries from your query log. There is a tool that replaying same queries in your query log. It can test the new Groonga before updating production environment.
ja: 例えば、クエリーログを解析するツールがあります。これを使えば、スロークエリーを見つけることができます。クエリーログ内のすべてのクエリーを再生するツールもあります。これを使えば、新しいGroongaをプロダクション環境にデプロイする前に網羅的にテストすることができます。

en: Performance related directives
ja: 性能関連のディレクティブ

en: The following directives are related to the performance of groonga-httpd.
ja: 以下のディレクティブはgronoga-httpdの性能に関連しているディレクティブです。

en: For optimum performance, set this to be equal to the number of CPUs or cores. In many cases, Groonga queries may be CPU-intensive work, so to fully utilize multi-CPU/core systems, it's essential to set this accordingly.
ja: 最適なパフォーマンスを得るためには、CPU数あるいはコア数と同じ数になるようにこのディレクティブを設定してください。大抵の場合、GroongaのクエリーはCPU負荷が高いものとなり、複数のCPU/コアを使い切るためには、このディレクティブを設定する必要があります。

en: This isn't a groonga-httpd specific directive, but an nginx's one. For details, see http://wiki.nginx.org/CoreModule#worker_processes.
ja: このディレクティブはgroonga-httpdのディレクティブではなく、nginxのディレクティブです。詳細は、 http://wiki.nginx.org/CoreModule#worker_processes を参照してください。

en: By default, this is set to 1. It is nginx's default.
ja: デフォルトで、このディレクティブには1が設定されています。

en: Specifies Groonga's limit of query cache in the ``http``, ``server`` or ``location`` block. The default value is 100. You can disable query cache to specify 0 to ``groonga_cache_limit`` explicitly.
ja: Groongaのクエリキャッシュの制限を ``http`` 、 ``server`` もしくは ``location`` ブロックで指定します。デフォルトは ``100`` です。 ``0`` を指定することで ``groonga_cache_limit`` を明示的に無効にできます。

en: Specifies the base path of query cache in the ``http``, ``server`` or ``location`` block.
ja: クエリーキャッシュの保存先のベースになるパスを ``http`` 、 ``server`` もしくは ``location`` ブロックで指定します。

en: It's recommended that you specify this configuration when you use multi-workers configuration.
ja: マルチワーカーの設定をしている場合はこの設定をすることをオススメします。

en: If the base path is specified, you can use persistent cache instead of on memory cache. If you use persistent cache, workers share query cache. It's efficient for multi-workers configuration because the same response is cached only once in multiple workers.
ja: ベースのパスを指定すると、メモリーキャッシュではなく永続キャッシュを使えます。永続キャッシュを使うと、ワーカー間でクエリーキャッシュを共有できます。複数のワーカー間で同じレスポンスを1回だけキャッシュするので複数ワーカー設定のときに効率的です。

en: There is one more merit for persistent cache. You don't need to warm up cache after groonga-httpd is restarted. Persistent cache isn't cleared when groonga-httpd is down. groonga-httpd can use existing persistent cache again.
ja: 永続キャッシュにはもう1つメリットがあります。groonga-httpdを再起動した後にキャッシュをウォームアップ必要がありません。groonga-httpdが停止しても永続キャッシュは消えません。そのため、既存の永続キャッシュを再利用することができます。

en: The default value is ``off``. It means that persistent cache is disabled. On memory cache is used. On memory cache is independent in each worker. It's not efficient for multi-workers configuration because two or more workers may keeps the same response separately.
ja: デフォルト値は ``off`` です。これは永続キャッシュは無効ということです。メモリーキャッシュが使われます。メモリーキャッシュはワーカー毎に独立しています。複数のワーカーがそれぞれで同じレスポンスをキャッシュする可能性があるため、複数ワーカー設定のときはメモリーキャッシュは効率的ではありません。

en: Persistent cache is a bit slower than on memory cache. Normally, the difference has little influence on performance.
ja: 永続キャッシュはメモリーキャッシュよりも少し遅いです。通常、この差によるパフォーマンスの影響は軽微です。

en: You must specify the base path on memory file system. If you specify the base path on disk, your cache will be slow. It's not make sense.
ja: このベースとなるパスはメモリーファイルシステム上のパスを指定するべきです。ディスク上にベースとなるパスを指定するとキャッシュが遅くなります。これでは意味がありません。

en: In short, you can use nginx's reverse proxy and cache mechanism instead of Groonga's built-in query cache feature.
ja: まとめると、Groonga組み込みのクエリーキャッシュ機能の代わりにnginxのリバースプロキシとキャッシュの仕組みを使うこともできます。

en: Query cache
ja: クエリーキャッシュ

en: Groonga has query cache feature for :doc:`/reference/commands/select` command. The feature improves performance in many cases.
ja: groongaは :doc:`/reference/commands/select` コマンド用にクエリーキャッシュ機能を提供しています。この機能は多くのケースで性能向上を実現します。

en: Query cache feature works well on groonga-httpd except you use :doc:`/reference/commands/cache_limit` command on 2 or more workers. Normally, :doc:`/reference/commands/cache_limit` command isn't used. So there is no problem on many cases.
ja: クエリーキャッシュ機能は :doc:`/reference/commands/cache_limit` コマンドを使っていないあるいはワーカー数が1だけの場合はgroonga-httpd上でもきちんと動作します。通常、 :doc:`/reference/commands/cache_limit` コマンドは使わないので、多くの場合は問題がありません。

en: Here is a description about a problem of using :doc:`/reference/commands/cache_limit` command on 2 or more workers.
ja: 2ワーカー以上で :doc:`/reference/commands/cache_limit` コマンドを使ったときの問題点を説明します。

en: Groonga's query cache is available in the same process. It means that workers can't share the cache. If you don't change cache size, it isn't a big problem. If you want to change cache size by :doc:`/reference/commands/cache_limit` command, there is a problem.
ja: groongaのクエリーキャッシュは同じプロセス内で有効です。これは、同じキャッシュを複数のワーカー間で共有できないということです。キャッシュサイズを変更しないならこれは大きな問題ではありません。もし、 :doc:`/reference/commands/cache_limit` コマンドでキャッシュサイズを変更したいなら問題になります。

en: There is no portable ways to change cache size for all workers.
ja: すべてのワーカーのキャッシュサイズを変更する汎用的な方法がないのです。

en: For example, there are 3 workers::
ja: 例えば、3ワーカーいるとします::

en: The client requests :doc:`/reference/commands/cache_limit` command and the worker 1 receives it::
ja: クライアントが :doc:`/reference/commands/cache_limit` コマンドをリクエストし、worker 1が受け取りました::

en: The client requests :doc:`/reference/commands/cache_limit` command again and the worker 1 receives it again::
ja: クライアントがもう一度 :doc:`/reference/commands/cache_limit` コマンドをリクエストし、またworker 1が受け取りました::

en: In this case, the worker 2 and the worker 3 aren't received any requests. So they don't change cache size.
ja: この場合、worker 2とworker 3は1つもリクエストを受けとっていません。そのため、これらのワーカーのキャッシュサイズは変更されていません。

en: You can't choose a worker. So you can't change cache sizes of all workers by :doc:`/reference/commands/cache_limit` command.
ja: クライアントはワーカーを選ぶことができないので、 :doc:`/reference/commands/cache_limit` コマンドですべてのワーカのキャッシュサイズを変更することができないのです。

en: Reverse proxy and cache
ja: リバースプロキシとキャッシュ

en: You can use nginx's reverse proxy and cache feature for query cache::
ja: nginxのリバースプロキシ機能とキャッシュ機能を使ってクエリーキャッシュを実現できます::

en: You can use the same cache configuration for all workers but you can't change cache configuration dynamically by HTTP.
ja: この方法ではすべてのワーカーで同じキャッシュの設定を利用できますが、HTTPで動的にキャッシュの設定を変更することはできません。

en: Here is a sample configuration::
ja: 以下はサンプルの設定です::

en: See the following nginx documentations for parameter details:
ja: パラメーターの詳細は以下のnginxのドキュメントを見てください:

en: Note that you need to remove cache files created by nginx by hand after you load new data to Groonga. For the above sample configuration, run the following command to remove cache files::
ja: Groongaに新しいデータをロードしたときは自分でnginxが作ったキャッシュファイルを削除しなければいけないことに注意してください。前述のサンプル設定では、以下のコマンドでキャッシュを消せます::

en: If you use Groonga's query cache feature, you don't need to expire cache by hand. It is done automatically.
ja: Groongaのクエリーキャッシュ機能を使うと、手動でキャッシュを失効する必要はありません。自動で失効します。

en: nginx log related directives
ja: nginxログ関連のディレクティブ

en: We can output nginx's log by the ``access_log`` directive. The following example is the default nginx's log settings::
ja: nginxのログを ``access_log`` ディレクティブを使うことで出力できます。以下の例は、デフォルトのnginxのログ設定です。::

en: We can specify log format by ``log_format`` directive. For the details of available items of the log, see `Module ngx_http_log_module <http://nginx.org/en/docs/http/ngx_http_log_module.html>`_.
ja: ``log_format`` ディレクティブを使って、ログのフォーマットを指定できます。利用できるログの項目の詳細は、 `Module ngx_http_log_module <http://nginx.org/en/docs/http/ngx_http_log_module.html>`_ を参照してください。

en: nginx's access log is outputted when a requests is processed. If we want to output the request processing time, we need to set configuration as below::
ja: nginxのアクセスログは、処理終了時に出力されます。リクエスト処理時間を出力したい場合は、以下のように設定する必要があります。::

en: Available nginx modules
ja: 利用可能なnginxモジュール

en: All standard HTTP modules are available. HttpRewriteModule is disabled when you don't have PCRE (Perl Compatible Regular Expressions). For the list of standard HTTP modules, see `nginx documentation <http://nginx.org/en/docs/>`_.
ja: 全てのHTTPの標準モジュールが利用可能です。PCRE（Perl Compatible Regular Expressions）がない場合はHttpRewriteModuleは無効になります。標準モジュールの一覧は、 `nginx documentation <http://nginx.org/en/docs/>`_ を参照してください。
