YUKI Hiroshi
null+****@clear*****
Fri Dec 27 17:47:12 JST 2013
YUKI Hiroshi 2013-12-27 17:47:12 +0900 (Fri, 27 Dec 2013) New Revision: 5f31c69cce056131ebed3d3b60015bdf763d03bf https://github.com/droonga/droonga.org/commit/5f31c69cce056131ebed3d3b60015bdf763d03bf Message: Translate command reference of search command partially Modified files: _po/ja/reference/commands/search/index.po Modified: _po/ja/reference/commands/search/index.po (+498 -330) =================================================================== --- _po/ja/reference/commands/search/index.po 2013-12-27 18:08:04 +0900 (debde54) +++ _po/ja/reference/commands/search/index.po 2013-12-27 17:47:12 +0900 (d482adb) @@ -8,7 +8,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2011-11-20 22:17+0900\n" -"PO-Revision-Date: 2013-12-19 14:53+0900\n" +"PO-Revision-Date: 2013-12-25 18:27+0900\n" "Last-Translator: Kouhei Sutou <kou �� clear-code.com>\n" "Language-Team: Japanese\n" "Language: ja\n" @@ -23,6 +23,10 @@ msgid "" "layout: documents\n" "---" msgstr "" +"---\n" +"title: search\n" +"layout: documents_ja\n" +"---" msgid "" "* TOC\n" @@ -30,12 +34,12 @@ msgid "" msgstr "" msgid "## Abstract {#abstract}" -msgstr "" +msgstr "## 概要 {#abstract}" msgid "" "The `search` command finds records from the specified table based on given con" "ditions, and returns found records and/or related information." -msgstr "" +msgstr "`search` は、1つ以上のテーブルから指定された条件にマッチするレコードを検索し、見つかったレコードに関する情報を返却します。" msgid "" "This is designed as the most basic (low layer) command on Droonga, to search i" @@ -43,14 +47,39 @@ msgid "" "h\" feature, you should develop it as just a wrapper of this command, instead o" "f developing something based on more low level technologies." msgstr "" +"これは、Droonga において検索機能を提供する最も低レベルのコマンドです。\n" +"検索用のコマンドをプラグインとして実装する際は、内部的にこのコマンドを使用して検索を行うという用途が想定されます。" + +msgid "" +"Style\n" +": Request-Response. One response message is always returned per one request." +msgstr "" +"形式\n" +": Request-Response型。コマンドに対しては必ず対応するレスポンスが返されます。" msgid "" -"This is a request-response style command. One response message is always retur" -"ned per one request." +"`type` of the request\n" +": `search`" msgstr "" +"リクエストの `type`\n" +": `search`" -msgid "## Syntax {#syntax}" +msgid "" +"`body` of the request\n" +": A hash of parameters." msgstr "" +"リクエストの `body`\n" +": パラメータのハッシュ。" + +msgid "" +"`type` of the response\n" +": `search.result`" +msgstr "" +"レスポンスの `type`\n" +": `search.result`" + +msgid "## Parameter syntax {#syntax}" +msgstr "## パラメータの構文 {#syntax}" msgid "" " {\n" @@ -68,17 +97,31 @@ msgid "" " }\n" " }" msgstr "" +" {\n" +" \"timeout\" : <タイムアウトするまでの秒数>,\n" +" \"queries\" : {\n" +" \"<クエリ1の名前>\" : {\n" +" \"source\" : \"<検索対象のテーブル名、または別の検索クエリの名前>\",\n" +" \"condition\" : <検索条件>,\n" +" \"sortBy\" : <ソートの条件>,\n" +" \"groupBy\" : <集約の条件>,\n" +" \"output\" : <出力の指定>\n" +" },\n" +" \"<クエリ2の名前>\" : { ... },\n" +" ...\n" +" }\n" +" }" msgid "## Usage {#usage}" -msgstr "" +msgstr "## 使い方 {#usage}" msgid "" "This section describes how to use this command, via a typical usage with follo" "wing table:" -msgstr "" +msgstr "この項では、以下のテーブルが存在する状態を前提として、典型的な使い方を通じて `search` コマンドの使い方を説明します。" msgid "Person table (with primary key):" -msgstr "" +msgstr "Personテーブル（主キーあり）:" msgid "" "|_key|name|age|sex|job|note|\n" @@ -95,24 +138,26 @@ msgid "" msgstr "" msgid "Note: `name` and `note` are indexed with `TokensBigram`." -msgstr "" +msgstr "※`name`、`note` には `TokensBigram` を使用したインデックスが用意されていると仮定します。" msgid "### Basic usage {#usage-basic}" -msgstr "" +msgstr "### 基本的な使い方 {#usage-basic}" msgid "This is a simple example to output all records of the Person table:" -msgstr "" +msgstr "最も単純な例として、Person テーブルのすべてのレコードを出力する例を示します。" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"people\" : {\n" -" \"source\" : \"Person\",\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"_key\", \"name\", \"age\", \"sex\", \"job\", \"note\"],\n" -" \"limit\" : -1\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"people\" : {\n" +" \"source\" : \"Person\",\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"_key\", \"name\", \"age\", \"sex\", \"job\", \"note\"],\n" +" \"limit\" : -1\n" +" }\n" " }\n" " }\n" " }\n" @@ -120,23 +165,27 @@ msgid "" msgstr "" msgid "" -" => search.result\n" -" {\n" -" \"people\" : {\n" -" \"count\" : 9,\n" -" \"records\" : [\n" -" [\"Alice Arnold\", \"Alice Arnold\", 20, \"female\", \"announcer\", \"\"],\n" -" [\"Alice Cooper\", \"Alice Cooper\", 30, \"male\", \"musician\", \"\"],\n" -" [\"Alice Miller\", \"Alice Miller\", 25, \"male\", \"doctor\", \"\"],\n" -" [\"Bob Dole\", \"Bob Dole\", 42, \"male\", \"lawer\", \"\"],\n" -" [\"Bob Cousy\", \"Bob Cousy\", 38, \"male\", \"basketball player\", \"\"],\n" -" [\"Bob Wolcott\", \"Bob Wolcott\", 36, \"male\", \"baseball player\", \"\"]" +" => {\n" +" \"type\" : \"search.result\",\n" +" \"body\" : {\n" +" \"people\" : {\n" +" \"count\" : 9,\n" +" \"records\" : [\n" +" [\"Alice Arnold\", \"Alice Arnold\", 20, \"female\", \"announcer\", \"\"]" ",\n" -" [\"Bob Evans\", \"Bob Evans\", 31, \"male\", \"driver\", \"\"],\n" -" [\"Bob Ross\", \"Bob Ross\", 54, \"male\", \"painter\", \"\"],\n" -" [\"Lewis Carroll\", \"Lewis Carroll\", 66, \"male\", \"writer\",\n" -" \"the author of Alice's Adventures in Wonderland\"]\n" -" ]\n" +" [\"Alice Cooper\", \"Alice Cooper\", 30, \"male\", \"musician\", \"\"],\n" +" [\"Alice Miller\", \"Alice Miller\", 25, \"male\", \"doctor\", \"\"],\n" +" [\"Bob Dole\", \"Bob Dole\", 42, \"male\", \"lawer\", \"\"],\n" +" [\"Bob Cousy\", \"Bob Cousy\", 38, \"male\", \"basketball player\", \"\"]" +",\n" +" [\"Bob Wolcott\", \"Bob Wolcott\", 36, \"male\", \"baseball player\", \"" +"\"],\n" +" [\"Bob Evans\", \"Bob Evans\", 31, \"male\", \"driver\", \"\"],\n" +" [\"Bob Ross\", \"Bob Ross\", 54, \"male\", \"painter\", \"\"],\n" +" [\"Lewis Carroll\", \"Lewis Carroll\", 66, \"male\", \"writer\",\n" +" \"the author of Alice's Adventures in Wonderland\"]\n" +" ]\n" +" }\n" " }\n" " }" msgstr "" @@ -147,9 +196,12 @@ msgid "" "same to keys of the given `queries`.\n" "So, this means: \"name the search result of the query as `people`\"." msgstr "" +"`people` は、この検索クエリおよびその処理結果に対して付けた一時的な名前です。\n" +"`search` のレスポンスは、検索クエリに付けた名前を伴って返されます。\n" +"よって、これは「この検索クエリの結果を `people` と呼ぶ」というような意味合いになります。" msgid "Why the command above returns all informations of the table? Because:" -msgstr "" +msgstr "どうしてこのコマンドが全レコードのすべての情報を出力するのでしょうか？ これは以下の理由に依ります。" msgid "" " * There is no search condition. This command matches to all records in the sp" @@ -160,39 +212,53 @@ msgid "" "ned as `count`.\n" " * [`output`](#query-output)'s `limit` is `-1`. The parameter `limit` controls" " the number of returned records, and `-1` means \"return all records\".\n" -" * [`output`](#query-output)'s `attributes` contails all columns of the Person" +" * [`output`](#query-output)'s `attributes` contains all columns of the Person" " table. The parameter `attributes` controls which columns' value are returned." msgstr "" +" * 検索条件を何も指定していないため。検索条件を指定しないとすべてのレコードがマッチします。\n" +" * [`output`](#query-output) の `elements` パラメータに `records` （および `count`）が指定されて" +"いるため。 `elements` は結果に出力する情報を制御します。マッチしたレコードの情報は `records` に、マッチしたレコードの総数は `cou" +"nt` に出力されます。\n" +" * [`output`](#query-output) の `limit` パラメータに `-1` が指定されているため。 `limit` は出力するレコ" +"ードの最大数の指定ですが、 `-1` を指定するとすべてのレコードが出力されます。\n" +" * [`output`](#query-output) の `attributes` パラメータに Person テーブルのすべてのカラムの名前が列挙され" +"ているため。 `attributes` は個々のレコードに出力するカラムを制御します。" msgid "#### Search conditions {#usage-condition}" -msgstr "" +msgstr "#### 検索条件 {#usage-condition}" msgid "" "Search conditions are specified via the `condition` parameter. There are two s" -"tyles of search conditions: \"scrypt syntax\" and \"query syntax\". See [`conditio" +"tyles of search conditions: \"script syntax\" and \"query syntax\". See [`conditio" "n` parameter](#query-condition) for more details." msgstr "" +"検索条件は `condition` パラメータで指定します。指定方法は、大きく分けて「スクリプト構文形式」と「クエリー構文形式」の2通りがあります。詳細は " +"[`condition` パラメータの仕様](#query-condition) を参照して下さい。" msgid "##### Search conditions in Script syntax {#usage-condition-script-syntax}" -msgstr "" +msgstr "##### スクリプト構文形式の検索条件 {#usage-condition-script-syntax}" msgid "" "Search conditions in script syntax are similar to ECMAScript. For example, fol" "lowing query means \"find records that `name` contains `Alice` and `age` is lar" "ger than `25`\":" msgstr "" +"スクリプト構文形式は、ECMAScriptの書式に似ています。「`name` に `Alice` を含み、且つ`age` が `25` 以上である」という検" +"索条件は、スクリプト構文形式で以下のように表現できます。" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"people\" : {\n" -" \"source\" : \"Person\",\n" -" \"condition\" : \"name @ 'Alice' && age >= 25\"\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"name\", \"age\"],\n" -" \"limit\" : -1\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"people\" : {\n" +" \"source\" : \"Person\",\n" +" \"condition\" : \"name @ 'Alice' && age >= 25\"\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"name\", \"age\"],\n" +" \"limit\" : -1\n" +" }\n" " }\n" " }\n" " }\n" @@ -200,15 +266,17 @@ msgid "" msgstr "" msgid "" -" => search.result\n" -" {\n" -" \"people\" : {\n" -" \"count\" : 2,\n" -" \"records\" : [\n" -" [\"Alice Arnold\", 20],\n" -" [\"Alice Cooper\", 30],\n" -" [\"Alice Miller\", 25]\n" -" ]\n" +" => {\n" +" \"type\" : \"search.result\",\n" +" \"body\" : {\n" +" \"people\" : {\n" +" \"count\" : 2,\n" +" \"records\" : [\n" +" [\"Alice Arnold\", 20],\n" +" [\"Alice Cooper\", 30],\n" +" [\"Alice Miller\", 25]\n" +" ]\n" +" }\n" " }\n" " }" msgstr "" @@ -217,30 +285,37 @@ msgid "" "[Script syntax is compatible to Groonga's one](http://groonga.org/docs/referen" "ce/grn_expr/script_syntax.html). See the linked document for more details." msgstr "" +"スクリプト構文の詳細な仕様は[Groonga のスクリプト構文のリファレンス](http://groonga.org/ja/docs/reference/g" +"rn_expr/script_syntax.html)を参照して下さい。" msgid "##### Search conditions in Query syntax {#usage-condition-query-syntax}" -msgstr "" +msgstr "##### クエリー構文形式の検索条件 {#usage-condition-query-syntax}" msgid "" "The query syntax is mainly designed for search boxes in webpages. For example," " following query means \"find records that `name` or `note` contain the given w" "ord, and the word is `Alice`\":" msgstr "" +"クエリー構文形式は、主にWebページなどに組み込む検索ボックス向けに用意されています。例えば「検索ボックスに入力された語句を `name` または `not" +"e` に含むレコードを検索する」という場面において、検索ボックスに入力された語句が `Alice` であった場合の検索条件は、クエリー構文形式で以下のように" +"表現できます。" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"people\" : {\n" -" \"source\" : \"Person\",\n" -" \"condition\" : {\n" -" \"query\" : \"Alice\",\n" -" \"matchTo\" : [\"name\", \"note\"]\n" -" },\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"name\", \"note\"],\n" -" \"limit\" : -1\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"people\" : {\n" +" \"source\" : \"Person\",\n" +" \"condition\" : {\n" +" \"query\" : \"Alice\",\n" +" \"matchTo\" : [\"name\", \"note\"]\n" +" },\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"name\", \"note\"],\n" +" \"limit\" : -1\n" +" }\n" " }\n" " }\n" " }\n" @@ -248,17 +323,19 @@ msgid "" msgstr "" msgid "" -" => search.result\n" -" {\n" -" \"people\" : {\n" -" \"count\" : 4,\n" -" \"records\" : [\n" -" [\"Alice Arnold\", \"\"],\n" -" [\"Alice Cooper\", \"\"],\n" -" [\"Alice Miller\", \"\"],\n" -" [\"Lewis Carroll\",\n" -" \"the author of Alice's Adventures in Wonderland\"]\n" -" ]\n" +" => {\n" +" \"type\" : \"search.result\",\n" +" \"body\" : {\n" +" \"people\" : {\n" +" \"count\" : 4,\n" +" \"records\" : [\n" +" [\"Alice Arnold\", \"\"],\n" +" [\"Alice Cooper\", \"\"],\n" +" [\"Alice Miller\", \"\"],\n" +" [\"Lewis Carroll\",\n" +" \"the author of Alice's Adventures in Wonderland\"]\n" +" ]\n" +" }\n" " }\n" " }" msgstr "" @@ -267,28 +344,32 @@ msgid "" "[Query syntax is compatible to Groonga's one](http://groonga.org/docs/referenc" "e/grn_expr/query_syntax.html). See the linked document for more details." msgstr "" +"クエリー構文の詳細な仕様は[Groonga のクエリー構文のリファレンス](http://groonga.org/ja/docs/reference/grn" +"_expr/query_syntax.html)を参照して下さい。" msgid "#### Sorting of search results {#usage-sort}" -msgstr "" +msgstr "#### 検索結果のソート {#usage-sort}" msgid "" "Returned records can be sorted by conditions specified as the `sortBy` paramet" "er. For example, following query means \"sort results by their `age`, in ascend" "ing order\":" -msgstr "" +msgstr "出力するレコードのソート条件は `sortBy` パラメータで指定します。以下は、結果を `age` カラムの値の昇順でソートする場合の例です。" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"people\" : {\n" -" \"source\" : \"Person\",\n" -" \"condition\" : \"name @ 'Alice'\"\n" -" \"sortBy\" : [\"age\"],\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"name\", \"age\"],\n" -" \"limit\" : -1\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"people\" : {\n" +" \"source\" : \"Person\",\n" +" \"condition\" : \"name @ 'Alice'\"\n" +" \"sortBy\" : [\"age\"],\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"name\", \"age\"],\n" +" \"limit\" : -1\n" +" }\n" " }\n" " }\n" " }\n" @@ -296,36 +377,38 @@ msgid "" msgstr "" msgid "" -" => search.result\n" -" {\n" -" \"people\" : {\n" -" \"count\" : 8,\n" -" \"records\" : [\n" -" [\"Alice Arnold\", 20],\n" -" [\"Alice Miller\", 25],\n" -" [\"Alice Cooper\", 30]\n" -" ]\n" +" => {\n" +" \"type\" : \"search.result\",\n" +" \"body\" : {\n" +" \"people\" : {\n" +" \"count\" : 8,\n" +" \"records\" : [\n" +" [\"Alice Arnold\", 20],\n" +" [\"Alice Miller\", 25],\n" +" [\"Alice Cooper\", 30]\n" +" ]\n" +" }\n" " }\n" " }" msgstr "" -msgid "" -"If you add `-` before name of columns, then search results are returned in des" -"cending order. For example:" +msgid "ソートするカラム名の前に `-` を付けると、降順でのソートになります。以下は `age` の降順でソートする場合の例です。" msgstr "" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"people\" : {\n" -" \"source\" : \"Person\",\n" -" \"condition\" : \"name @ 'Alice'\"\n" -" \"sortBy\" : [\"-age\"],\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"name\", \"age\"],\n" -" \"limit\" : -1\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"people\" : {\n" +" \"source\" : \"Person\",\n" +" \"condition\" : \"name @ 'Alice'\"\n" +" \"sortBy\" : [\"-age\"],\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"name\", \"age\"],\n" +" \"limit\" : -1\n" +" }\n" " }\n" " }\n" " }\n" @@ -333,42 +416,48 @@ msgid "" msgstr "" msgid "" -" => search.result\n" -" {\n" -" \"people\" : {\n" -" \"count\" : 8,\n" -" \"records\" : [\n" -" [\"Alice Cooper\", 30],\n" -" [\"Alice Miller\", 25],\n" -" [\"Alice Arnold\", 20]\n" -" ]\n" +" => {\n" +" \"type\" : \"search.result\",\n" +" \"body\" : {\n" +" \"people\" : {\n" +" \"count\" : 8,\n" +" \"records\" : [\n" +" [\"Alice Cooper\", 30],\n" +" [\"Alice Miller\", 25],\n" +" [\"Alice Arnold\", 20]\n" +" ]\n" +" }\n" " }\n" " }" msgstr "" msgid "See [`sortBy` parameter](#query-sortBy) for more details." -msgstr "" +msgstr "詳細は [`sortBy` パラメータの仕様](#query-sortBy) を参照して下さい。" msgid "#### Paging of search results {#usage-paging}" -msgstr "" +msgstr "#### 検索結果のページング {#usage-paging}" msgid "" "Search results can be retuned partially via `offset` and `limit` under the [`o" "utput`](#query-output) parameter. For example, following queries will return 2" "0 or more search results by 10's." msgstr "" +"[`output`](#query-output) パラメータの `offset` と `limit` を指定することで、出力されるレコードの範囲を指定でき" +"ます。以下は、20件以上ある結果を先頭から順に10件ずつ取得する場合の例です。" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"people\" : {\n" -" \"source\" : \"Person\",\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"name\"],\n" -" \"offset\" : 0,\n" -" \"limit\" : 10\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"people\" : {\n" +" \"source\" : \"Person\",\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"name\"],\n" +" \"offset\" : 0,\n" +" \"limit\" : 10\n" +" }\n" " }\n" " }\n" " }\n" @@ -377,16 +466,18 @@ msgid "" msgstr "" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"people\" : {\n" -" \"source\" : \"Person\",\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"name\"],\n" -" \"offset\" : 10,\n" -" \"limit\" : 10\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"people\" : {\n" +" \"source\" : \"Person\",\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"name\"],\n" +" \"offset\" : 10,\n" +" \"limit\" : 10\n" +" }\n" " }\n" " }\n" " }\n" @@ -395,16 +486,18 @@ msgid "" msgstr "" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"people\" : {\n" -" \"source\" : \"Person\",\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"name\"],\n" -" \"offset\" : 20,\n" -" \"limit\" : 10\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"people\" : {\n" +" \"source\" : \"Person\",\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"name\"],\n" +" \"offset\" : 20,\n" +" \"limit\" : 10\n" +" }\n" " }\n" " }\n" " }\n" @@ -439,16 +532,18 @@ msgid "" msgstr "" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"people\" : {\n" -" \"source\" : \"Person\",\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"_key\", \"name\", \"age\", \"sex\", \"job\", \"note\"],\n" -" \"limit\" : 3,\n" -" \"format\" : \"complex\"\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"people\" : {\n" +" \"source\" : \"Person\",\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"_key\", \"name\", \"age\", \"sex\", \"job\", \"note\"],\n" +" \"limit\" : 3,\n" +" \"format\" : \"complex\"\n" +" }\n" " }\n" " }\n" " }\n" @@ -456,30 +551,32 @@ msgid "" msgstr "" msgid "" -" => search.result\n" -" {\n" -" \"people\" : {\n" -" \"count\" : 9,\n" -" \"records\" : [\n" -" { \"_key\" : \"Alice Arnold\",\n" -" \"name\" : \"Alice Arnold\",\n" -" \"age\" : 20,\n" -" \"sex\" : \"female\",\n" -" \"job\" : \"announcer\",\n" -" \"note\" : \"\" },\n" -" { \"_key\" : \"Alice Cooper\",\n" -" \"name\" : \"Alice Cooper\",\n" -" \"age\" : 30,\n" -" \"sex\" : \"male\",\n" -" \"job\" : \"musician\",\n" -" \"note\" : \"\" },\n" -" { \"_key\" : \"Alice Miller\",\n" -" \"name\" : \"Alice Miller\",\n" -" \"age\" : 25,\n" -" \"sex\" : \"female\",\n" -" \"job\" : \"doctor\",\n" -" \"note\" : \"\" }\n" -" ]\n" +" => {\n" +" \"type\" : \"search.result\",\n" +" \"body\" : {\n" +" \"people\" : {\n" +" \"count\" : 9,\n" +" \"records\" : [\n" +" { \"_key\" : \"Alice Arnold\",\n" +" \"name\" : \"Alice Arnold\",\n" +" \"age\" : 20,\n" +" \"sex\" : \"female\",\n" +" \"job\" : \"announcer\",\n" +" \"note\" : \"\" },\n" +" { \"_key\" : \"Alice Cooper\",\n" +" \"name\" : \"Alice Cooper\",\n" +" \"age\" : 30,\n" +" \"sex\" : \"male\",\n" +" \"job\" : \"musician\",\n" +" \"note\" : \"\" },\n" +" { \"_key\" : \"Alice Miller\",\n" +" \"name\" : \"Alice Miller\",\n" +" \"age\" : 25,\n" +" \"sex\" : \"female\",\n" +" \"job\" : \"doctor\",\n" +" \"note\" : \"\" }\n" +" ]\n" +" }\n" " }\n" " }" msgstr "" @@ -509,16 +606,18 @@ msgid "" msgstr "" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"sexuality\" : {\n" -" \"source\" : \"Person\",\n" -" \"groupBy\" : \"sex\",\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"_key\", \"_nsubrecs\"],\n" -" \"limit\" : -1\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"sexuality\" : {\n" +" \"source\" : \"Person\",\n" +" \"groupBy\" : \"sex\",\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"_key\", \"_nsubrecs\"],\n" +" \"limit\" : -1\n" +" }\n" " }\n" " }\n" " }\n" @@ -526,14 +625,16 @@ msgid "" msgstr "" msgid "" -" => search.result\n" -" {\n" -" \"sexuality\" : {\n" -" \"count\" : 2,\n" -" \"records\" : \n" -" [\"female\", 2],\n" -" [\"male\", 7]\n" -" ]\n" +" => {\n" +" \"type\" : \"search.result\",\n" +" \"body\" : {\n" +" \"sexuality\" : {\n" +" \"count\" : 2,\n" +" \"records\" : \n" +" [\"female\", 2],\n" +" [\"male\", 7]\n" +" ]\n" +" }\n" " }\n" " }" msgstr "" @@ -550,25 +651,27 @@ msgid "" msgstr "" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"sexuality\" : {\n" -" \"source\" : \"Person\",\n" -" \"groupBy\" : {\n" -" \"keys\" : \"sex\",\n" -" \"maxNSubRecords\" : 2\n" -" }, \n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\n" -" \"_key\",\n" -" \"_nsubrecs\",\n" -" { \"label\" : \"subrecords\",\n" -" \"source\" : \"_subrecs\",\n" -" \"attributes\" : [\"name\"] }\n" -" ],\n" -" \"limit\" : -1\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"sexuality\" : {\n" +" \"source\" : \"Person\",\n" +" \"groupBy\" : {\n" +" \"keys\" : \"sex\",\n" +" \"maxNSubRecords\" : 2\n" +" }, \n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\n" +" \"_key\",\n" +" \"_nsubrecs\",\n" +" { \"label\" : \"subrecords\",\n" +" \"source\" : \"_subrecs\",\n" +" \"attributes\" : [\"name\"] }\n" +" ],\n" +" \"limit\" : -1\n" +" }\n" " }\n" " }\n" " }\n" @@ -576,14 +679,16 @@ msgid "" msgstr "" msgid "" -" => search.result\n" -" {\n" -" \"sexuality\" : {\n" -" \"count\" : 2,\n" -" \"records\" : \n" -" [\"female\", 2, [[\"Alice Arnold\"], [\"Alice Miller\"]]],\n" -" [\"male\", 7, [[\"Alice Cooper\"], [\"Bob Dole\"]]]\n" -" ]\n" +" => {\n" +" \"type\" : \"search.result\",\n" +" \"body\" : {\n" +" \"sexuality\" : {\n" +" \"count\" : 2,\n" +" \"records\" : \n" +" [\"female\", 2, [[\"Alice Arnold\"], [\"Alice Miller\"]]],\n" +" [\"male\", 7, [[\"Alice Cooper\"], [\"Bob Dole\"]]]\n" +" ]\n" +" }\n" " }\n" " }" msgstr "" @@ -607,25 +712,27 @@ msgid "" msgstr "" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"junior\" : {\n" -" \"source\" : \"Person\",\n" -" \"condition\" : \"age <= 25\",\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"name\", \"age\"],\n" -" \"limit\" : -1\n" -" }\n" -" },\n" -" \"senior\" : {\n" -" \"source\" : \"Person\",\n" -" \"condition\" : \"age >= 40\",\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"name\", \"age\"],\n" -" \"limit\" : -1\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"junior\" : {\n" +" \"source\" : \"Person\",\n" +" \"condition\" : \"age <= 25\",\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"name\", \"age\"],\n" +" \"limit\" : -1\n" +" }\n" +" },\n" +" \"senior\" : {\n" +" \"source\" : \"Person\",\n" +" \"condition\" : \"age >= 40\",\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"name\", \"age\"],\n" +" \"limit\" : -1\n" +" }\n" " }\n" " }\n" " }\n" @@ -633,22 +740,24 @@ msgid "" msgstr "" msgid "" -" => search.result\n" -" {\n" -" \"junior\" : {\n" -" \"count\" : 2,\n" -" \"records\" : [\n" -" [\"Alice Arnold\", 20],\n" -" [\"Alice Miller\", 25]\n" -" ]\n" -" },\n" -" \"senior\" : {\n" -" \"count\" : 3,\n" -" \"records\" : [\n" -" [\"Bob Dole\", 42],\n" -" [\"Bob Ross\", 54],\n" -" [\"Lewis Carroll\", 66]\n" -" ]\n" +" => {\n" +" \"type\" : \"search.result\",\n" +" \"body\" : {\n" +" \"junior\" : {\n" +" \"count\" : 2,\n" +" \"records\" : [\n" +" [\"Alice Arnold\", 20],\n" +" [\"Alice Miller\", 25]\n" +" ]\n" +" },\n" +" \"senior\" : {\n" +" \"count\" : 3,\n" +" \"records\" : [\n" +" [\"Bob Dole\", 42],\n" +" [\"Bob Ross\", 54],\n" +" [\"Lewis Carroll\", 66]\n" +" ]\n" +" }\n" " }\n" " }" msgstr "" @@ -673,25 +782,27 @@ msgid "" msgstr "" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"people\" : {\n" -" \"source\" : \"Person\",\n" -" \"condition\" : \"name @ 'Alice'\"\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"name\", \"age\"],\n" -" \"limit\" : -1\n" -" }\n" -" },\n" -" \"sexuality\" : {\n" -" \"source\" : \"people\",\n" -" \"groupBy\" : \"sex\",\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"_key\", \"_nsubrecs\"],\n" -" \"limit\" : -1\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"people\" : {\n" +" \"source\" : \"Person\",\n" +" \"condition\" : \"name @ 'Alice'\"\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"name\", \"age\"],\n" +" \"limit\" : -1\n" +" }\n" +" },\n" +" \"sexuality\" : {\n" +" \"source\" : \"people\",\n" +" \"groupBy\" : \"sex\",\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"_key\", \"_nsubrecs\"],\n" +" \"limit\" : -1\n" +" }\n" " }\n" " }\n" " }\n" @@ -699,22 +810,24 @@ msgid "" msgstr "" msgid "" -" => search.result\n" -" {\n" -" \"people\" : {\n" -" \"count\" : 8,\n" -" \"records\" : [\n" -" [\"Alice Cooper\", 30],\n" -" [\"Alice Miller\", 25],\n" -" [\"Alice Arnold\", 20]\n" -" ]\n" -" },\n" -" \"sexuality\" : {\n" -" \"count\" : 2,\n" -" \"records\" : \n" -" [\"female\", 2],\n" -" [\"male\", 1]\n" -" ]\n" +" => {\n" +" \"type\" : \"search.result\",\n" +" \"body\" : {\n" +" \"people\" : {\n" +" \"count\" : 8,\n" +" \"records\" : [\n" +" [\"Alice Cooper\", 30],\n" +" [\"Alice Miller\", 25],\n" +" [\"Alice Arnold\", 20]\n" +" ]\n" +" },\n" +" \"sexuality\" : {\n" +" \"count\" : 2,\n" +" \"records\" : \n" +" [\"female\", 2],\n" +" [\"male\", 1]\n" +" ]\n" +" }\n" " }\n" " }" msgstr "" @@ -727,20 +840,22 @@ msgid "" msgstr "" msgid "" -" search\n" " {\n" -" \"queries\" : {\n" -" \"allJob\" : {\n" -" \"source\" : \"Person\",\n" -" \"groupBy\" : \"job\"\n" -" },\n" -" \"playerJob\" : {\n" -" \"source\" : \"allJob\",\n" -" \"condition\" : \"_key @ `player`\",\n" -" \"output\" : {\n" -" \"elements\" : [\"count\", \"records\"],\n" -" \"attributes\" : [\"_key\", \"_nsubrecs\"],\n" -" \"limit\" : -1\n" +" \"type\" : \"search\",\n" +" \"body\" : {\n" +" \"queries\" : {\n" +" \"allJob\" : {\n" +" \"source\" : \"Person\",\n" +" \"groupBy\" : \"job\"\n" +" },\n" +" \"playerJob\" : {\n" +" \"source\" : \"allJob\",\n" +" \"condition\" : \"_key @ `player`\",\n" +" \"output\" : {\n" +" \"elements\" : [\"count\", \"records\"],\n" +" \"attributes\" : [\"_key\", \"_nsubrecs\"],\n" +" \"limit\" : -1\n" +" }\n" " }\n" " }\n" " }\n" @@ -748,20 +863,22 @@ msgid "" msgstr "" msgid "" -" => search.result\n" -" {\n" -" \"playerJob\" : {\n" -" \"count\" : 2,\n" -" \"records\" : [\n" -" [\"basketball player\", 1],\n" -" [\"baseball player\", 1]\n" -" ]\n" +" => {\n" +" \"type\" : \"search.result\",\n" +" \"body\" : {\n" +" \"playerJob\" : {\n" +" \"count\" : 2,\n" +" \"records\" : [\n" +" [\"basketball player\", 1],\n" +" [\"baseball player\", 1]\n" +" ]\n" +" }\n" " }\n" " }" msgstr "" -msgid "## Parameters {#parameters}" -msgstr "" +msgid "## Parameter details {#parameters}" +msgstr "## パラメータの詳細 {#parameters}" msgid "### Container parameters {#container-parameters}" msgstr "" @@ -997,7 +1114,7 @@ msgstr "" msgid "" "`allowColumn`\n" -": A boolean value to allow (`true`) or disallog (`false`) to specify column na" +": A boolean value to allow (`true`) or disallow (`false`) to specify column na" "me for each query in the `query`, like `name:Alice`.\n" " This parameter is optional, the default value is `true`." msgstr "" @@ -1094,8 +1211,8 @@ msgstr "" msgid "" "At first Droonga tries to sort records by the value of the first given sort co" "lumn. After that, if there are multiple records which have same value for the " -"column, then Drooga tries to sort them by the secondary given sort column. The" -"se processes are repeated for all given sort columns." +"column, then Droonga tries to sort them by the secondary given sort column. Th" +"ese processes are repeated for all given sort columns." msgstr "" msgid "You must specify sort columns as an array, even if there is only one column." @@ -1339,7 +1456,7 @@ msgstr "" msgid "" "`format`\n" ": A string meaning the format of exported each record.\n" -" Possible vaules:" +" Possible values:" msgstr "" msgid "" @@ -1458,13 +1575,18 @@ msgid "" "orted if no column is specified." msgstr "" -msgid "## Resposnes {#response}" +msgid "## Responses {#response}" +msgstr "" + +msgid "" +"This command returns a hash as the result as the `body`, with `200` as the `st" +"atusCode`." msgstr "" msgid "" -"This command returns a hash as the result. Keys of the hash is the name of eac" -"h query (a result of a search query), values of the hash is the result of each" -" [search query](#query-parameters), like:" +"Keys of the result hash is the name of each query (a result of a search query)" +", values of the hash is the result of each [search query](#query-parameters), " +"like:" msgstr "" msgid "" @@ -1681,6 +1803,14 @@ msgid "" "ibutes`, values are informations of each column." msgstr "" +msgid "" +"`type`\n" +": A string meaning the value type of the column.\n" +" The type is indicated as one of [Groonga's primitive data formats](http://gr" +"oonga.org/docs/reference/types.html), or a name for an existing table for refe" +"rring columns." +msgstr "" + msgid "##### `records` {#response-query-complex-records}" msgstr "" @@ -1689,3 +1819,41 @@ msgid "" "y [`output` parameter](#query-output)'s `attributes`, values are column values" "." msgstr "" + +msgid "## Error types {#errors}" +msgstr "## エラーの種類 {#errors}" + +msgid "" +"This command reports errors not only [general errors](/reference/message/#erro" +"r) but also followings." +msgstr "このコマンドは[一般的なエラー](/ja/reference/message/#error)に加えて、以下のエラーを場合に応じて返します。" + +msgid "### `MissingSourceParameter`" +msgstr "" + +msgid "" +"Means you've forgotten to specify the `source` parameter. The status code is `" +"400`." +msgstr "" + +msgid "### `UnknownSource`" +msgstr "" + +msgid "" +"Means there is no existing table and no other query with the name, for a `sour" +"ce` of a query. The status code is `404`." +msgstr "" + +msgid "### `CyclicSource`" +msgstr "" + +msgid "Means there is any circular reference of sources. The status code is `400`." +msgstr "" + +msgid "### `SearchTimeout`" +msgstr "" + +msgid "" +"Means the engine couldn't finish to process the request in the time specified " +"as `timeout`. The status code is `500`." +msgstr "" -------------- next part -------------- HTML����������������������������...Télécharger
