Navigation Menu

Skip to content

Commit

Permalink
Use common format
Browse files Browse the repository at this point in the history
  • Loading branch information
kou committed Oct 25, 2015
1 parent 0e22164 commit f14ea97
Show file tree
Hide file tree
Showing 3 changed files with 183 additions and 12 deletions.
101 changes: 96 additions & 5 deletions _po/ja/reference/operators/query.po
@@ -1,7 +1,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"PO-Revision-Date: 2015-10-24 17:55+0900\n"
"PO-Revision-Date: 2015-10-25 22:25+0900\n"
"Language: ja\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
Expand All @@ -22,24 +22,103 @@ msgstr ""
msgid "# `@@` operator for non `jsonb` types"
msgstr "# `jsonb`型以外の型用の`@@`演算子"

msgid "## Summary"
msgstr "## 概要"

msgid ""
"You can do full text search with multiple keywords by `@@` operator like `KEYW"
"ORD1 KEYWORD2`. You can also do OR search by `KEYWORD1 OR KEYWORD2`:"
"`@@` operator performs full text search with query. Its syntax is similar to s"
"yntax that is used in Web search engine. For example, you can use OR search by"
" `KEYWORD1 OR KEYWORD2` in query."
msgstr ""
"`@@`演算子はクエリーを使って全文検索を実行します。クエリーの構文はWeb検索エンジンで使われている構文と似ています。たとえば、クエリーで`キーワード1 "
"OR キーワード2`と書くとOR検索できます。"

msgid "## Syntax"
msgstr "## 構文"

msgid ""
"```sql\n"
"column @@ query\n"
"```"
msgstr ""

msgid "`column` is a column to be searched."
msgstr "`column`は検索対象のカラムです。"

msgid "`query` is a query for full text search. It's `text` type."
msgstr "`query`は全文検索で使うクエリーです。`text`型です。"

msgid ""
"[Groonga's query syntax](http://groonga.org/docs/reference/grn_expr/query_synt"
"ax.html) is used in `query`."
msgstr ""
"`query`では[Groongaのクエリー構文](http://groonga.org/docs/reference/grn_expr/query_syn"
"tax.html)を使います。"

msgid "## Usage"
msgstr "## 使い方"

msgid "Here are sample schema and data for examples:"
msgstr "例に使うサンプルスキーマとデータは次の通りです。"

msgid ""
"```sql\n"
"CREATE TABLE memos (\n"
" id integer,\n"
" content text\n"
");"
msgstr ""

msgid ""
"CREATE INDEX pgroonga_content_index ON memos USING pgroonga (content);\n"
"```"
msgstr ""

msgid ""
"```sql\n"
"INSERT INTO memos VALUES (1, 'PostgreSQL is a relational database management s"
"ystem.');\n"
"INSERT INTO memos VALUES (2, 'Groonga is a fast full text search engine that s"
"upports all languages.');\n"
"INSERT INTO memos VALUES (3, 'PGroonga is a PostgreSQL extension that uses Gro"
"onga as index.');\n"
"INSERT INTO memos VALUES (4, 'There is groonga command.');\n"
"```"
msgstr ""
"```sql\n"
"INSERT INTO memos VALUES (1, 'PostgreSQLはリレーショナル・データベース管理システムです。');\n"
"INSERT INTO memos VALUES (2, 'Groongaは日本語対応の高速な全文検索エンジンです。');\n"
"INSERT INTO memos VALUES (3, 'PGroongaはインデックスとしてGroongaを使うためのPostgreSQLの拡張機能です"
"。');\n"
"INSERT INTO memos VALUES (4, 'groongaコマンドがあります。');\n"
"```"

msgid ""
"You can perform full text search with multiple keywords by `@@` operator like "
"`KEYWORD1 KEYWORD2`. You can also do OR search by `KEYWORD1 OR KEYWORD2`:"
msgstr ""
"`@@`演算子を使うと`キーワード1 キーワード2`のように複数のキーワードを指定して全文検索できます。`キーワード1 OR キーワード2`のようにOR検索"
"することもできます。"

msgid ""
"```sql\n"
"SELECT * FROM memos WHERE content @@ 'PGroonga OR PostgreSQL';\n"
"-- id | content \n"
"-- ----+----------------------------------------------------------------\n"
"-- 3 | PGroonga is a PostgreSQL extension that uses Groonga as index.\n"
"-- 1 | PostgreSQL is a relational database management system.\n"
"-- (2 rows)\n"
"```"
msgstr ""
"```sql\n"
"SELECT * FROM memos WHERE content @@ 'PGroonga OR PostgreSQL';\n"
"-- id | content\n"
"-- ----+----------------------------------------------------------------------"
"-----\n"
"-- 3 | PGroongaはインデックスとしてGroongaを使うためのPostgreSQLの拡張機能です。\n"
"-- 1 | PostgreSQLはリレーショナル・データベース管理システムです。\n"
"-- (2 )\n"
"-- (2 rows)\n"
"```"
msgstr ""

msgid ""
"See [Groonga document](http://groonga.org/docs/reference/grn_expr/query_syntax"
Expand All @@ -57,3 +136,15 @@ msgid ""
"You can't use `COLUMN_NAME:^VALUE` for prefix search. You need to use `VALUE*`"
" for prefix search."
msgstr "前方一致検索のために`カラム名:^値`という構文を使うことができません。前方一致検索には`値*`を使ってください。"

msgid "## See also"
msgstr "## 参考"

msgid ""
" * [`%%` operator](match.html)\n"
" * [Groonga's query syntax](http://groonga.org/docs/reference/grn_expr/query_"
"syntax.html)"
msgstr ""
" * [`%%`演算子](match.html)\n"
" * [Groongaのクエリー構文](http://groonga.org/ja/docs/reference/grn_expr/query_synta"
"x.html)"
42 changes: 41 additions & 1 deletion ja/reference/operators/query.md
Expand Up @@ -5,6 +5,42 @@ layout: ja

# `jsonb`型以外の型用の`@@`演算子

## 概要

`@@`演算子はクエリーを使って全文検索を実行します。クエリーの構文はWeb検索エンジンで使われている構文と似ています。たとえば、クエリーで`キーワード1 OR キーワード2`と書くとOR検索できます。

## 構文

```sql
column @@ query
```

`column`は検索対象のカラムです。

`query`は全文検索で使うクエリーです。`text`型です。

`query`では[Groongaのクエリー構文](http://groonga.org/docs/reference/grn_expr/query_syntax.html)を使います。

## 使い方

例に使うサンプルスキーマとデータは次の通りです。

```sql
CREATE TABLE memos (
id integer,
content text
);

CREATE INDEX pgroonga_content_index ON memos USING pgroonga (content);
```

```sql
INSERT INTO memos VALUES (1, 'PostgreSQLはリレーショナル・データベース管理システムです。');
INSERT INTO memos VALUES (2, 'Groongaは日本語対応の高速な全文検索エンジンです。');
INSERT INTO memos VALUES (3, 'PGroongaはインデックスとしてGroongaを使うためのPostgreSQLの拡張機能です。');
INSERT INTO memos VALUES (4, 'groongaコマンドがあります。');
```

`@@`演算子を使うと`キーワード1 キーワード2`のように複数のキーワードを指定して全文検索できます。`キーワード1 OR キーワード2`のようにOR検索することもできます。

```sql
Expand All @@ -13,7 +49,7 @@ SELECT * FROM memos WHERE content @@ 'PGroonga OR PostgreSQL';
-- ----+---------------------------------------------------------------------------
-- 3 | PGroongaはインデックスとしてGroongaを使うためのPostgreSQLの拡張機能です。
-- 1 | PostgreSQLはリレーショナル・データベース管理システムです。
-- (2 )
-- (2 rows)
```

クエリーの構文の詳細は[Groongaのドキュメント](http://groonga.org/ja/docs/reference/grn_expr/query_syntax.html)を参照してください。
Expand All @@ -22,3 +58,7 @@ SELECT * FROM memos WHERE content @@ 'PGroonga OR PostgreSQL';

前方一致検索のために`カラム名:^値`という構文を使うことができません。前方一致検索には`値*`を使ってください。

## 参考

* [`%%`演算子](match.html)
* [Groongaのクエリー構文](http://groonga.org/ja/docs/reference/grn_expr/query_syntax.html)
52 changes: 46 additions & 6 deletions reference/operators/query.md
Expand Up @@ -5,15 +5,51 @@ layout: en

# `@@` operator for non `jsonb` types

You can do full text search with multiple keywords by `@@` operator like `KEYWORD1 KEYWORD2`. You can also do OR search by `KEYWORD1 OR KEYWORD2`:
## Summary

`@@` operator performs full text search with query. Its syntax is similar to syntax that is used in Web search engine. For example, you can use OR search by `KEYWORD1 OR KEYWORD2` in query.

## Syntax

```sql
column @@ query
```

`column` is a column to be searched.

`query` is a query for full text search. It's `text` type.

[Groonga's query syntax](http://groonga.org/docs/reference/grn_expr/query_syntax.html) is used in `query`.

## Usage

Here are sample schema and data for examples:

```sql
CREATE TABLE memos (
id integer,
content text
);

CREATE INDEX pgroonga_content_index ON memos USING pgroonga (content);
```

```sql
INSERT INTO memos VALUES (1, 'PostgreSQL is a relational database management system.');
INSERT INTO memos VALUES (2, 'Groonga is a fast full text search engine that supports all languages.');
INSERT INTO memos VALUES (3, 'PGroonga is a PostgreSQL extension that uses Groonga as index.');
INSERT INTO memos VALUES (4, 'There is groonga command.');
```

You can perform full text search with multiple keywords by `@@` operator like `KEYWORD1 KEYWORD2`. You can also do OR search by `KEYWORD1 OR KEYWORD2`:

```sql
SELECT * FROM memos WHERE content @@ 'PGroonga OR PostgreSQL';
-- id | content
-- ----+---------------------------------------------------------------------------
-- 3 | PGroongaはインデックスとしてGroongaを使うためのPostgreSQLの拡張機能です。
-- 1 | PostgreSQLはリレーショナル・データベース管理システムです。
-- (2 )
-- id | content
-- ----+----------------------------------------------------------------
-- 3 | PGroonga is a PostgreSQL extension that uses Groonga as index.
-- 1 | PostgreSQL is a relational database management system.
-- (2 rows)
```

See [Groonga document](http://groonga.org/docs/reference/grn_expr/query_syntax.html) for query syntax details.
Expand All @@ -22,3 +58,7 @@ Note that you can't use syntax that starts with `COLUMN_NAME:` like `COLUMN_NAME

You can't use `COLUMN_NAME:^VALUE` for prefix search. You need to use `VALUE*` for prefix search.

## See also

* [`%%` operator](match.html)
* [Groonga's query syntax](http://groonga.org/docs/reference/grn_expr/query_syntax.html)

0 comments on commit f14ea97

Please sign in to comment.