PowerGres 6.x へのデータ移行の説明

目次

• はじめに
• 動作環境
• データ移行ツールの使い方
  • PowerGres 旧バージョンの設定
  • PowerGres 6.x の設定
  • その他の設定
  • 注意点・制限事項
• ツールを使わずにデータ移行する場合
  • PowerGres 旧バージョン上での操作
  • PowerGres 6.x 上での操作
  • postgresql.conf の変更
  • pg_hba.conf の変更

はじめに

PowerGres 6.x は PostgreSQL 8.3 系をベースとしています。そのため、

• PostgreSQL 7.3 系をベースとしている PowerGres 1.x
• PostgreSQL 7.4 系をベースとしている PowerGres 2.x
• PostgreSQL 8.0 系をベースとしている PowerGres 3.x
• PostgreSQL 8.2 系をベースとしている PowerGres 5.x

のデータベースクラスタ(以下、データ)は、 いずれもそのままでは利用することができません。 そこで、PowerGres 1.x, 2.x, 3.x, 5.x から 6.x へのデータ移行を支援するツール (pg_shiftdata.exe) を同梱しました。

この文書は、主にデータ移行ツールの使い方を解説します。 また、移行ツールを使わずに、手動でデータを移行する方法についても解説します。

動作環境

このツールを利用するためには、あらかじめ

• PowerGres 1.x, 2.x, 3.x, 5.x (旧バージョン) のいずれか
• PowerGres 6.x

をそれぞれインストールしておく必要があります。また、Windows XP 上で PowerGres をご利用のお客様は　.NET Framework ランタイム ライブラリ日本語版を別途インストールしておく必要があります。.NET Framework ランタイムライブラリは、PowerGres に同梱されているもの、もしくは、 Microsoft 社から Windows Update によってダウンロードして インストールすることができます。

データ移行ツールは、移行元のデータ領域を削除せず、新しくデータ領域を作成するため、 新しいデータ領域のディスク容量が必要になります。また、移行中にダンプファイルを作成するため、 最大、移行元のディスク容量の 2 倍のディスク容量が必要になります。

データ移行ツールの使い方

PowerGres 6.x をインストールしますと、Windows のメニューに「PowerGres 6」が作成され、「データ移行ツール」がメニューに表示されます。

メニュー

「データ移行ツール」をクリックしますと、データ移行ツールが起動され、 以下のウィンドウが表示されます。

移行ツールのメインウィンドウ

PowerGres 旧バージョンの設定

データベースフォルダの位置

PowerGres 旧バージョンのデータベースを格納しているデータベース フォルダを指定します。

ポート番号

一時的に postmaster を立ち上げる際に使用するポート番号を使用します。 他のアプリケーションで使っているポート番号は使用しないでください。 デフォルトは 5432 番です。

ユーザ名

スーパーユーザを指定します。デフォルトは postgres となります。

パスワード

スーパーユーザのパスワードを指定します。

PowerGres 6.x の設定

データベースフォルダの位置

新しく作成する PowerGres 6.x 向けのデータベースフォルダを指定します。 存在しないフォルダを指定した場合は、新しくフォルダを作成します。

ポート番号

一時的に postmaster を立ち上げる際に使用するポート番号を使用します。 他のアプリケーションで使っているポート番号は使用しないでください。 デフォルトは 5433 番です。また、PowerGre 旧バージョンのポート番号とは 別の番号を使用してください。

ユーザ名

スーパーユーザ名は、 PowerGres 旧バージョンのスーパーユーザ名を引き継ぎます。 入力することはできません。

パスワード

スーパーユーザのパスワードは、PowerGres 旧バージョンのパスワードを 引き継ぎます。入力することはできません。

その他の設定

pg_hba.conf のコピー

pg_hba.conf ファイル(ネットワーク接続設定認証ファイル)のコピーを 行います。チェックを付けていない場合、 pg_hba.conf は自動生成されるデフォルトのものになります。

postgresql.conf のコピー

postgresql.conf ファイル(データベース基本設定ファイル)は PowerGres 旧バージョンと 6.x では、いくつか変数名が異なったりしているため、 そのまま使うことができません。このツールでは、 PowerGres 旧バージョンの古いパラメータ名を 6.x 向けの新しい変数名に 変更するようにしていますが、いくつかの注意点・制限事項 (後述) があります。

チェックを付けていない場合、postgresql.conf は 自動生成されるデフォルトのものになります。

作業領域フォルダの位置

作業領域フォルダとは、 pg_dump でデータベースをダンプしたファイルを一時的に置くためのフォルダです。 存在しないフォルダを指定した場合、エラーとなります。 デフォルトの値は実行するユーザの環境変数 "TEMP" の値(通常は "\Documents and Settings\ユーザ名\Local Settings\Temp")となります。

ツールを実行する

各種設定項目を設定し、「実行」をクリックするとデータの移行が始まります。 なお、データ移行ツールを使用する際には postmaster を停止しておく必要があります。

「実行」をクリックするとプログレスバーが表示され、 進行状況を把握することができます。

進行状況を表すプログレスバー

万が一、データ移行をしている途中でエラーが発生した場合は、 次のようなダイアログを表示し、 6.x のデータベースディレクトリを削除します。 また、「中止」ボタンをクリックした場合も同様です。

エラーダイアログ

また、「詳細を表示」ボタンをクリックすることにより、 どのようなエラーが発生したか表示されます。

エラーメッセージの表示

プログレスバーが最後まで進み、プログレスバーが閉じるとダンプが終了となります。 PowerGres 6.x のデータベースフォルダの位置に新しくデータが作成されたので、

pg_ctl -D "6.x データベースフォルダ" start

もしくは、6.x の PowerGres Manager から postmaster を起動することができ ます。このデータ移行ツールでは PowerGres 旧バージョンのデータベース フォルダは削除せず残ります。

注意点・制限事項

• Windows Server 2003、および Windows Server 2008 では正しく動作しないため、「ツールを使わずにデータ移行する場合」の手順に従ってデータを移行してください。
• pg_hba.conf のコピーにチェックを付けた場合、移行ツールでは以下の行を 追加します。IPv6 を使って localhost に接続する際に、他の認証方法を使用したい 場合には trust を md5 等の別の認証方法に手動で変更してください。

   host   all    all    ::1/128    trust
  

• postgresql.conf の次のパラメータは、PowerGres 旧バージョンの設定値より 6.x の初期値が大きい場合、6.x の初期値になります。
  • max_connections
  • superuser_reserved_connections
  • shared_buffers
  • work_mem (sort_mem)
  • maintenance_work_mem (vacuum_mem)
  • max_fsm_pages
  • max_files_per_process
  • effective_cache_size

• postgresql.conf の次のパラメータは、PowerGres 旧バージョンの設定が 初期値のまま変更されていない場合、6.x の初期値になります。
  • cpu_index_tuple_cost
  • geqo_effort
  • geqo_threshold

• postgresql.conf の次のパラメータは、PowerGres 旧バージョンの設定を 引き継ぎません。
  • max_expr_depth
  • show_source_port (log_source_port)
  • bgwriter_maxpages
  • bgwriter_percent

• 旧バージョンの データベース内に所有者がスーパーユーザ(DB作成権限、 ユーザ作成権限のあるユーザ)でないスキーマがある場合に移行に失敗します。 一時的にユーザの権限をスーパーユーザにするなどしてから移行ツールを ご使用ください。

これらの項目は、一度ご確認されることをお勧めします。

ツールを使わずにデータ移行する場合

データ移行ツールを使わずに、データ移行する手順を説明します。この場合も

• PowerGres 1.x, 2.x, 3.x, 5.x (旧バージョン) のいずれか
• PowerGres 6.x

がそれぞれインストールされている必要があります。

以下に説明するコマンドは PowerGres 6.x のものを使います。 以下のように環境変数PATH に PowerGres 6.x の実行ファイルのあるディレクトリ (例えば "C:\Program Files\PowerGres6\bin") を設定した後に実行するものとします。

set PATH=%PATH%;C:\Program Files\PowerGres6\bin

PowerGres 旧バージョン上での操作

PowerGres 旧バージョン上にあるデータをダンプします。ダンプするデータは、 データベースユーザなどのグローバルデータとテーブルに格納されているデータがあります。 ダンプする前にあらかじめ、PowerGres 旧バージョンの postmaster (サービス)を起動しておく必要があります。

ラージオブジェクトを格納しているテーブルが存在しない場合は、pg_dumpall コマンドをご利用していただけることによって、全データを一括してダンプする ことができます。DOS コマンドを起動し、次のコマンドを入力します。

pg_dumpall -h localhost -U postgres -p ポート番号 > ダンプファイル

ラージオブジェクトを含むテーブルが存在する場合、pg_dumpall コマンドでは、 ラージオブジェクトをダンプすることができませんので、pg_dump コマンドを 併用して、グローバルデータと各データベースをそれぞれダンプします。 グローバルデータをダンプするには、以下のようにコマンドを入力します。

pg_dumpall -h localhost -U postgres -p ポート番号 -g > ダンプファイル

次に、template0 と template1 以外のデータベースをダンプします。 次のコマンドを各データベースに対して実行します。

pg_dump -h localhost -U postgres -p ポート番号 -F c -b データベース名 > ダンプファイル

PowerGres 6.x 上での操作

あらかじめ initdb を実行し、データベースフォルダを作成します。そして、 postmaster を立ち上げて、ダンプしたファイルをリストアしていきます。

ダンプ同様、リストア時も、ラージオブジェクトを含むテーブルが 存在するかどうかで手順が異なります。

ラージオブジェクトを含むテーブルが存在しない場合は、pg_dumpall でダンプしたファイルを psql コマンドを使ってリストアします。

psql -h localhost -U postgres -p ポート番号 -f ダンプファイル template1

ラージオブジェクトを含むテーブルが存在する場合は、 まずグローバルデータをリストアします。以下のコマンドを実行します。

psql -h localhost -U postgres -p ポート番号 -f ダンプファイル template1

次に、各データベースを pg_restore コマンドでリストアしていきます。

pg_restore -h localhost -U postgres -p ポート番号 -C -d template1 ダンプファイル

postgresql.conf の変更

いくつかの変数名が変更になっているもの、無くなったものがありますので、 設定内容の確認が必要です。

PowerGres 6.x への移行時に、変数名/変数値の変更が必要なもの：

「←」は「左に同じ」を意味します。 「*」印の付いたものは、設定値の意味が変更されています。 変更内容についての詳細は、「PostgreSQL 8.3 日本語マニュアル」の 「第 18 章 サーバの構成」をご参照ください。

古い変数をそのまま利用されますと、postmaster が正常に起動されません。 initdb で自動生成された postgresql.conf をエディタ(メモ帳等)で編集する際に、 上記変数を置き換えてください。

pg_hba.conf の変更

6.x の initdb で自動生成された pg_hba.conf に、今まで利用していた pg_hba.conf の内容をエディタで追加してください。