アップグレード

新しいバージョンのPGroongaが非互換の変更を含んでいない場合はPGroongaのインデックスを再作成せずにアップグレードできます。新しいバージョンが1つでも非互換の変更を含んでいればPGroongaをアップグレードする際にすべてのPGroongaのインデックスを再作成する必要があります。

以下は互換性のリストです。

• 2.3.7 -> 2.3.8: 互換

• 2.3.6 -> 2.3.7: 互換

• 2.3.5 -> 2.3.6: 互換

• 2.3.4 -> 2.3.5: 互換

• 2.3.3 -> 2.3.4: 互換

• 2.3.2 -> 2.3.3: 互換

• 2.3.1 -> 2.3.2: 互換

• 2.3.0 -> 2.3.1: 互換

• 2.2.9 -> 2.3.0: 互換

• 2.2.8 -> 2.2.9: 互換

• 2.2.7 -> 2.2.8: 互換

• 2.2.6 -> 2.2.7: 互換

• 2.2.5 -> 2.2.6: 互換

  • ただし、jsonbを使ったPGroongaのインデックスがある場合は再作成する必要があります。

• 2.2.4 -> 2.2.5: 互換

• 2.2.3 -> 2.2.4: 互換

• 2.2.2 -> 2.2.3: 互換

• 2.2.1 -> 2.2.2: 互換

• 2.2.0 -> 2.2.1: 互換

• 2.1.9 -> 2.2.0: 互換

• 2.1.8 -> 2.1.9: 互換

• 2.1.7 -> 2.1.8: 互換

• 2.1.6 -> 2.1.7: 互換

• 2.1.4 -> 2.1.6: 互換

• 2.1.3 -> 2.1.4: 互換

• 2.1.2 -> 2.1.3: 互換

• 2.1.1 -> 2.1.2: 互換

• 2.1.0 -> 2.1.1: 互換

• 2.0.9 -> 2.1.0: 互換

• 2.0.8 -> 2.0.9: 互換

• 2.0.7 -> 2.0.8: 互換

• 2.0.6 -> 2.0.7: 互換

• 2.0.5 -> 2.0.6: 互換

  • ただし、timestamp (without time zone)を使ったPGroongaのインデックスがある場合は再作成する必要があります。

• 2.0.4 -> 2.0.5: 互換

• 2.0.3 -> 2.0.4: 互換

• 2.0.2 -> 2.0.3: 互換

  • ただし、timestamp (without time zone)を使ったPGroongaのインデックスがある場合は再作成する必要があります。

  • ただし、pgroonga_text_array_full_text_search_ops_v2演算子クラスを使ったPGroongaのインデックスがある場合は再作成する必要があります。

• 2.0.1 -> 2.0.2: 互換

• 2.0.0 -> 2.0.1: 互換

• 1.2.3 -> 2.0.0: 互換

• 1.2.2 -> 1.2.3: 互換

• 1.2.1 -> 1.2.2: 互換

• 1.2.0 -> 1.2.1: 互換

• 1.1.9 -> 1.2.0: 互換

• 1.1.8 -> 1.1.9: 互換

• 1.1.7 -> 1.1.8: 互換

• 1.1.6 -> 1.1.7: 互換

• 1.1.5 -> 1.1.6: 互換

• 1.1.4 -> 1.1.5: 互換

• 1.1.3 -> 1.1.4: 互換

• 1.1.2 -> 1.1.3: 互換

• 1.1.1 -> 1.1.2: 互換

• 1.1.0 -> 1.1.1: 互換

• 1.0.9 -> 1.1.0: 互換

• 1.0.8 -> 1.0.9: 互換

• 1.0.7 -> 1.0.8: 互換

• 1.0.6 -> 1.0.7: 互換

• 1.0.5 -> 1.0.6: 互換

• 1.0.4 -> 1.0.5: 互換

• 1.0.3 -> 1.0.4: 互換

• 1.0.2 -> 1.0.3: 互換

• 1.0.1 -> 1.0.2: 互換

• 1.0 -> 1.0.1: 互換

• 0.9 -> 1.0: 非互換

• 0.8 -> 0.9: 互換

• 0.7 -> 0.8: 非互換

非互換の場合

アップグレード手順は次の通りです。

1. すべてのPGroongaを使ったインデックスを削除します。

2. PGroonga拡張を削除します。

3. PGroongaのバイナリーをアップグレードします。

4. PGroonga拡張をインストールします。

5. すべてのPGroongaのインデックスを作り直します。

すべてのPGroongaのインデックスを削除して、PGroonga拡張も削除するSQLは次の通りです。

DROP EXTENSION pgroonga CASCADE;

PGroongaのバイナリーはパッケージでアップグレードできます。あるいは、新しいPGroongaをビルドして古いPGroongaに上書きすることでもアップグレードできます。

PGroonga拡張をインストールするSQLは次の通りです。

CREATE EXTENSION pgroonga;

PGroongaを使ってインデックスを作るにはCREATE INDEX USING pgroongaを使ってください。

互換性がある場合

アップグレード手順は次の通りです。

1. PGroongaを使っているすべてのデータベースへの接続を切断します。

2. PGroongaのバイナリーをアップグレードします。

3. PGroongaを使っているデータベースに接続します。

4. PGroonga拡張をアップグレードします。

PGroongaのバイナリーはパッケージでアップグレードできます。あるいは、新しいPGroongaをビルドして古いPGroongaに上書きすることでもアップグレードできます。

PGroongaをアップグレードするSQLは次の通りです。

ALTER EXTENSION pgroonga UPDATE;

もしpgroonga_databaseモジュールを使っているなら、次のSQLを実行してpgroonga_databaseモジュールをアップグレードする必要があります。

ALTER EXTENSION pgroonga_database UPDATE;

参考

• CREATE EXTENSION

• DROP EXTENSION

• ALTER EXTENSION

• CREATE INDEX USING pgroonga