YUKI Hiroshi
null+****@clear*****
Thu May 7 17:46:47 JST 2015
YUKI Hiroshi 2015-05-07 17:46:47 +0900 (Thu, 07 May 2015) New Revision: d4d4a58628da7c5ebf118a25c3bb07b74c130c7a https://github.com/droonga/droonga.org/commit/d4d4a58628da7c5ebf118a25c3bb07b74c130c7a Message: Update translation Modified files: _po/ja/reference/1.1.0/command-line-tools/droonga-request/index.po _po/ja/reference/1.1.1/command-line-tools/droonga-request/index.po ja/reference/1.1.0/command-line-tools/droonga-request/index.md ja/reference/1.1.1/command-line-tools/droonga-request/index.md Modified: _po/ja/reference/1.1.0/command-line-tools/droonga-request/index.po (+59 -7) =================================================================== --- _po/ja/reference/1.1.0/command-line-tools/droonga-request/index.po 2015-05-07 17:46:35 +0900 (2fb6325) +++ _po/ja/reference/1.1.0/command-line-tools/droonga-request/index.po 2015-05-07 17:46:47 +0900 (5e6a92f) @@ -28,18 +28,23 @@ msgid "" "onse.\n" "For Droonga Engine nodes you can send a Droonga native message directly." msgstr "" +"`droonga-request`は、任意のメッセージをDroongaクラスタに送り、レスポンスとして得られた結果を出力します。\n" +"このコマンドはDroonga Engineノードに対してDroongaネイティブのメッセージを直接送れます。\n" msgid "## Usage {#usage}" msgstr "## 使い方 {#usage}" msgid "### Basic usage" -msgstr "" +msgstr "### 基本的な使い方" msgid "" "For example, if there is a Droonga Engine node `192.168.100.50` and you are lo" "gged in to a computer `192.168.100.10` in the same network segment, the comman" "d line to send a [`system.status`](../../commands/system/status/) command is:" msgstr "" +"例えば、`192.168.100.50`というDroonga Engineノードがあり、同一ネットワークセグメント内のコンピュータ`192.168.100." +"10`にログインしている場合、[`system.status`](../../commands/system/status/)コマンドのメッセージを送信する" +"コマンド列は以下のようになります：" msgid "" "~~~\n" @@ -70,6 +75,8 @@ msgid "" "The first line is the elapsed time to get the response.\n" "Following lines are the response message." msgstr "" +"1行目はレスポンスを得るまでにかかった時間です。\n" +"後の行はレスポンスメッセージとして得られた内容です。" msgid "" "As described at the [message format reference](../../message/), `id`, `date`, " @@ -79,6 +86,10 @@ msgid "" "You can see the completed message actually sent with the option `--report-requ" "est`, like:" msgstr "" +"[メッセージの形式のリファレンス](../../message/)の説明にある通り、`id`、`date`、`dataset`の各フィールドはリクエストメッ" +"セージの必須フィールドです。\n" +"与えられたメッセージがそれらを持っていなかった場合、このコマンドは初期状態で、適切な値を推測または生成して補います。\n" +"実際に送信された補完後のメッセージを見るには、`--report-request`オプションを指定して下さい：" msgid "" "~~~\n" @@ -98,10 +109,10 @@ msgstr "" msgid "" "For the complete list of available commands, see also [the command reference](" "../../commands/)." -msgstr "" +msgstr "利用可能な全てのコマンドの一覧については、[コマンドリファレンス](../../commands/)を併せて参照して下さい。" msgid "### Combination with other commands" -msgstr "" +msgstr "### 他のコマンドとの連携" msgid "" "This command accepts messages to be sent via standard input.\n" @@ -110,6 +121,9 @@ msgid "" "For example, you'll be able to use [`drndump`](../drndump/)'s output as the so" "urce:" msgstr "" +"このメッセージは標準入力を通じて送信するメッセージを受け取れます。\n" +"上記の例のように、`echo`、`cat`、およびその他のコマンドをこのコマンドのための入力ソースとして利用できます。\n" +"例えば、[`drndump`](../drndump/)の出力もそのまま入力ソースとして利用できます：" msgid "" "~~~\n" @@ -121,12 +135,14 @@ msgid "" msgstr "" msgid "### Input from file" -msgstr "" +msgstr "### ファイルからの入力" msgid "" "You can use a text file as the source.\n" "This command reads the file specified as an command line argument, like:" msgstr "" +"テキストファイルを入力ソースとして使うこともできます。\n" +"このコマンドは以下のように、コマンドライン引数として指定されたファイルの内容を読み込んで利用します：" msgid "" "~~~\n" @@ -156,12 +172,14 @@ msgid "" msgstr "" msgid "### Sending multiple messages at once" -msgstr "" +msgstr "### 複数のメッセージを一度に送る" msgid "" "This command can send multiple messages at once.\n" "To do it, you simply give multiple messages as the input, like:" msgstr "" +"このコマンドは複数のメッセージを一度に送る事もできます。\n" +"複数メッセージの一括送信は、単に、複数のメッセージを入力として与えるだけで行えます：" msgid "" "~~~\n" @@ -201,10 +219,10 @@ msgstr "" msgid "" "All results with responses are printed to the standard output sequentially lik" "e above." -msgstr "" +msgstr "全てのレスポンスに伴う処理結果は、順番に標準出力に出力されます。" msgid "Of course, you can include multiple messages to the source file like:" -msgstr "" +msgstr "もちろん、以下のようにしてソースファイル内に複数のメッセージを含めることもできます：" msgid "" "~~~\n" @@ -279,6 +297,9 @@ msgid "" ": Time to terminate unresponsive connections, in seconds.\n" " `1` by default." msgstr "" +"`--timeout=SECONDS`\n" +": 応答がない接続を打ち切るまでの待ち時間（単位：秒）です。\n" +" 既定値は`1`です。" msgid "" "`--[no-]exit-on-response`\n" @@ -289,6 +310,12 @@ msgid "" "e option `--no-exit-on-response`.\n" " Then the connection is kept until disconnected from the Droonga Engine node." msgstr "" +"`--[no-]exit-on-response`\n" +": レスポンスを1つ受け取った時点で終了するかどうか。\n" +" 既定の状態は、`--exit-on-response`が指定されている場合に等しいです。\n" +" サブスクリプション型のコマンド（1つのリクエストに対して、遅れて複数のレスポンスが返ってくる）に対しては、しばらくの間接続を維持し続けるために`--no" +"-exit-on-response`オプションを指定する必要があります。\n" +" そうすると、Droonga Engineノード側から切断されるまでは接続を維持するようになります。" msgid "" "`--receiver-host=NAME`\n" @@ -306,6 +333,10 @@ msgid "" " To report actually sent messages, you have to specify the option `--report-r" "equest` manually." msgstr "" +"`--[no-]report-request`\n" +": 実際に送信されたリクエストのメッセージを報告するかどうか。\n" +" 既定の状態は、`--no-report-request`が指定されている場合に等しいです。\n" +" 実際に送られたメッセージを見るためには、`--report-request`オプションを手動で指定する必要があります。" msgid "" "`--[no-]report-elapsed-time`\n" @@ -314,18 +345,29 @@ msgid "" " To remove the `Elapsed time:` line from the output, you have to specify the " "option `--no-report-elapsed-time` manually." msgstr "" +"`--[no-]report-elapsed-time`\n" +": リクエストに対してレスポンスが得られるまでにかかった時間を報告するかどうか。\n" +" 既定の状態は、`--report-elapsed-time`が指定されている場合に等しいです。\n" +" 出力から`Elapsed time:`の行を消したい場合は、`--no-report-elapsed-time`オプションを手動で指定する必要があります" +"。" msgid "" "`--default-dataset=NAME`\n" ": Default dataset name for sending messages.\n" " `Default` by default." msgstr "" +"`--default-dataset=NAME`\n" +": メッセージの既定の送信先データセット名。\n" +" 既定値は`Default`です。" msgid "" "`--default-target-role=ROLE`\n" ": Default role of engine nodes which should process messages.\n" " Possible values:" msgstr "" +"`--default-target-role=ROLE`\n" +": メッセージを処理できるEngineノードの既定のロール。\n" +" 以下のいずれかを指定します:" msgid "" " * `service-provider`:\n" @@ -366,6 +408,10 @@ msgid "" " To send broken message (missing any required field) intentionally, you have " "to specify the option `--no-completion` manually." msgstr "" +"`--[no-]validation`\n" +": 入力メッセージの妥当性を検証するかどうか。\n" +" 既定の状態は、`--validation`が指定されている場合に等しいです。\n" +" 妥当でない内容のメッセージを意図的に送りたい場合は、`--no-validation`オプションを手動で指定する必要があります。" msgid "" "`--[no-]validation`\n" @@ -374,11 +420,17 @@ msgid "" " To send invalid message intentionally, you have to specify the option `--no-" "validation` manually." msgstr "" +"`--[no-]validation`\n" +": 入力メッセージの妥当性を検証するかどうか。\n" +" 既定の状態は、`--validation`が指定されている場合に等しいです。\n" +" 妥当でない内容のメッセージを意図的に送りたい場合は、`--no-validation`オプションを手動で指定する必要があります。" msgid "" "`--help`\n" ": Shows the usage of the command." msgstr "" +"`--help`\n" +": コマンドの使い方の説明を表示します。" msgid "## How to install {#install}" msgstr "## インストール方法 {#install}" Modified: _po/ja/reference/1.1.1/command-line-tools/droonga-request/index.po (+81 -13) =================================================================== --- _po/ja/reference/1.1.1/command-line-tools/droonga-request/index.po 2015-05-07 17:46:35 +0900 (41fdfcc) +++ _po/ja/reference/1.1.1/command-line-tools/droonga-request/index.po 2015-05-07 17:46:47 +0900 (95030e9) @@ -14,6 +14,10 @@ msgid "" "layout: en\n" "---" msgstr "" +"---\n" +"title: droonga-request\n" +"layout: ja\n" +"---" msgid "" "* TOC\n" @@ -26,25 +30,30 @@ msgstr "## 概要 {#abstract}" msgid "" "`droonga-request` sends any message to a Droonga cluster, and reports the resp" "onse." -msgstr "" +msgstr "`droonga-request`は、任意のメッセージをDroongaクラスタに送り、レスポンスとして得られた結果を出力します。" msgid "" "This command supports both Droonga native protocol and HTTP.\n" "For Droonga Engine nodes you can send a Droonga native message directly.\n" "And, for HTTP protocol adapter nodes you can send HTTP requests also." msgstr "" +"このコマンドはDroongaネイティブプロトコルとHTTPの両方に対応しています。\n" +"Droonga Engineノードに対しては、Droongaネイティブのメッセージを直接送れます。\n" msgid "## Usage {#usage}" msgstr "## 使い方 {#usage}" msgid "### Basic usage" -msgstr "" +msgstr "### 基本的な使い方" msgid "" "For example, if there is a Droonga Engine node `192.168.100.50` and you are lo" "gged in to a computer `192.168.100.10` in the same network segment, the comman" "d line to send a [`system.status`](../../commands/system/status/) command is:" msgstr "" +"例えば、`192.168.100.50`というDroonga Engineノードがあり、同一ネットワークセグメント内のコンピュータ`192.168.100." +"10`にログインしている場合、[`system.status`](../../commands/system/status/)コマンドのメッセージを送信する" +"コマンド列は以下のようになります：" msgid "" "~~~\n" @@ -75,6 +84,8 @@ msgid "" "The first line is the elapsed time to get the response.\n" "Following lines are the response message." msgstr "" +"1行目はレスポンスを得るまでにかかった時間です。\n" +"後の行はレスポンスメッセージとして得られた内容です。" msgid "" "As described at the [message format reference](../../message/), `id`, `date`, " @@ -84,6 +95,10 @@ msgid "" "You can see the completed message actually sent with the option `--report-requ" "est`, like:" msgstr "" +"[メッセージの形式のリファレンス](../../message/)の説明にある通り、`id`、`date`、`dataset`の各フィールドはリクエストメッ" +"セージの必須フィールドです。\n" +"与えられたメッセージがそれらを持っていなかった場合、このコマンドは初期状態で、適切な値を推測または生成して補います。\n" +"実際に送信された補完後のメッセージを見るには、`--report-request`オプションを指定して下さい：" msgid "" "~~~\n" @@ -105,10 +120,10 @@ msgstr "" msgid "" "For the complete list of available commands, see also [the command reference](" "../../commands/)." -msgstr "" +msgstr "利用可能な全てのコマンドの一覧については、[コマンドリファレンス](../../commands/)を併せて参照して下さい。" msgid "### Combination with other commands" -msgstr "" +msgstr "### 他のコマンドとの連携" msgid "" "This command accepts messages to be sent via standard input.\n" @@ -117,6 +132,9 @@ msgid "" "For example, you'll be able to use [`drndump`](../drndump/)'s output as the so" "urce:" msgstr "" +"このメッセージは標準入力を通じて送信するメッセージを受け取れます。\n" +"上記の例のように、`echo`、`cat`、およびその他のコマンドをこのコマンドのための入力ソースとして利用できます。\n" +"例えば、[`drndump`](../drndump/)の出力もそのまま入力ソースとして利用できます：" msgid "" "~~~\n" @@ -128,12 +146,14 @@ msgid "" msgstr "" msgid "### Input from file" -msgstr "" +msgstr "### ファイルからの入力" msgid "" "You can use a text file as the source.\n" "This command reads the file specified as an command line argument, like:" msgstr "" +"テキストファイルを入力ソースとして使うこともできます。\n" +"このコマンドは以下のように、コマンドライン引数として指定されたファイルの内容を読み込んで利用します：" msgid "" "~~~\n" @@ -163,12 +183,14 @@ msgid "" msgstr "" msgid "### Sending multiple messages at once" -msgstr "" +msgstr "### 複数のメッセージを一度に送る" msgid "" "This command can send multiple messages at once.\n" "To do it, you simply give multiple messages as the input, like:" msgstr "" +"このコマンドは複数のメッセージを一度に送る事もできます。\n" +"複数メッセージの一括送信は、単に、複数のメッセージを入力として与えるだけで行えます：" msgid "" "~~~\n" @@ -208,10 +230,10 @@ msgstr "" msgid "" "All results with responses are printed to the standard output sequentially lik" "e above." -msgstr "" +msgstr "全てのレスポンスに伴う処理結果は、順番に標準出力に出力されます。" msgid "Of course, you can include multiple messages to the source file like:" -msgstr "" +msgstr "もちろん、以下のようにしてソースファイル内に複数のメッセージを含めることもできます：" msgid "" "~~~\n" @@ -252,13 +274,12 @@ msgid "" msgstr "" msgid "### Communication with the Droonga cluster in HTTP" -msgstr "" +msgstr "### DroongaクラスタとHTTPで通信する" msgid "" "This command can communicate not only with Droonga Engine nodes but with HTTP " -"protocol adapters.\n" -"You just have to give the option `--protocol=http`, like:" -msgstr "" +"protocol adapters, like:" +msgstr "このコマンドはDroonga Engineとの接続だけでなく、以下のようにしてHTTPプロトコルアダプターとも通信できます：" msgid "" "~~~\n" @@ -284,7 +305,7 @@ msgid "" msgstr "" msgid "For HTTP protocol adapters, there are some differences:" -msgstr "" +msgstr "HTTPプロトコルアダプタに接続する場合は、使い方が若干変わります：" msgid "" " * You have to give a new option `--protocol http` (`--protocol=http`).\n" @@ -294,17 +315,26 @@ msgid "" "ers ordinarily listen with the port `10041`.)\n" " * The option `--receiver-host` is never been used." msgstr "" +" * `--protocol http` (`--protocol=http`)オプションを指定する必要があります。\n" +" * `--port`オプションを使って、HTTPプロトコルアダプター用に正しいポート番号を指定する必要があります。\n" +" (このオプションの値は既定の状態ではDroonga Engineノード用に`10031`になっていますが、通常、HTTPプロトコルアダプターは`100" +"41`番ポートを使います。)\n" +" * `--receiver-host`オプションは使用しません。" msgid "" "In this case you can use HTTP specific request message as the input.\n" "Regular Droonga native protocol messages are automatically converted to HTTP r" "equest messages like above." msgstr "" +"この利用形態においては、HTTP用のリクエストメッセージを入力として与えることができます。\n" +"通常のDroongaネイティブプロトコルのメッセージは、上記の例のように自動的にHTTP用のリクエストメッセージに変換されます。" msgid "" "You can use such custom HTTP request messages as the input.\n" "This is an example to send HTTP POST request with a custom user agent string:" msgstr "" +"同様の体裁で、独自のHTTPリクエストメッセージを入力として与えることもできます。\n" +"以下は、POSTメソッドで、独自のユーザーエージェント文字列を伴ったPOSTメソッドのHTTPリクエストを送信する例です：" msgid "" "~~~\n" @@ -364,17 +394,24 @@ msgid "" ": Protocol to communicate with the endpoint of the Droonga cluster.\n" " Possible values:" msgstr "" +": Droongaクラスタとの通信に使うプロトコル。\n" +" 取り得る値は以下の通りです：" msgid "" " * `droonga` (default): the native protocol of Droonga Engine nodes.\n" " * `http`: for HTTP protocol adapters." msgstr "" +" * `droonga` (既定値): Droonga Engineノードのネイティブプロトコル。\n" +" * `http`: HTTP。" msgid "" "`--timeout=SECONDS`\n" ": Time to terminate unresponsive connections, in seconds.\n" " `1` by default." msgstr "" +"`--timeout=SECONDS`\n" +": 応答がない接続を打ち切るまでの待ち時間（単位：秒）です。\n" +" 既定値は`1`です。" msgid "" "`--[no-]exit-on-response`\n" @@ -385,6 +422,12 @@ msgid "" "e option `--no-exit-on-response`.\n" " Then the connection is kept until disconnected from the Droonga Engine node." msgstr "" +"`--[no-]exit-on-response`\n" +": レスポンスを1つ受け取った時点で終了するかどうか。\n" +" 既定の状態は、`--exit-on-response`が指定されている場合に等しいです。\n" +" サブスクリプション型のコマンド（1つのリクエストに対して、遅れて複数のレスポンスが返ってくる）に対しては、しばらくの間接続を維持し続けるために`--no" +"-exit-on-response`オプションを指定する必要があります。\n" +" そうすると、Droonga Engineノード側から切断されるまでは接続を維持するようになります。" msgid "" "`--receiver-host=NAME`\n" @@ -402,6 +445,10 @@ msgid "" " To report actually sent messages, you have to specify the option `--report-r" "equest` manually." msgstr "" +"`--[no-]report-request`\n" +": 実際に送信されたリクエストのメッセージを報告するかどうか。\n" +" 既定の状態は、`--no-report-request`が指定されている場合に等しいです。\n" +" 実際に送られたメッセージを見るためには、`--report-request`オプションを手動で指定する必要があります。" msgid "" "`--[no-]report-elapsed-time`\n" @@ -410,18 +457,29 @@ msgid "" " To remove the `Elapsed time:` line from the output, you have to specify the " "option `--no-report-elapsed-time` manually." msgstr "" +"`--[no-]report-elapsed-time`\n" +": リクエストに対してレスポンスが得られるまでにかかった時間を報告するかどうか。\n" +" 既定の状態は、`--report-elapsed-time`が指定されている場合に等しいです。\n" +" 出力から`Elapsed time:`の行を消したい場合は、`--no-report-elapsed-time`オプションを手動で指定する必要があります" +"。" msgid "" "`--default-dataset=NAME`\n" ": Default dataset name for sending messages.\n" " `Default` by default." msgstr "" +"`--default-dataset=NAME`\n" +": メッセージの既定の送信先データセット名。\n" +" 既定値は`Default`です。" msgid "" "`--default-target-role=ROLE`\n" ": Default role of engine nodes which should process messages.\n" " Possible values:" msgstr "" +"`--default-target-role=ROLE`\n" +": メッセージを処理できるEngineノードの既定のロール。\n" +" 以下のいずれかを指定します:" msgid "" " * `service-provider`:\n" @@ -462,6 +520,10 @@ msgid "" " To send broken message (missing any required field) intentionally, you have " "to specify the option `--no-completion` manually." msgstr "" +"`--[no-]completion`\n" +": 入力メッセージの必須フィールドを補完するかどうか。\n" +" 既定の状態は、`--completion`が指定されている場合に等しいです。\n" +" （既定のフィールドが欠落した）壊れたメッセージを意図的に送りたい場合は、`--no-completion`オプションを手動で指定する必要があります。" msgid "" "`--[no-]validation`\n" @@ -470,11 +532,17 @@ msgid "" " To send invalid message intentionally, you have to specify the option `--no-" "validation` manually." msgstr "" +"`--[no-]validation`\n" +": 入力メッセージの妥当性を検証するかどうか。\n" +" 既定の状態は、`--validation`が指定されている場合に等しいです。\n" +" 妥当でない内容のメッセージを意図的に送りたい場合は、`--no-validation`オプションを手動で指定する必要があります。" msgid "" "`--help`\n" ": Shows the usage of the command." msgstr "" +"`--help`\n" +": コマンドの使い方の説明を表示します。" msgid "## How to install {#install}" msgstr "## インストール方法 {#install}" Modified: ja/reference/1.1.0/command-line-tools/droonga-request/index.md (+48 -47) =================================================================== --- ja/reference/1.1.0/command-line-tools/droonga-request/index.md 2015-05-07 17:46:35 +0900 (a88d0b5) +++ ja/reference/1.1.0/command-line-tools/droonga-request/index.md 2015-05-07 17:46:47 +0900 (40b0782) @@ -1,6 +1,6 @@ --- title: droonga-request -layout: en +layout: ja --- {% comment %} @@ -17,14 +17,15 @@ layout: en ## 概要 {#abstract} -`droonga-request` sends any message to a Droonga cluster, and reports the response. -For Droonga Engine nodes you can send a Droonga native message directly. +`droonga-request`は、任意のメッセージをDroongaクラスタに送り、レスポンスとして得られた結果を出力します。 +このコマンドはDroonga Engineノードに対してDroongaネイティブのメッセージを直接送れます。 + ## 使い方 {#usage} -### Basic usage +### 基本的な使い方 -For example, if there is a Droonga Engine node `192.168.100.50` and you are logged in to a computer `192.168.100.10` in the same network segment, the command line to send a [`system.status`](../../commands/system/status/) command is: +例えば、`192.168.100.50`というDroonga Engineノードがあり、同一ネットワークセグメント内のコンピュータ`192.168.100.10`にログインしている場合、[`system.status`](../../commands/system/status/)コマンドのメッセージを送信するコマンド列は以下のようになります： ~~~ (on 192.168.100.10) @@ -49,12 +50,12 @@ Elapsed time: 0.00900742 } ~~~ -The first line is the elapsed time to get the response. -Following lines are the response message. +1行目はレスポンスを得るまでにかかった時間です。 +後の行はレスポンスメッセージとして得られた内容です。 -As described at the [message format reference](../../message/), `id`, `date`, and `dataset` are required fields of request messages. -If the given message doesn't have them, this command guesses or generates applicable values automatically by default. -You can see the completed message actually sent with the option `--report-request`, like: +[メッセージの形式のリファレンス](../../message/)の説明にある通り、`id`、`date`、`dataset`の各フィールドはリクエストメッセージの必須フィールドです。 +与えられたメッセージがそれらを持っていなかった場合、このコマンドは初期状態で、適切な値を推測または生成して補います。 +実際に送信された補完後のメッセージを見るには、`--report-request`オプションを指定して下さい： ~~~ (on 192.168.100.10) @@ -68,13 +69,13 @@ Elapsed time: 0.00900742 ... ~~~ -For the complete list of available commands, see also [the command reference](../../commands/). +利用可能な全てのコマンドの一覧については、[コマンドリファレンス](../../commands/)を併せて参照して下さい。 -### Combination with other commands +### 他のコマンドとの連携 -This command accepts messages to be sent via standard input. -As above, `echo`, `cat`, or any other command can be the source for this command. -For example, you'll be able to use [`drndump`](../drndump/)'s output as the source: +このメッセージは標準入力を通じて送信するメッセージを受け取れます。 +上記の例のように、`echo`、`cat`、およびその他のコマンドをこのコマンドのための入力ソースとして利用できます。 +例えば、[`drndump`](../drndump/)の出力もそのまま入力ソースとして利用できます： ~~~ (on 192.168.100.10) @@ -83,10 +84,10 @@ $ drndump --host 192.168.100.50 --receiver-host 192.168.100.10 | \ > /dev/null ~~~ -### Input from file +### ファイルからの入力 -You can use a text file as the source. -This command reads the file specified as an command line argument, like: +テキストファイルを入力ソースとして使うこともできます。 +このコマンドは以下のように、コマンドライン引数として指定されたファイルの内容を読み込んで利用します： ~~~ (on 192.168.100.10) @@ -112,10 +113,10 @@ Elapsed time: 0.00900742 } ~~~ -### Sending multiple messages at once +### 複数のメッセージを一度に送る -This command can send multiple messages at once. -To do it, you simply give multiple messages as the input, like: +このコマンドは複数のメッセージを一度に送る事もできます。 +複数メッセージの一括送信は、単に、複数のメッセージを入力として与えるだけで行えます： ~~~ (on 192.168.100.10) @@ -149,9 +150,9 @@ Elapsed time: 0.014172429 } ~~~ -All results with responses are printed to the standard output sequentially like above. +全てのレスポンスに伴う処理結果は、順番に標準出力に出力されます。 -Of course, you can include multiple messages to the source file like: +もちろん、以下のようにしてソースファイル内に複数のメッセージを含めることもできます： ~~~ (on 192.168.100.10) @@ -206,36 +207,36 @@ Elapsed time: 0.014172429 既定値は`droonga`です。 `--timeout=SECONDS` -: Time to terminate unresponsive connections, in seconds. - `1` by default. +: 応答がない接続を打ち切るまでの待ち時間（単位：秒）です。 + 既定値は`1`です。 `--[no-]exit-on-response` -: Exits when just one response is received or don't. - `--exit-on-response` is given by default. - For any subscription type command (it returns multiple response messages for a request message with delay), you have to keep connected for a while with the option `--no-exit-on-response`. - Then the connection is kept until disconnected from the Droonga Engine node. +: レスポンスを1つ受け取った時点で終了するかどうか。 + 既定の状態は、`--exit-on-response`が指定されている場合に等しいです。 + サブスクリプション型のコマンド（1つのリクエストに対して、遅れて複数のレスポンスが返ってくる）に対しては、しばらくの間接続を維持し続けるために`--no-exit-on-response`オプションを指定する必要があります。 + そうすると、Droonga Engineノード側から切断されるまでは接続を維持するようになります。 `--receiver-host=NAME` : このコマンドを実行しているコンピュータのホスト名。 既定値は、そのコンピュータのホスト名として推測される名前です。 `--[no-]report-request` -: Reports request messages actually sent or don't. - `--no-report-request` is given by default. - To report actually sent messages, you have to specify the option `--report-request` manually. +: 実際に送信されたリクエストのメッセージを報告するかどうか。 + 既定の状態は、`--no-report-request`が指定されている場合に等しいです。 + 実際に送られたメッセージを見るためには、`--report-request`オプションを手動で指定する必要があります。 `--[no-]report-elapsed-time` -: Reports elapsed time between a request and a response or don't. - `--report-elapsed-time` is given by default. - To remove the `Elapsed time:` line from the output, you have to specify the option `--no-report-elapsed-time` manually. +: リクエストに対してレスポンスが得られるまでにかかった時間を報告するかどうか。 + 既定の状態は、`--report-elapsed-time`が指定されている場合に等しいです。 + 出力から`Elapsed time:`の行を消したい場合は、`--no-report-elapsed-time`オプションを手動で指定する必要があります。 `--default-dataset=NAME` -: Default dataset name for sending messages. - `Default` by default. +: メッセージの既定の送信先データセット名。 + 既定値は`Default`です。 `--default-target-role=ROLE` -: Default role of engine nodes which should process messages. - Possible values: +: メッセージを処理できるEngineノードの既定のロール。 + 以下のいずれかを指定します: * `service-provider`: メッセージは、クラスタ内でサービスを提供中のノードで処理されます。 @@ -251,18 +252,18 @@ Elapsed time: 0.014172429 既定値は`any`です。 -`--[no-]completion` -: Do completion of required fields for input messages or not. - `--completion` is given by default. - To send broken message (missing any required field) intentionally, you have to specify the option `--no-completion` manually. +`--[no-]validation` +: 入力メッセージの妥当性を検証するかどうか。 + 既定の状態は、`--validation`が指定されている場合に等しいです。 + 妥当でない内容のメッセージを意図的に送りたい場合は、`--no-validation`オプションを手動で指定する必要があります。 `--[no-]validation` -: Do validation for input messages or not. - `--validation` is given by default. - To send invalid message intentionally, you have to specify the option `--no-validation` manually. +: 入力メッセージの妥当性を検証するかどうか。 + 既定の状態は、`--validation`が指定されている場合に等しいです。 + 妥当でない内容のメッセージを意図的に送りたい場合は、`--no-validation`オプションを手動で指定する必要があります。 `--help` -: Shows the usage of the command. +: コマンドの使い方の説明を表示します。 Modified: ja/reference/1.1.1/command-line-tools/droonga-request/index.md (+64 -66) =================================================================== --- ja/reference/1.1.1/command-line-tools/droonga-request/index.md 2015-05-07 17:46:35 +0900 (63cec6a) +++ ja/reference/1.1.1/command-line-tools/droonga-request/index.md 2015-05-07 17:46:47 +0900 (7e43157) @@ -1,6 +1,6 @@ --- title: droonga-request -layout: en +layout: ja --- {% comment %} @@ -17,17 +17,17 @@ layout: en ## 概要 {#abstract} -`droonga-request` sends any message to a Droonga cluster, and reports the response. +`droonga-request`は、任意のメッセージをDroongaクラスタに送り、レスポンスとして得られた結果を出力します。 + +このコマンドはDroongaネイティブプロトコルとHTTPの両方に対応しています。 +Droonga Engineノードに対しては、Droongaネイティブのメッセージを直接送れます。 -This command supports both Droonga native protocol and HTTP. -For Droonga Engine nodes you can send a Droonga native message directly. -And, for HTTP protocol adapter nodes you can send HTTP requests also. ## 使い方 {#usage} -### Basic usage +### 基本的な使い方 -For example, if there is a Droonga Engine node `192.168.100.50` and you are logged in to a computer `192.168.100.10` in the same network segment, the command line to send a [`system.status`](../../commands/system/status/) command is: +例えば、`192.168.100.50`というDroonga Engineノードがあり、同一ネットワークセグメント内のコンピュータ`192.168.100.10`にログインしている場合、[`system.status`](../../commands/system/status/)コマンドのメッセージを送信するコマンド列は以下のようになります： ~~~ (on 192.168.100.10) @@ -52,12 +52,12 @@ Elapsed time: 0.00900742 } ~~~ -The first line is the elapsed time to get the response. -Following lines are the response message. +1行目はレスポンスを得るまでにかかった時間です。 +後の行はレスポンスメッセージとして得られた内容です。 -As described at the [message format reference](../../message/), `id`, `date`, and `dataset` are required fields of request messages. -If the given message doesn't have them, this command guesses or generates applicable values automatically by default. -You can see the completed message actually sent with the option `--report-request`, like: +[メッセージの形式のリファレンス](../../message/)の説明にある通り、`id`、`date`、`dataset`の各フィールドはリクエストメッセージの必須フィールドです。 +与えられたメッセージがそれらを持っていなかった場合、このコマンドは初期状態で、適切な値を推測または生成して補います。 +実際に送信された補完後のメッセージを見るには、`--report-request`オプションを指定して下さい： ~~~ (on 192.168.100.10) @@ -73,13 +73,13 @@ Elapsed time: 0.00900742 ... ~~~ -For the complete list of available commands, see also [the command reference](../../commands/). +利用可能な全てのコマンドの一覧については、[コマンドリファレンス](../../commands/)を併せて参照して下さい。 -### Combination with other commands +### 他のコマンドとの連携 -This command accepts messages to be sent via standard input. -As above, `echo`, `cat`, or any other command can be the source for this command. -For example, you'll be able to use [`drndump`](../drndump/)'s output as the source: +このメッセージは標準入力を通じて送信するメッセージを受け取れます。 +上記の例のように、`echo`、`cat`、およびその他のコマンドをこのコマンドのための入力ソースとして利用できます。 +例えば、[`drndump`](../drndump/)の出力もそのまま入力ソースとして利用できます： ~~~ (on 192.168.100.10) @@ -88,10 +88,10 @@ $ drndump --host 192.168.100.50 --receiver-host 192.168.100.10 | \ > /dev/null ~~~ -### Input from file +### ファイルからの入力 -You can use a text file as the source. -This command reads the file specified as an command line argument, like: +テキストファイルを入力ソースとして使うこともできます。 +このコマンドは以下のように、コマンドライン引数として指定されたファイルの内容を読み込んで利用します： ~~~ (on 192.168.100.10) @@ -117,10 +117,10 @@ Elapsed time: 0.00900742 } ~~~ -### Sending multiple messages at once +### 複数のメッセージを一度に送る -This command can send multiple messages at once. -To do it, you simply give multiple messages as the input, like: +このコマンドは複数のメッセージを一度に送る事もできます。 +複数メッセージの一括送信は、単に、複数のメッセージを入力として与えるだけで行えます： ~~~ (on 192.168.100.10) @@ -154,9 +154,9 @@ Elapsed time: 0.014172429 } ~~~ -All results with responses are printed to the standard output sequentially like above. +全てのレスポンスに伴う処理結果は、順番に標準出力に出力されます。 -Of course, you can include multiple messages to the source file like: +もちろん、以下のようにしてソースファイル内に複数のメッセージを含めることもできます： ~~~ (on 192.168.100.10) @@ -194,10 +194,9 @@ Elapsed time: 0.014172429 ~~~ -### Communication with the Droonga cluster in HTTP +### DroongaクラスタとHTTPで通信する -This command can communicate not only with Droonga Engine nodes but with HTTP protocol adapters. -You just have to give the option `--protocol=http`, like: +このコマンドはDroonga Engineとの接続だけでなく、以下のようにしてHTTPプロトコルアダプターとも通信できます： ~~~ (on 192.168.100.10) @@ -218,18 +217,18 @@ Elapsed time: 0.026170325 } ~~~ -For HTTP protocol adapters, there are some differences: +HTTPプロトコルアダプタに接続する場合は、使い方が若干変わります： - * You have to give a new option `--protocol http` (`--protocol=http`). - * You have to specify correct port number of the HTTP protocol adapter via the `--port` option. - (It is `10031` by default for Droonga Engine nodes, but HTTP protocol adapters ordinarily listen with the port `10041`.) - * The option `--receiver-host` is never been used. + * `--protocol http` (`--protocol=http`)オプションを指定する必要があります。 + * `--port`オプションを使って、HTTPプロトコルアダプター用に正しいポート番号を指定する必要があります。 + (このオプションの値は既定の状態ではDroonga Engineノード用に`10031`になっていますが、通常、HTTPプロトコルアダプターは`10041`番ポートを使います。) + * `--receiver-host`オプションは使用しません。 -In this case you can use HTTP specific request message as the input. -Regular Droonga native protocol messages are automatically converted to HTTP request messages like above. +この利用形態においては、HTTP用のリクエストメッセージを入力として与えることができます。 +通常のDroongaネイティブプロトコルのメッセージは、上記の例のように自動的にHTTP用のリクエストメッセージに変換されます。 -You can use such custom HTTP request messages as the input. -This is an example to send HTTP POST request with a custom user agent string: +同様の体裁で、独自のHTTPリクエストメッセージを入力として与えることもできます。 +以下は、POSTメソッドで、独自のユーザーエージェント文字列を伴ったPOSTメソッドのHTTPリクエストを送信する例です： ~~~ (on 192.168.100.10) @@ -266,44 +265,43 @@ Elapsed time: 0.026170325 : Engineノードとの通信に使うタグ名。 既定値は`droonga`です。 -`--protocol=PROTOCOL` -: Protocol to communicate with the endpoint of the Droonga cluster. - Possible values: +: Droongaクラスタとの通信に使うプロトコル。 + 取り得る値は以下の通りです： - * `droonga` (default): the native protocol of Droonga Engine nodes. - * `http`: for HTTP protocol adapters. + * `droonga` (既定値): Droonga Engineノードのネイティブプロトコル。 + * `http`: HTTP。 `--timeout=SECONDS` -: Time to terminate unresponsive connections, in seconds. - `1` by default. +: 応答がない接続を打ち切るまでの待ち時間（単位：秒）です。 + 既定値は`1`です。 `--[no-]exit-on-response` -: Exits when just one response is received or don't. - `--exit-on-response` is given by default. - For any subscription type command (it returns multiple response messages for a request message with delay), you have to keep connected for a while with the option `--no-exit-on-response`. - Then the connection is kept until disconnected from the Droonga Engine node. +: レスポンスを1つ受け取った時点で終了するかどうか。 + 既定の状態は、`--exit-on-response`が指定されている場合に等しいです。 + サブスクリプション型のコマンド（1つのリクエストに対して、遅れて複数のレスポンスが返ってくる）に対しては、しばらくの間接続を維持し続けるために`--no-exit-on-response`オプションを指定する必要があります。 + そうすると、Droonga Engineノード側から切断されるまでは接続を維持するようになります。 `--receiver-host=NAME` : このコマンドを実行しているコンピュータのホスト名。 既定値は、そのコンピュータのホスト名として推測される名前です。 `--[no-]report-request` -: Reports request messages actually sent or don't. - `--no-report-request` is given by default. - To report actually sent messages, you have to specify the option `--report-request` manually. +: 実際に送信されたリクエストのメッセージを報告するかどうか。 + 既定の状態は、`--no-report-request`が指定されている場合に等しいです。 + 実際に送られたメッセージを見るためには、`--report-request`オプションを手動で指定する必要があります。 `--[no-]report-elapsed-time` -: Reports elapsed time between a request and a response or don't. - `--report-elapsed-time` is given by default. - To remove the `Elapsed time:` line from the output, you have to specify the option `--no-report-elapsed-time` manually. +: リクエストに対してレスポンスが得られるまでにかかった時間を報告するかどうか。 + 既定の状態は、`--report-elapsed-time`が指定されている場合に等しいです。 + 出力から`Elapsed time:`の行を消したい場合は、`--no-report-elapsed-time`オプションを手動で指定する必要があります。 `--default-dataset=NAME` -: Default dataset name for sending messages. - `Default` by default. +: メッセージの既定の送信先データセット名。 + 既定値は`Default`です。 `--default-target-role=ROLE` -: Default role of engine nodes which should process messages. - Possible values: +: メッセージを処理できるEngineノードの既定のロール。 + 以下のいずれかを指定します: * `service-provider`: メッセージは、クラスタ内でサービスを提供中のノードで処理されます。 @@ -319,18 +317,18 @@ Elapsed time: 0.026170325 既定値は`any`です。 -`--[no-]completion` -: Do completion of required fields for input messages or not. - `--completion` is given by default. - To send broken message (missing any required field) intentionally, you have to specify the option `--no-completion` manually. +`--[no-]validation` +: 入力メッセージの妥当性を検証するかどうか。 + 既定の状態は、`--validation`が指定されている場合に等しいです。 + 妥当でない内容のメッセージを意図的に送りたい場合は、`--no-validation`オプションを手動で指定する必要があります。 `--[no-]validation` -: Do validation for input messages or not. - `--validation` is given by default. - To send invalid message intentionally, you have to specify the option `--no-validation` manually. +: 入力メッセージの妥当性を検証するかどうか。 + 既定の状態は、`--validation`が指定されている場合に等しいです。 + 妥当でない内容のメッセージを意図的に送りたい場合は、`--no-validation`オプションを手動で指定する必要があります。 `--help` -: Shows the usage of the command. +: コマンドの使い方の説明を表示します。 -------------- next part -------------- HTML����������������������������...Download