Kouhei Sutou
null+****@clear*****
Thu Feb 11 11:54:14 JST 2016
Kouhei Sutou 2016-02-11 11:54:14 +0900 (Thu, 11 Feb 2016) New Revision: c06ade4811d8e376e1ecc3b8b1555ec26ad26eda https://github.com/pgroonga/pgroonga.github.io/commit/c06ade4811d8e376e1ecc3b8b1555ec26ad26eda Message: Document how to use PGroonga by normal user Added files: _po/ja/reference/grant-usage-on-schema-pgroonga.po ja/reference/grant-usage-on-schema-pgroonga.md reference/grant-usage-on-schema-pgroonga.md Modified files: _po/ja/reference/index.po ja/reference/index.md reference/index.md Added: _po/ja/reference/grant-usage-on-schema-pgroonga.po (+105 -0) 100644 =================================================================== --- /dev/null +++ _po/ja/reference/grant-usage-on-schema-pgroonga.po 2016-02-11 11:54:14 +0900 (8e5c718) @@ -0,0 +1,105 @@ +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"PO-Revision-Date: 2016-02-11 11:53+0900\n" +"Language: ja\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +msgid "" +"---\n" +"title: GRANT USAGE ON SCHEME pgroonga\n" +"layout: en\n" +"---" +msgstr "" +"---\n" +"title: GRANT USAGE ON SCHEME pgroonga\n" +"layout: ja\n" +"---" + +msgid "# `GRANT USAGE ON SCHEME pgroonga`" +msgstr "" + +msgid "" +"PGroonga defines functions, operators, operator classes and so on into `pgroon" +"ga` schema. Only superuser can use features in `pgroonga` schema by default. S" +"uperuser needs to grant `USAGE` privilege on `pgroonga` schema to normal users" +" who want to use PGroonga." +msgstr "" + +msgid "" +"This document describes how to grant `USAGE` privilege on `pgroonga` schema to" +" a normal user." +msgstr "このドキュメントは一般ユーザーに`pgroonga`スキーマの`USAGE`権限を与える方法を説明します。" + +msgid "## Create a normal user {#create-user}" +msgstr "## 一般ユーザーを作成 {#create-user}" + +msgid "" +"First, create a normal user `alice` by [`CREATE USER`](http://www.postgresql.o" +"rg/docs/{{ site.postgresql_short_version }}/static/sql-createuser.html):" +msgstr "" +"最初に[`CREATE USER`](http://www.postgresql.jp/document/{{ site.postgresql_short_" +"version }}/html/sql-createuser.html)で一般ユーザー`alice`を作成します。" + +msgid "" +"```sql\n" +"CREATE USER alice;\n" +"```" +msgstr "" + +msgid "" +"Normal user `alice` can't access any objects in `pgroonga` schema at this time" +". For example, `alice` can't use [`pgroonga.snippet_html` function](functions/" +"pgroonga-snippet-html.html):" +msgstr "" +"この時点では、一般ユーザー`alice`は`pgroonga`スキーマのどのオブジェクトにもアクセスできません。例えば、`alice`は[`pgroonga" +".snippet_html`関数](functions/pgroonga-snippet-html.html)を使うことができません。" + +msgid "" +"```sql\n" +"SELECT pgroonga.snippet_html('PGroonga is fast', Array['fast']);\n" +"-- ERROR: permission denied for schema pgroonga\n" +"-- LINE 1: SELECT pgroonga.snippet_html('PGroonga is fast', Array['fast...\n" +"-- ^\n" +"```" +msgstr "" + +msgid "You need to grant `USAGE` privilege on `pgroonga` schema to `alice`." +msgstr "`alice`に`pgroonga`スキーマの`USAGE`権限を与える必要があります。" + +msgid "## Grant `USAGE` privilege on `pgroonga` schema {#grant}" +msgstr "## `pgroonga`スキーマの`USAGE`権限を与える {#grant}" + +msgid "" +"You can grant `USAGE` privilege on `pgroonga` schema to normal user `alice` by" +" [`GRANT`](http://www.postgresql.org/docs/{{ site.postgresql_short_version }}/" +"static/sql-grant.html):" +msgstr "" +"[`GRANT`](http://www.postgresql.jp/document/{{ site.postgresql_short_version }" +"}/html/sql-grant.html)を使って一般ユーザー`alice`に`pgroonga`スキーマの`USAGE`権限を与えることができます。" + +msgid "" +"```sql\n" +"GRANT USAGE ON SCHEMA pgroonga TO alice;\n" +"```" +msgstr "" + +msgid "" +"Now, `alice` can use all features in `pgroonga` schema. For example, `alice` c" +"an use `pgroonga.snippet_html` function:" +msgstr "" +"これで`alice`は`pgroonga`スキーマのすべての機能を使えるようになりました。例えば、`alice`は`pgroonga.snippet_htm" +"l`関数を使うことができます。" + +msgid "" +"```sql\n" +"SELECT pgroonga.snippet_html('PGroonga is fast', Array['fast']);\n" +"-- snippet_html \n" +"-- -----------------------------------------------------\n" +"-- {\"PGroonga is <span class=\\\"keyword\\\">fast</span>\"}\n" +"-- (1 row)\n" +"```" +msgstr "" Modified: _po/ja/reference/index.po (+17 -1) =================================================================== --- _po/ja/reference/index.po 2016-02-11 11:03:27 +0900 (7b4db0c) +++ _po/ja/reference/index.po 2016-02-11 11:54:14 +0900 (d8ec754) @@ -1,7 +1,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"PO-Revision-Date: 2016-01-03 17:35+0900\n" +"PO-Revision-Date: 2016-02-11 11:48+0900\n" "Language: ja\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -32,6 +32,22 @@ msgstr "" "キュメントは完全に説明することに注力しています。もし、まだ[チュートリアル](../tutorial/)を読んでいない場合は、このドキュメントを読む前にチュ" "ートリアルを読んでください。" +msgid "## `pgroonga` schema" +msgstr "## `pgroonga`スキーマ" + +msgid "" +"PGroonga defines functions, operators, operator classes and so on into `pgroon" +"ga` schema. Only superuser can use features in `pgroonga` schema by default. S" +"uperuser needs to grant `USAGE` privilege on `pgroonga` schema to normal users" +" who want to use PGroonga." +msgstr "" +"PGroongaは`pgroonga`スキーマに関数・演算子・演算子クラスなどを定義します。デフォルトではスーパーユーザーしか`pgroonga`スキーマの" +"機能を使えません。スーパーユーザーはPGroongaを使いたいすべての一般ユーザーに`pgroonga`スキーマの`USAGE`権限を与えなければいけません" +"。" + +msgid " * [`GRANT USAGE ON SCHEMA pgroonga`](grant-usage-on-schema-pgroonga.html)" +msgstr "" + msgid "## `pgroonga` index" msgstr "## `pgroonga`インデックス" Added: ja/reference/grant-usage-on-schema-pgroonga.md (+47 -0) 100644 =================================================================== --- /dev/null +++ ja/reference/grant-usage-on-schema-pgroonga.md 2016-02-11 11:54:14 +0900 (c8f07f0) @@ -0,0 +1,47 @@ +--- +title: GRANT USAGE ON SCHEME pgroonga +layout: ja +--- + +# `GRANT USAGE ON SCHEME pgroonga` + +PGroongaは`pgroonga`スキーマに関数・演算子・演算子クラスなどを定義します。デフォルトではスーパーユーザーしか`pgroonga`スキーマの機能を使えません。スーパーユーザーはPGroongaを使いたいすべての一般ユーザーに`pgroonga`スキーマの`USAGE`権限を与えなければいけません。 + +このドキュメントは一般ユーザーに`pgroonga`スキーマの`USAGE`権限を与える方法を説明します。 + +## 一般ユーザーを作成 {#create-user} + +最初に[`CREATE USER`](http://www.postgresql.jp/document/{{ site.postgresql_short_version }}/html/sql-createuser.html)で一般ユーザー`alice`を作成します。 + +```sql +CREATE USER alice; +``` + +この時点では、一般ユーザー`alice`は`pgroonga`スキーマのどのオブジェクトにもアクセスできません。例えば、`alice`は[`pgroonga.snippet_html`関数](functions/pgroonga-snippet-html.html)を使うことができません。 + +```sql +SELECT pgroonga.snippet_html('PGroonga is fast', Array['fast']); +-- ERROR: permission denied for schema pgroonga +-- LINE 1: SELECT pgroonga.snippet_html('PGroonga is fast', Array['fast... +-- ^ +``` + +`alice`に`pgroonga`スキーマの`USAGE`権限を与える必要があります。 + +## `pgroonga`スキーマの`USAGE`権限を与える {#grant} + +[`GRANT`](http://www.postgresql.jp/document/{{ site.postgresql_short_version }}/html/sql-grant.html)を使って一般ユーザー`alice`に`pgroonga`スキーマの`USAGE`権限を与えることができます。 + +```sql +GRANT USAGE ON SCHEMA pgroonga TO alice; +``` + +これで`alice`は`pgroonga`スキーマのすべての機能を使えるようになりました。例えば、`alice`は`pgroonga.snippet_html`関数を使うことができます。 + +```sql +SELECT pgroonga.snippet_html('PGroonga is fast', Array['fast']); +-- snippet_html +-- ----------------------------------------------------- +-- {"PGroonga is <span class=\"keyword\">fast</span>"} +-- (1 row) +``` Modified: ja/reference/index.md (+6 -0) =================================================================== --- ja/reference/index.md 2016-02-11 11:03:27 +0900 (d910ebd) +++ ja/reference/index.md 2016-02-11 11:54:14 +0900 (ad8d91e) @@ -7,6 +7,12 @@ layout: ja このドキュメントはすべての機能を説明しています。[チュートリアル](../tutorial/)は重要な機能だけを簡単に理解できることに注力しています。このドキュメントは完全に説明することに注力しています。もし、まだ[チュートリアル](../tutorial/)を読んでいない場合は、このドキュメントを読む前にチュートリアルを読んでください。 +## `pgroonga`スキーマ + +PGroongaは`pgroonga`スキーマに関数・演算子・演算子クラスなどを定義します。デフォルトではスーパーユーザーしか`pgroonga`スキーマの機能を使えません。スーパーユーザーはPGroongaを使いたいすべての一般ユーザーに`pgroonga`スキーマの`USAGE`権限を与えなければいけません。 + + * [`GRANT USAGE ON SCHEMA pgroonga`](grant-usage-on-schema-pgroonga.html) + ## `pgroonga`インデックス * [`CREATE INDEX USING pgroonga`](create-index-using-pgroonga.html) Added: reference/grant-usage-on-schema-pgroonga.md (+47 -0) 100644 =================================================================== --- /dev/null +++ reference/grant-usage-on-schema-pgroonga.md 2016-02-11 11:54:14 +0900 (bb12e9d) @@ -0,0 +1,47 @@ +--- +title: GRANT USAGE ON SCHEME pgroonga +layout: en +--- + +# `GRANT USAGE ON SCHEME pgroonga` + +PGroonga defines functions, operators, operator classes and so on into `pgroonga` schema. Only superuser can use features in `pgroonga` schema by default. Superuser needs to grant `USAGE` privilege on `pgroonga` schema to normal users who want to use PGroonga. + +This document describes how to grant `USAGE` privilege on `pgroonga` schema to a normal user. + +## Create a normal user {#create-user} + +First, create a normal user `alice` by [`CREATE USER`](http://www.postgresql.org/docs/{{ site.postgresql_short_version }}/static/sql-createuser.html): + +```sql +CREATE USER alice; +``` + +Normal user `alice` can't access any objects in `pgroonga` schema at this time. For example, `alice` can't use [`pgroonga.snippet_html` function](functions/pgroonga-snippet-html.html): + +```sql +SELECT pgroonga.snippet_html('PGroonga is fast', Array['fast']); +-- ERROR: permission denied for schema pgroonga +-- LINE 1: SELECT pgroonga.snippet_html('PGroonga is fast', Array['fast... +-- ^ +``` + +You need to grant `USAGE` privilege on `pgroonga` schema to `alice`. + +## Grant `USAGE` privilege on `pgroonga` schema {#grant} + +You can grant `USAGE` privilege on `pgroonga` schema to normal user `alice` by [`GRANT`](http://www.postgresql.org/docs/{{ site.postgresql_short_version }}/static/sql-grant.html): + +```sql +GRANT USAGE ON SCHEMA pgroonga TO alice; +``` + +Now, `alice` can use all features in `pgroonga` schema. For example, `alice` can use `pgroonga.snippet_html` function: + +```sql +SELECT pgroonga.snippet_html('PGroonga is fast', Array['fast']); +-- snippet_html +-- ----------------------------------------------------- +-- {"PGroonga is <span class=\"keyword\">fast</span>"} +-- (1 row) +``` Modified: reference/index.md (+6 -0) =================================================================== --- reference/index.md 2016-02-11 11:03:27 +0900 (621955a) +++ reference/index.md 2016-02-11 11:54:14 +0900 (93d00e7) @@ -7,6 +7,12 @@ layout: en This document describes about all features. [Tutorial](../tutorial/) focuses on easy to understand only about important features. This document focuses on completeness. If you don't read [tutorial](../tutorial/) yet, read tutorial before read this document. +## `pgroonga` schema + +PGroonga defines functions, operators, operator classes and so on into `pgroonga` schema. Only superuser can use features in `pgroonga` schema by default. Superuser needs to grant `USAGE` privilege on `pgroonga` schema to normal users who want to use PGroonga. + + * [`GRANT USAGE ON SCHEMA pgroonga`](grant-usage-on-schema-pgroonga.html) + ## `pgroonga` index * [`CREATE INDEX USING pgroonga`](create-index-using-pgroonga.html) -------------- next part -------------- HTML����������������������������...Download