Kouhei Sutou
null+****@clear*****
Sat Jun 10 09:38:18 JST 2017
Kouhei Sutou 2017-06-10 09:38:18 +0900 (Sat, 10 Jun 2017) New Revision: a5b7e6da8f8df9228af4efd6fce8542107934d8b https://github.com/pgroonga/pgroonga.github.io/commit/a5b7e6da8f8df9228af4efd6fce8542107934d8b Message: query-jsonb ja: translate Modified files: _po/ja/reference/operators/script-jsonb.po ja/reference/operators/script-jsonb-v2.md ja/reference/operators/script-jsonb.md reference/operators/script-jsonb.md Modified: _po/ja/reference/operators/script-jsonb.po (+87 -35) =================================================================== --- _po/ja/reference/operators/script-jsonb.po 2017-06-10 09:26:47 +0900 (5a2343c) +++ _po/ja/reference/operators/script-jsonb.po 2017-06-10 09:38:18 +0900 (1903c99) @@ -1,7 +1,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"PO-Revision-Date: 2017-04-29 12:39+0900\n" +"PO-Revision-Date: 2017-06-10 09:37+0900\n" "Language: ja\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -26,20 +26,24 @@ msgid "## Summary" msgstr "## 概要" msgid "" +"This operator is deprecated since 1.2.1. Use [`` &` `` operator][script-jsonb-" +"v2] instead." +msgstr "この演算子は1.2.1から非推奨になりました。代わりに[`` &` ``演算子][script-jsonb-v2]を使ってください。" + +msgid "" "`@@` operator is a PGroonga original operator. You can use complex condition t" -"hat can't be written by [`@>` operator](jsonb-contain.html) such as range sear" -"ch." +"hat can't be written by [`@>` operator][contain-jsonb] such as range search." msgstr "" -"`@@`演算子はPGroonga独自の演算子です。範囲検索のような[`@>`演算子](jsonb-contain.html)では書けないような複雑な条件を書" -"くことができます。" +"`@@`演算子はPGroonga独自の演算子です。[`@>`演算子][contain-jsonb]では書けない範囲検索のような複雑な条件を書くことができます" +"。" msgid "" -"If you know [JsQuery](https://github.com/postgrespro/jsquery), you can underst" -"and like \"PGroonga provides `jsonb` type related search features that are simi" -"lar to JsQuery with different syntax\"." +"If you know [JsQuery][jsquery], you can understand like \"PGroonga provides `js" +"onb` type related search features that are similar to JsQuery with different s" +"yntax\"." msgstr "" -"もし[JsQuery](https://github.com/postgrespro/jsquery)を知っているなら、「PGroongaはJsQueryが" -"提供しているような`jsonb`型用の検索機能を違う構文で提供している」と理解してください。" +"もし[JsQuery][jsquery]を知っているなら、「PGroongaはJsQueryが提供しているような`jsonb`型用の検索機能を違う構文で提供" +"している」と理解してください。" msgid "## Syntax" msgstr "## 構文" @@ -58,16 +62,30 @@ msgstr "`jsonb_column`は`jsonb`型のカラムです。" msgid "" "`condition` is a `text` value used as query. It uses [Groonga's script syntax]" -"(http://groonga.org/docs/reference/grn_expr/script_syntax.html)." +"[groogna-script-syntax]." msgstr "" -"`condition`はクエリーとして使う`text`型の値です。[Groongaのスクリプト構文](http://groonga.org/ja/docs/" -"reference/grn_expr/script_syntax.html)を使います。" +"`condition`はクエリーとして使う`text`型の値です。[Groongaのスクリプト構文][groonga-script-syntax]を使います" +"。" msgid "" "The operator returns `true` when `condition` matches `jsonb_column` value, `fa" "lse` otherwise." msgstr "この演算子は`condition`が`jsonb_column`の値にマッチしたら`true`を返し、マッチしなかったら`false`を返します。" +msgid "## Operator classes" +msgstr "## 演算子クラス" + +msgid "" +"You need to specify one of the following operator classes to use this operator" +":" +msgstr "この演算子を使うには次のどれかの演算子クラスを指定する必要があります。" + +msgid " * `pgroonga.jsonb_ops`: Default for `jsonb`" +msgstr " * `pgroonga.jsonb_ops`：`jsonb`型のデフォルト" + +msgid " * `pgroonga.jsonb_ops_v2`: For `jsonb`" +msgstr " * `pgroonga.jsonb_ops_v2`：`jsonb`型用" + msgid "## Usage" msgstr "## 使い方" @@ -164,15 +182,14 @@ msgstr "" "このカラムは検索条件には使いません。" msgid "" -" * `path`: The path of the value from root. It uses [jq](https://stedolan.git" -"hub.io/jq/) compatible format. Object is `[\"${ELEMENT_NAME}\"]`, array is `[]`." -" For example, the path of `\"web\"` in `{\"tags\": [\"web\"]}` is `.[\"tags\"][]`. If " -"you know absolute path of the value, you can use this value in search conditio" -"n." +" * `path`: The path of the value from root. It uses [jq][jq] compatible forma" +"t. Object is `[\"${ELEMENT_NAME}\"]`, array is `[]`. For example, the path of `\"" +"web\"` in `{\"tags\": [\"web\"]}` is `.[\"tags\"][]`. If you know absolute path of th" +"e value, you can use this value in search condition." msgstr "" -" * `path`：値がある位置へのルートからのパスです。[jq](https://stedolan.github.io/jq/)互換のフォーマットです。" -"オブジェクトは`[\"${要素名}\"]`で配列は`[]`です。たとえば、`{\"tags\": [\"web\"]}`の中の`\"web\"`のパスは`.[\"tags\"]" -"[]`です。もし、値の絶対パスを知っているなら検索条件でこの値を使えます。" +" * `path`：値がある位置へのルートからのパスです。[jq][jq]互換のフォーマットです。オブジェクトは`[\"${要素名}\"]`で配列は`[]`で" +"す。たとえば、`{\"tags\": [\"web\"]}`の中の`\"web\"`のパスは`.[\"tags\"][]`です。もし、値の絶対パスを知っているなら検索条件で" +"この値を使えます。" msgid "" " * `paths`: The paths of the value. It includes absolute path, sub paths, `.$" @@ -280,12 +297,11 @@ msgid "" msgstr "次は`www.example.com`という文字列値を含む`jsonb`型の値を検索する条件です。" msgid "" -"(It uses [`jsonb_pretty()` function]({{ site.postgresql_doc_base_url.en }}/fun" -"ctions-json.html#FUNCTIONS-JSON-PROCESSING-TABLE) provided since PostgreSQL 9." -"5 for readability.)" +"(It uses [`jsonb_pretty()` function][postgresql-jsonb-pretty] provided since P" +"ostgreSQL 9.5 for readability.)" msgstr "" -"（読みやすくするためにPostgreSQL 9.5以降で使える[`jsonb_pretty()`関数]({{ site.postgresql_doc_bas" -"e_url.ja }}/functions-json.html#functions-json-processing-table)を使っています。）" +"（読みやすくするためにPostgreSQL 9.5以降で使える[`jsonb_pretty()`関数][postgresql-jsonb-pretty]を使" +"っています。）" msgid "" "```sql\n" @@ -364,12 +380,11 @@ msgid "" msgstr "" msgid "" -"You can use [Groonga's query syntax](http://groonga.org/docs/reference/grn_exp" -"r/query_syntax.html) (`a OR b` can be used) for full text search by `query(\"st" -"ring\", \"...\")` syntax:" +"You can use [Groonga's query syntax][groonga-query-syntax] (`a OR b` can be us" +"ed) for full text search by `query(\"string\", \"...\")` syntax:" msgstr "" -"全文検索用に[Groongaのクエリー構文](http://groonga.org/ja/docs/reference/grn_expr/query_syn" -"tax.html)（`a OR b`という構文を使えます）を使うには`query(\"string\", \"...\")`という構文を使います。" +"全文検索用に[Groongaのクエリー構文][groonga-query-syntax]（`a OR b`という構文を使えます）を使うには`query(\"s" +"tring\", \"...\")`という構文を使います。" msgid "" "```sql\n" @@ -400,9 +415,46 @@ msgstr "" msgid "## See also" msgstr "## 参考" +msgid " * [`jsonb` support][jsonb]" +msgstr " * [`jsonb`サポート][jsonb]" + +msgid " * [`@>` operator][contain-jsonb]: Search by a `jsonb` data" +msgstr " * [`@>`演算子][contain-jsonb]：`jsonb`データを使った検索" + +msgid "" +" * [`` &` `` operator][script-jsonb-v2]: Advanced search by ECMAScript like q" +"uery language" +msgstr " * [`` &` ``演算子][script-jsonb-v2]：ECMAScriptのようなクエリー言語を使った高度な検索" + +msgid "[jsonb]:../jsonb.html" +msgstr "" + +msgid "" +"[contain-jsonb]:contain-jsonb.html\n" +"[script-jsonb-v2]:script-jsonb-v2.html\n" +"[jsquery]:https://github.com/postgrespro/jsquery" +msgstr "" + +msgid "[jq]:https://stedolan.github.io/jq/" +msgstr "" + +msgid "" +"[groonga-query-syntax]:http://groonga.org/docs/reference/grn_expr/query_syntax" +".html" +msgstr "" +"[groonga-query-syntax]:http://groonga.org/ja/docs/reference/grn_expr/query_syn" +"tax.html" + +msgid "" +"[groonga-script-syntax]:http://groonga.org/docs/reference/grn_expr/script_synt" +"ax.html" +msgstr "" +"[groonga-script-syntax]:http://groonga.org/ja/docs/reference/grn_expr/script_s" +"yntax.html" + msgid "" -" * [`jsonb` support](../jsonb.html)\n" -" * [`@>` operator](jsonb-contain.html)" +"[postgresql-jsonb-pretty]:{{ site.postgresql_doc_base_url.en }}/functions-json" +".html#FUNCTIONS-JSON-PROCESSING-TABLE" msgstr "" -" * [`jsonb`サポート](../jsonb.html)\n" -" * [`@>`演算子](jsonb-contain.html)" +"[postgresql-jsonb-pretty]:{{ site.postgresql_doc_base_url.ja }}/functions-json" +".html#FUNCTIONS-JSON-PROCESSING-TABLE" Modified: ja/reference/operators/script-jsonb-v2.md (+0 -1) =================================================================== --- ja/reference/operators/script-jsonb-v2.md 2017-06-10 09:26:47 +0900 (5c06f7a) +++ ja/reference/operators/script-jsonb-v2.md 2017-06-10 09:38:18 +0900 (25ef229) @@ -230,7 +230,6 @@ SELECT jsonb_pretty(record) FROM logs WHERE record &` 'string @ "started"'; 全文検索用に[Groongaのクエリー構文][groonga-query-syntax]（`a OR b`という構文を使えます）を使うには`query("string", "...")`という構文を使います。 - ```sql SELECT jsonb_pretty(record) FROM logs WHERE record &` 'query("string", "send OR server")'; -- jsonb_pretty Modified: ja/reference/operators/script-jsonb.md (+35 -8) =================================================================== --- ja/reference/operators/script-jsonb.md 2017-06-10 09:26:47 +0900 (5474f37) +++ ja/reference/operators/script-jsonb.md 2017-06-10 09:38:18 +0900 (17c049f) @@ -7,9 +7,11 @@ upper_level: ../ ## 概要 -`@@`演算子はPGroonga独自の演算子です。範囲検索のような[`@>`演算子](jsonb-contain.html)では書けないような複雑な条件を書くことができます。 +この演算子は1.2.1から非推奨になりました。代わりに[`` &` ``演算子][script-jsonb-v2]を使ってください。 -もし[JsQuery](https://github.com/postgrespro/jsquery)を知っているなら、「PGroongaはJsQueryが提供しているような`jsonb`型用の検索機能を違う構文で提供している」と理解してください。 +`@@`演算子はPGroonga独自の演算子です。[`@>`演算子][contain-jsonb]では書けない範囲検索のような複雑な条件を書くことができます。 + +もし[JsQuery][jsquery]を知っているなら、「PGroongaはJsQueryが提供しているような`jsonb`型用の検索機能を違う構文で提供している」と理解してください。 ## 構文 @@ -21,10 +23,18 @@ jsonb_column @@ condition `jsonb_column`は`jsonb`型のカラムです。 -`condition`はクエリーとして使う`text`型の値です。[Groongaのスクリプト構文](http://groonga.org/ja/docs/reference/grn_expr/script_syntax.html)を使います。 +`condition`はクエリーとして使う`text`型の値です。[Groongaのスクリプト構文][groonga-script-syntax]を使います。 この演算子は`condition`が`jsonb_column`の値にマッチしたら`true`を返し、マッチしなかったら`false`を返します。 +## 演算子クラス + +この演算子を使うには次のどれかの演算子クラスを指定する必要があります。 + + * `pgroonga.jsonb_ops`：`jsonb`型のデフォルト + + * `pgroonga.jsonb_ops_v2`：`jsonb`型用 + ## 使い方 例に使うサンプルスキーマとデータは次の通りです。 @@ -93,7 +103,7 @@ CREATE TABLE values ( * `key`：値のIDです。値が違うパスで違う内容なら`key`は違う値になります。キーのフォーマットは`'${パス}|${種類}|${値}'`です。このカラムは検索条件には使いません。 - * `path`：値がある位置へのルートからのパスです。[jq](https://stedolan.github.io/jq/)互換のフォーマットです。オブジェクトは`["${要素名}"]`で配列は`[]`です。たとえば、`{"tags": ["web"]}`の中の`"web"`のパスは`.["tags"][]`です。もし、値の絶対パスを知っているなら検索条件でこの値を使えます。 + * `path`：値がある位置へのルートからのパスです。[jq][jq]互換のフォーマットです。オブジェクトは`["${要素名}"]`で配列は`[]`です。たとえば、`{"tags": ["web"]}`の中の`"web"`のパスは`.["tags"][]`です。もし、値の絶対パスを知っているなら検索条件でこの値を使えます。 * `paths`: 値を示すパスです。値を示すパスは複数あります。絶対パス、サブパス、`.${要素名1}.${要素名2}`というフォーマットのパス、配列部分を省略したパスがあります。このカラムは検索条件の指定を便利にするために用意されています。検索時にはこの中のパスのどれでも使うことができます。以下はどれも`{"a": {"b": "c": ["x"]}}`の中の`"x"`を指定するパスです。 @@ -157,7 +167,7 @@ CREATE TABLE values ( 次は`www.example.com`という文字列値を含む`jsonb`型の値を検索する条件です。 -（読みやすくするためにPostgreSQL 9.5以降で使える[`jsonb_pretty()`関数]({{ site.postgresql_doc_base_url.ja }}/functions-json.html#functions-json-processing-table)を使っています。） +（読みやすくするためにPostgreSQL 9.5以降で使える[`jsonb_pretty()`関数][postgresql-jsonb-pretty]を使っています。） ```sql SELECT jsonb_pretty(record) FROM logs WHERE record @@ 'string == "www.example.com"'; @@ -218,7 +228,7 @@ SELECT jsonb_pretty(record) FROM logs WHERE record @@ 'string @ "started"'; -- (1 row) ``` -全文検索用に[Groongaのクエリー構文](http://groonga.org/ja/docs/reference/grn_expr/query_syntax.html)（`a OR b`という構文を使えます）を使うには`query("string", "...")`という構文を使います。 +全文検索用に[Groongaのクエリー構文][groonga-query-syntax]（`a OR b`という構文を使えます）を使うには`query("string", "...")`という構文を使います。 ```sql SELECT jsonb_pretty(record) FROM logs WHERE record @@ 'query("string", "send OR server")'; @@ -245,5 +255,22 @@ SELECT jsonb_pretty(record) FROM logs WHERE record @@ 'query("string", "send OR ## 参考 - * [`jsonb`サポート](../jsonb.html) - * [`@>`演算子](jsonb-contain.html) + * [`jsonb`サポート][jsonb] + + * [`@>`演算子][contain-jsonb]：`jsonb`データを使った検索 + + * [`` &` ``演算子][script-jsonb-v2]：ECMAScriptのようなクエリー言語を使った高度な検索 + +[jsonb]:../jsonb.html + +[contain-jsonb]:contain-jsonb.html +[script-jsonb-v2]:script-jsonb-v2.html +[jsquery]:https://github.com/postgrespro/jsquery + +[jq]:https://stedolan.github.io/jq/ + +[groonga-query-syntax]:http://groonga.org/ja/docs/reference/grn_expr/query_syntax.html + +[groonga-script-syntax]:http://groonga.org/ja/docs/reference/grn_expr/script_syntax.html + +[postgresql-jsonb-pretty]:{{ site.postgresql_doc_base_url.ja }}/functions-json.html#FUNCTIONS-JSON-PROCESSING-TABLE Modified: reference/operators/script-jsonb.md (+2 -2) =================================================================== --- reference/operators/script-jsonb.md 2017-06-10 09:26:47 +0900 (8378ebf) +++ reference/operators/script-jsonb.md 2017-06-10 09:38:18 +0900 (f80b891) @@ -257,9 +257,9 @@ SELECT jsonb_pretty(record) FROM logs WHERE record @@ 'query("string", "send OR * [`jsonb` support][jsonb] - * [`@>` operator][contain-jsonb] + * [`@>` operator][contain-jsonb]: Search by a `jsonb` data - * [`` &` `` operator][script-jsonb-v2] + * [`` &` `` operator][script-jsonb-v2]: Advanced search by ECMAScript like query language [jsonb]:../jsonb.html -------------- next part -------------- HTML����������������������������...ダウンロード
