Kouhei Sutou
null+****@clear*****
Thu Oct 29 17:08:00 JST 2015
Kouhei Sutou 2015-10-29 17:08:00 +0900 (Thu, 29 Oct 2015) New Revision: b5ae00fcf6786d83813b2b5cb813830b7045f3a2 https://github.com/pgroonga/pgroonga.github.io/commit/b5ae00fcf6786d83813b2b5cb813830b7045f3a2 Message: Improve upgrade document Modified files: _po/ja/upgrade/index.po ja/upgrade/index.md upgrade/index.md Modified: _po/ja/upgrade/index.po (+97 -13) =================================================================== --- _po/ja/upgrade/index.po 2015-10-29 16:54:36 +0900 (9ad3c50) +++ _po/ja/upgrade/index.po 2015-10-29 17:08:00 +0900 (b325186) @@ -1,7 +1,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"PO-Revision-Date: 2015-10-25 23:08+0900\n" +"PO-Revision-Date: 2015-10-29 17:07+0900\n" "Language: ja\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -23,35 +23,119 @@ msgid "# Upgrade" msgstr "# アップグレード" msgid "" -"If you installed your PGroonga by package, install new PGroonga by package man" -"ager." -msgstr "パッケージでPGroongaをインストールした場合は、パッケージマネージャーを使って新しいPGroongaをインストールしてください。" +"You can upgrade PGroonga without recreating PGroonga indexes when new version " +"doesn't have any backward incompatible change. If new version has any backward" +" incompatible change, you need to recreate all PGroonga indexes to upgrade PGr" +"oonga." +msgstr "" +"新しいバージョンのPGroongaが非互換の変更を含んでいない場合はPGroongaのインデックスを再作成せずにアップグレードできます。新しいバージョンが1" +"つでも非互換の変更を含んでいればPGroongaをアップグレードする際にすべてのPGroongaのインデックスを再作成する必要があります。" + +msgid "Here is a list of compatibility:" +msgstr "以下は互換性のリストです。" + +msgid " * 0.9 -> 1.0: Incompatible" +msgstr " * 0.9 -> 1.0: 非互換" + +msgid " * 0.8 -> 0.9: Compatible" +msgstr " * 0.8 -> 0.9: 互換" + +msgid " * 0.7 -> 0.8: Incompatible" +msgstr " * 0.7 -> 0.8: 非互換" + +msgid "### Incompatible case" +msgstr "### 非互換の場合" + +msgid "Here are steps to upgrade:" +msgstr "アップグレード手順は次の通りです。" + +msgid " 1. Drop all PGroonga indexes." +msgstr " 1. すべてのPGroongaを使ったインデックスを削除します。" + +msgid " 1. Drop PGroonga extension." +msgstr " 1. PGroonga拡張を削除します。" + +msgid " 1. Upgrade PGroonga binary." +msgstr " 1. PGroongaのバイナリーをアップグレードします。" + +msgid " 1. Install PGroonga extension." +msgstr " 1. PGroonga拡張をインストールします。" + +msgid " 1. Create all PGroonga indexes again." +msgstr " 1. すべてのPGroongaのインデックスを作り直します。" + +msgid "Here is a SQL that drops all PGroonga indexes and PGroonga extension:" +msgstr "すべてのPGroongaのインデックスを削除して、PGroonga拡張も削除するSQLは次の通りです。" msgid "" -"If you installed your PGroonga by building PGroonga by yourself, build new PGr" -"oonga and override old PGroonga." -msgstr "自分でPGroongaをビルドしてインストールした場合は、新しいPGroongaをビルドして古いPGroongaを上書きしてください。" +"```sql\n" +"DROP EXTENSION pgroonga CASCADE;\n" +"```" +msgstr "" msgid "" -"Run the following SQL in your database that uses PGroonga after you replace ol" -"d PGroonga binary with new PGroonga binary:" -msgstr "古いPGroongaのバイナリーを新しいPGroongaのバイナリーで置き換えた後、PGroongaを使っているデータベースで次のSQLを実行してください。" +"You can upgrade PGroonga binary by package. Or you can upgrade by building new" +" PGroonga and override old PGroonga." +msgstr "" +"PGroongaのバイナリーはパッケージでアップグレードできます。あるいは、新しいPGroongaをビルドして古いPGroongaに上書きすることでもアップ" +"グレードできます。" + +msgid "Here is a SQL that install PGroonga extension:" +msgstr "PGroonga拡張をインストールするSQLは次の通りです。" msgid "" "```sql\n" -"ALTER EXTENSION pgroonga UPDATE;\n" +"CREATE EXTENSION pgroonga;\n" "```" msgstr "" -msgid "It upgrades PGroonga configurations." -msgstr "これはPGroongaの設定をアップグレードします。" +msgid "" +"Use [`CREATE INDEX USING pgroonga`](../reference/create-index-using-pgroonga.h" +"tml) to create PGroonga indexes." +msgstr "" +"PGroongaを使ってインデックスを作るには[`CREATE INDEX USING pgroonga`](../reference/create-ind" +"ex-using-pgroonga.html)を使ってください。" + +msgid "### Compatible case" +msgstr "### 互換性がある場合" + +msgid " 1. Upgrade PGroonga extension." +msgstr " 1. PGroonga拡張をアップグレードします。" + +msgid "Here is a SQL that upgrades PGroonga:" +msgstr "PGroongaをアップグレードするSQLは次の通りです。" + +msgid "" +"```sql\n" +"ALTER EXTENSION pgroonga UPDATE;\n" +"```" +msgstr "" msgid "## See also" msgstr "## 参考" msgid "" +" * [`CREATE EXTENSION`](http://www.postgresql.org/docs/{{ site.postgresql_sho" +"rt_version }}/static/sql-createextension.html)" +msgstr "" +" * [`CREATE EXTENSION`](http://www.postgresql.jp/document/{{ site.postgresql_" +"short_version }}/html/sql-createextension.html)" + +msgid "" +" * [`DROP EXTENSION`](http://www.postgresql.org/docs/{{ site.postgresql_short" +"_version }}/static/sql-dropextension.html)" +msgstr "" +" * [`DROP EXTENSION`](http://www.postgresql.jp/document/{{ site.postgresql_sh" +"ort_version }}/html/sql-dropextension.html)" + +msgid "" " * [`ALTER EXTENSION`](http://www.postgresql.org/docs/{{ site.postgresql_shor" "t_version }}/static/sql-alterextension.html)" msgstr "" " * [`ALTER EXTENSION`](http://www.postgresql.jp/document/{{ site.postgresql_s" "hort_version }}/html/sql-alterextension.html)" + +msgid "" +" * [`CREATE INDEX USING pgroonga`](../reference/create-index-using-pgroonga.h" +"tml)" +msgstr "" Modified: ja/upgrade/index.md (+55 -5) =================================================================== --- ja/upgrade/index.md 2015-10-29 16:54:36 +0900 (c05b2a1) +++ ja/upgrade/index.md 2015-10-29 17:08:00 +0900 (3497b35) @@ -5,18 +5,68 @@ layout: ja # アップグレード -パッケージでPGroongaをインストールした場合は、パッケージマネージャーを使って新しいPGroongaをインストールしてください。 +新しいバージョンのPGroongaが非互換の変更を含んでいない場合はPGroongaのインデックスを再作成せずにアップグレードできます。新しいバージョンが1つでも非互換の変更を含んでいればPGroongaをアップグレードする際にすべてのPGroongaのインデックスを再作成する必要があります。 -自分でPGroongaをビルドしてインストールした場合は、新しいPGroongaをビルドして古いPGroongaを上書きしてください。 +以下は互換性のリストです。 -古いPGroongaのバイナリーを新しいPGroongaのバイナリーで置き換えた後、PGroongaを使っているデータベースで次のSQLを実行してください。 + * 0.9 -> 1.0: 非互換 + + * 0.8 -> 0.9: 互換 + + * 0.7 -> 0.8: 非互換 + +### 非互換の場合 + +アップグレード手順は次の通りです。 + + 1. すべてのPGroongaを使ったインデックスを削除します。 + + 1. PGroonga拡張を削除します。 + + 1. PGroongaのバイナリーをアップグレードします。 + + 1. PGroonga拡張をインストールします。 + + 1. すべてのPGroongaのインデックスを作り直します。 + +すべてのPGroongaのインデックスを削除して、PGroonga拡張も削除するSQLは次の通りです。 ```sql -ALTER EXTENSION pgroonga UPDATE; +DROP EXTENSION pgroonga CASCADE; ``` -これはPGroongaの設定をアップグレードします。 +PGroongaのバイナリーはパッケージでアップグレードできます。あるいは、新しいPGroongaをビルドして古いPGroongaに上書きすることでもアップグレードできます。 + +PGroonga拡張をインストールするSQLは次の通りです。 + +```sql +CREATE EXTENSION pgroonga; +``` + +PGroongaを使ってインデックスを作るには[`CREATE INDEX USING pgroonga`](../reference/create-index-using-pgroonga.html)を使ってください。 + +### 互換性がある場合 + +アップグレード手順は次の通りです。 + + 1. PGroongaのバイナリーをアップグレードします。 + + 1. PGroonga拡張をアップグレードします。 + +PGroongaのバイナリーはパッケージでアップグレードできます。あるいは、新しいPGroongaをビルドして古いPGroongaに上書きすることでもアップグレードできます。 + +PGroongaをアップグレードするSQLは次の通りです。 + +```sql +ALTER EXTENSION pgroonga UPDATE; +``` ## 参考 + * [`CREATE EXTENSION`](http://www.postgresql.jp/document/{{ site.postgresql_short_version }}/html/sql-createextension.html) + + * [`DROP EXTENSION`](http://www.postgresql.jp/document/{{ site.postgresql_short_version }}/html/sql-dropextension.html) + * [`ALTER EXTENSION`](http://www.postgresql.jp/document/{{ site.postgresql_short_version }}/html/sql-alterextension.html) + + * [`CREATE INDEX USING pgroonga`](../reference/create-index-using-pgroonga.html) Modified: upgrade/index.md (+55 -5) =================================================================== --- upgrade/index.md 2015-10-29 16:54:36 +0900 (aa73528) +++ upgrade/index.md 2015-10-29 17:08:00 +0900 (c12e826) @@ -5,18 +5,68 @@ layout: en # Upgrade -If you installed your PGroonga by package, install new PGroonga by package manager. +You can upgrade PGroonga without recreating PGroonga indexes when new version doesn't have any backward incompatible change. If new version has any backward incompatible change, you need to recreate all PGroonga indexes to upgrade PGroonga. -If you installed your PGroonga by building PGroonga by yourself, build new PGroonga and override old PGroonga. +Here is a list of compatibility: -Run the following SQL in your database that uses PGroonga after you replace old PGroonga binary with new PGroonga binary: + * 0.9 -> 1.0: Incompatible + + * 0.8 -> 0.9: Compatible + + * 0.7 -> 0.8: Incompatible + +### Incompatible case + +Here are steps to upgrade: + + 1. Drop all PGroonga indexes. + + 1. Drop PGroonga extension. + + 1. Upgrade PGroonga binary. + + 1. Install PGroonga extension. + + 1. Create all PGroonga indexes again. + +Here is a SQL that drops all PGroonga indexes and PGroonga extension: ```sql -ALTER EXTENSION pgroonga UPDATE; +DROP EXTENSION pgroonga CASCADE; ``` -It upgrades PGroonga configurations. +You can upgrade PGroonga binary by package. Or you can upgrade by building new PGroonga and override old PGroonga. + +Here is a SQL that install PGroonga extension: + +```sql +CREATE EXTENSION pgroonga; +``` + +Use [`CREATE INDEX USING pgroonga`](../reference/create-index-using-pgroonga.html) to create PGroonga indexes. + +### Compatible case + +Here are steps to upgrade: + + 1. Upgrade PGroonga binary. + + 1. Upgrade PGroonga extension. + +You can upgrade PGroonga binary by package. Or you can upgrade by building new PGroonga and override old PGroonga. + +Here is a SQL that upgrades PGroonga: + +```sql +ALTER EXTENSION pgroonga UPDATE; +``` ## See also + * [`CREATE EXTENSION`](http://www.postgresql.org/docs/{{ site.postgresql_short_version }}/static/sql-createextension.html) + + * [`DROP EXTENSION`](http://www.postgresql.org/docs/{{ site.postgresql_short_version }}/static/sql-dropextension.html) + * [`ALTER EXTENSION`](http://www.postgresql.org/docs/{{ site.postgresql_short_version }}/static/sql-alterextension.html) + + * [`CREATE INDEX USING pgroonga`](../reference/create-index-using-pgroonga.html) -------------- next part -------------- HTML����������������������������...Download