groonga 2.0.6 - en to ja translation catalogue (45 entries)

en: Comparison
ja: 比較

en: There are many differences between :doc:`groonga` and :doc:`groonga-httpd`. Here is a comparison table.
ja: :doc:`groonga` と :doc:`groonga-httpd` にはたくさんの違いがあります。以下はそれらの違いを示す比較表です。

en: Performance
ja: 性能

en: o
ja: ○

en: Using multi CPU cores
ja: 複数CPUコア対応

en: o (by multi process)
ja: ○（マルチプロセスで対応）

en: o (by multi threading)
ja: ○（マルチスレッドで対応）

en: Configuration file
ja: 設定ファイル

en: optional
ja: なくてもよい

en: required
ja: 必須

en: Custom prefix path
ja: プレフィックスパスの変更

en: x
ja: ×

en: Custom command version
ja: コマンドバージョンの変更

en: Multi databases
ja: 複数データベース

en: Authentication
ja: 認証

en: Gzip compression
ja: gzip圧縮

en: Access log
ja: アクセスログ

en: Upgrading without downtime
ja: ダウンタイムなしでのアップグレード

en: Both :doc:`groonga` and :doc:`groonga-httpd` are very fast. They can work with the same throughput.
ja: :doc:`groonga` と :doc:`groonga-httpd` はどちらも非常に高速です。どちらも同じスループットで動きます。

en: Groonga scales on multi CPU cores. :doc:`groonga` scales by multi threading. :doc:`groonga-httpd` scales by multi processes.
ja: Groongaは複数のCPUコアを使って性能を向上できます。 :doc:`groonga` はマルチスレッドを使って性能を向上させます。 :doc:`groonga-httpd` はマルチプロセスを使って性能を向上させます。

en: :doc:`groonga` uses the same number of threads as CPU cores by default. If you have 8 CPU cores, 8 threads are used by default.
ja: :doc:`groonga` はデフォルトでCPUコアと同じ数のスレッドを使います。もし、CPUコアが8個あった場合は、デフォルトで8個のスレッドを使います。

en: :doc:`groonga-httpd` uses 1 process by default. You need to set `worker_processes <http://nginx.org/en/docs/ngx_core_module.html#worker_processes>`_ directive to use CPU cores. If you have 8 CPU cores, specify ``worker_processes 8`` in configuration file like the following::
ja: :doc:`groonga-httpd` はデフォルトで1つのプロセスを使います。複数のCPUコアを使う場合は `worker_processes <http://nginx.org/en/docs/ngx_core_module.html#worker_processes>`_ ディレクティブを設定する必要があります。CPUコアが8個ある場合は、以下のように設定ファイルに ``worker_processes 8`` と指定します。::

en: :doc:`groonga` can work without configuration file. All configuration items such as port number and the max number of threads can be specified by command line. Configuration file is also used to specify configuration items.
ja: :doc:`groonga` は設定ファイルがなくても動きます。ポート番号や最大スレッド数などといった設定項目はすべてコマンドラインから指定できます。設定ファイルを使っても設定項目を指定することができます。

en: It's very easy to run groonga HTTP server because :doc:`groonga` requires just a few options to run. Here is the most simple command line to start HTTP server by :doc:`groonga`::
ja: :doc:`groonga` はいくつかのオプションを指定するだけで実行できるので、非常に簡単にgroonga用のHTTPサーバーを起動することができます。以下は :doc:`groonga` でHTTPサーバーを起動する一番簡単なコマンドラインです。::

en: :doc:`groonga-httpd` requires configuration file to run. Here is the most simple configuration file to start HTTP server by :doc:`groonga-httpd`::
ja: :doc:`groonga-httpd` を実行するには設定ファイルが必須です。以下は :doc:`groonga-httpd` でHTTPサーバーを実行する一番簡単な設定ファイルです。::

en: :doc:`groonga` accepts a path that starts with ``/d/`` as command URL such as ``http://localhost:10041/d/status``. You cannot change the prefix path ``/d/``.
ja: :doc:`groonga` は ``/d/`` から始まるパスをコマンドURLとして受け付けます。例えば、 ``http://localhost:10041/d/status`` となります。この  ``/d/`` というプレフィックスパスを変更することはできません。

en: :doc:`groonga-httpd` can custom prefix path. For example, you can use ``http://localhost:10041/api/status`` as command URL. Here is a sample configuration to use ``/api/`` as prefix path::
ja: :doc:`groonga-httpd` はプレフィックスパスを変更することができます。例えば、 ``http://localhost:10041/api/status`` というコマンドURLを使うことができます。以下は ``/api/`` をプレフィックスパスとして使う設定例です。::

en: Groonga has :doc:`/reference/command/command_version` mechanism. It is for upgrading groonga commands with backward compatibility.
ja: Groongaには :doc:`/reference/command/command_version` という仕組みがあります。これは後方互換性を維持したままgroongaコマンドをアップグレードするための仕組みです。

en: :doc:`groonga` can change the default command veresion by ``--default-command-version`` option. Here is a sample command line to use command version 2 as the default command version::
ja: :doc:`groonga` は ``--default-command-version`` オプションでデフォルトのコマンドバージョンを変更できます。以下はデフォルトのコマンドバージョンとしてコマンドバージョン2を使うコマンドライン例です。::

en: :doc:`groonga-httpd` cannot custom the default command version yet. But it will be supported soon. If it is supported, you can provides different command version groonga commands in the same :doc:`groonga-httpd` process. Here is a sample configuration to provide command version 1 commands under ``/api/1/`` and command version 2 comamnds under ``/api/2/``::
ja: :doc:`groonga-httpd` はまだデフォルトのコマンドバージョンを変更できません。しかし、すぐにサポートする予定です。サポートされたら、同じ :doc:`groonga-httpd` プロセス内で異なったコマンドバージョンのgroongaコマンドを提供できます。以下はコマンドバージョン1のコマンドを ``/api/1/`` 以下で、コマンドバージョン2のコマンドを ``/api/2/`` 以下で提供するための設定例です。::

en: :doc:`groonga` can use only one database in a process.
ja: :doc:`groonga` は1つのプロセスで1つのデータベースしか使うことができません。

en: :doc:`groonga-httpd` can use one or more databases in a process. Here is a sample configuration to provide ``/tmp/db1`` database under ``/db1/`` path and ``/tmp/db2`` database under ``/db2/`` path::
ja: :doc:`groonga-httpd` は同一プロセス内で複数のデータベースを使うことができます。以下は ``/tmp/db1`` にあるデータベースを ``/db1/`` 以下で、 ``/tmp/db2`` にあるデータベースを ``/db2/`` 以下で提供する設定例です。::

en: HTTP supports authentications such as basic authentication and digest authentication. It can be used for restricting use of danger command such as :doc:`/reference/commands/shutdown`.
ja: HTTPではベーシック認証やダイジェスト認証などの認証方法をサポートしています。認証することにより :doc:`/reference/commands/shutdown` などのように危険なコマンドの実行を制限することができます。

en: :doc:`groonga` doesn't support any authentications. To restrict use of danger command, other tools such as iptables and reverse proxy are needed.
ja: :doc:`groonga` では認証できません。危険なコマンドの使用を制限するためには、iptablesやリバースプロキシなど他のツールを使う必要があります。

en: :doc:`groonga-httpd` supports basic authentication. Here is a sample configuration to restrict use of :doc:`/reference/commands/shutdown` command::
ja: :doc:`groonga-httpd` はベーシック認証をサポートしています。以下は :doc:`/reference/commands/shutdown` コマンドの使用を制限する設定例です。::

en: HTTP supports response compression by gzip with ``Content-Encoding: gzip`` response header. It can reduce network flow. It is useful for large search response.
ja: HTTPは ``Content-Encoding: gzip`` レスポンスヘッダーを付けてgzipでレスポンスを圧縮する機能をサポートしています。これはネットワーク流量を小さくすることができます。大きな検索結果を返すときに有用です。

en: :doc:`groonga` doesn't support compression. To support compression, reverse proxy is needed.
ja: :doc:`groonga` は圧縮をサポートしていません。圧縮をサポートするためには、リバースプロキシを使う必要があります。

en: :doc:`groonga-httpd` supports gzip compression. Here is a sample configuration to compress response by gzip::
ja: :doc:`groonga-httpd` はgzip圧縮をサポートしています。以下はレスポンスをgzipで圧縮する設定例です。::

en: Note that `gzip_types *` is specified. It's one of the important configuration. `gzip_types` specifies gzip target data formats by MIME types. :doc:`groonga-httpd` returns one of JSON, XML or MessagePack format data. But those formats aren't included in the default value of `gzip_types`. The default value of `gzip_types` is `text/html`.
ja: `gzip_types *` を指定していることに注意してください。この設定はとても重要な設定です。 `gzip_types` はgzip対象のデータフォーマットをMIMEタイプで指定します。 :doc:`groonga-httpd` は JSON、XML、MessagePackのどれかのフォーマットでデータを返します。しかし、これらのフォーマットは `gzip_types` のデフォルト値に含まれていません。 `gzip_types` のデフォルト値は `text/html` です。

en: To compress response data from :doc:`groonga-httpd` by gzip, you need to specify `gzip_types *` or `gzip_types application/json text/xml application/x-msgpack` explicitly. `gzip_types *` is recommended. There are two reasons for it. The first, groonga may support more formats in the future. The second, all requests for the `location` are processed by groonga. You don't need to consider about other modules.
ja: :doc:`groonga-httpd` のレスポンスデータをgzip圧縮するには、明示的に `gzip_types *` または `gzip_types application/json text/xml application/x-msgpack` と指定する必要があります。 `gzip_types *` の方がおすすめです。理由は2つあります。1つは、groongaが、将来、他のフォーマットもサポートする可能性もあるからという理由です。2つめは、この `location` のすべてのリクエストはgroongaが処理するので、他のモジュールのことについて考えなくてもよいからという理由です。

en: You can load your data by POST JSON data. You need follow the following rules to use loading by POST.
ja: JSONデータをPOSTすることでデータをロードすることができます。POSTでロードする場合は以下のルールに従ってください。

en: `Content-Type` header value must be `application/json`.
ja: `Content-Type` ヘッダーの値を `application/json` にする。

en: JSON data is sent as body.
ja: JSONデータはbodyとして送る。

en: Table name is specified by query parameter such as ``table=NAME``.
ja: テーブル名は ``table=名前`` というようにクエリーパラメーターで指定する。

en: Here is an example curl command line that loads two users `alice` and `bob` to `Users` table::
ja: 以下はcurlを使って `alice` と `bob` という2人のユーザーを `Users` テーブルにロードするコマンドラインの例です::
