rPowerGres Administrator Tool 操作マニュアル• Linux は、Linus Torvalds の米国およびその他の国における商標または登録商標です。
• その他、マニュアル中で記載している会社名、商品名は一般に各社の商標または登録商標です。なお、マニュアル中では、TM マークおよび r マークは明記していません。

目次
はじめに

3

1.1

PowerGres Administrator Tool とは . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3

1.2

構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3

1.3

動作環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3

1.4

制限事項・仕様. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3

1

2

起動方法

4

3

ログイン・ログアウト

4

3.1

ログイン . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4

3.2

ログアウト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5

設定

5

4.1

データベースクラスタ初期化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6

4.2

既存データベースクラスタの取り込み . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7

4.3

PostgreSQL 基本設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7

4.4

ネットワーク接続認証 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

8

4.5

パスワードの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11

4.6

その他の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

12

デーモン

13

5.1

起動 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

14

5.2

停止 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

14

5.3

再起動 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

14

5.4

再読み込み . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

14

5.5

デーモンログ閲覧 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

14

オブジェクトの作成・更新・削除

15

6.1

データベース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

16

6.2

ユーザ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

18

6.3

グループ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

20

バックアップ・リストア

21

7.1

バックアップ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

22

7.2

リストア . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

23

監視ツール

24

8.1

監視情報閲覧 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

24

8.2

実行中のクエリー、およびユーザ情報 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

25

4

5

6

7

8

1

8.3

データベース情報 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

26

8.4

ロック情報 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

27

8.5

テーブル・インデックスのディスク使用量情報閲覧. . . . . . . . . . . . . . . . . . . . . . .

27

便利なツール28

9.1

psql:SQL インタプリタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

28

9.2

vacuum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

29

9.3

analyze . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

30

ヘルプ

31

9

10

10.1 バージョン、ライセンスキー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

31

10.2 マニュアルリンク . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

31

11

その他

32

11.1 すでに PostgreSQL がインストール済みの場合 . . . . . . . . . . . . . . . . . . . . . . . . . .

32

11.2 ログについて . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

34

11.3 トラブルシューティング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

352

1 はじめに
1.1 PowerGres Administrator Tool とはPowerGres Administrator Tool は PowerGres on Linux を管理するためのウェブアプリケーションです。
PowerGres Administrator Tool は PowerGres on Linux をインストールすると直ちに利用できるようになっており、PowerGres on Linux の起動・停止のほか、各種設定ファイルの変更、データベースやユーザの登録・削除、VACUUM、postmaster ログの参照機能、データベース容量の確認など、PowerGres on Linux の管理が容易に行えるようになっています。

1.2 構成PowerGres Administrator Tool の構成は次のようになっています。
/opt/powergres/admin/apache

Apache Web サーバ/opt/powergres/admin/conf

設定ファイル群/opt/powergres/admin/log

データベースのバックアップログ/opt/powergres/admin/php

PHP

PowerGres Administrator Tool で利用される Apache や PHP は一般的な利用にはお勧めしません。

1.3 動作環境
PowerGres Administrator Tool は、以下の環境で動作します。
• Red Hat Enterprise Linux AS/ES 2.1/3
また、以上の環境に付属する Mozilla および Internet Explorer 6.0 で動作が確認されています。

1.4 制限事項・仕様
PowerGres Administrator Tool における制限事項・仕様は以下のとおりです。
1. PowerGres on Linux のスーパユーザが local 接続の template1 データベースに接続する際にパスワードが必要とするような設定になっている場合、管理ツールは利用できません。pg hba.conf の認証方法
を trust または ident にすればパスワードなしで接続できるようになりますが、ident 認証を使用することをお勧めします。

2. postgresql.conf などで整数を入力する項目に、2,147,483,647 を超える値を入力しても、2,147,483,647として扱われます。

3. ラージオブジェクトを含むデータベースクラスタのバックアップからのリストアでは、datconﬁg(ALTER DATABASE による設定) と datacl (GRANT ON DATABASE による設定) は復旧されません。

32 起動方法
PowerGres Administrator Tool を利用するためにはサービスが起動している必要があります。PowerGres
on Linux インストーラからインストールしていればインストーラでサービスが自動的に起動されますので、
通常サービスの起動は必要ありません。ただし、インストーラでサービスの起動に失敗している場合は、root
で次のコマンドを実行しサービスを起動します。

¨§¥# /etc/init.d/powergresadmin start¦PowerGres Administrator Tool を利用するには対応ブラウザから以下の URL にアクセスします。
http://<hostname>:<port>/<hostname> には PowerGres on Linux をインストールしたホスト名を指定します。<port> には PowerGres Administrator Tool で利用しているポートを入力します。これはインストーラで指定したポートです。例えば、PowerGres on Linux をインストールしたホスト名が powergres.example.com で、ポートとして 8080 を利用した場合は、次のようにアクセスします。

http://powergres.example.com:8080/

3 ログイン・ログアウト
3.1 ログイン

1. ユーザ名とパスワードを入力します。ここで利用するユーザ名とパスワードは PowerGres on Linux イ
ンストール時に指定したものです。なお、パスワードの変更については第 4.5 章 (11 ページ) を参照し

4

てください。

2.「PGDATA」プルダウンメニューからデータベースクラスタディレクトリを選択します。ここで選択したデータベースクラスタが管理の対象になります。なお、データベースクラスタがまだ初期化されていない場合はプルダウンメニューは空になっているので、そのまま選択せずにログインしてデータベース
クラスタを初期化してください。

3. ログインボタンをクリックします。
4. ログインに成功すると次のような管理画面に進みますが、失敗すると再度ログイン画面が表示されます。

3.2 ログアウト
1. 管理画面の右上にあるログアウトボタンをクリックします。再度ログインする場合はログイン画面でユーザ名とパスワードを入力して下さい。

4 設定
PowerGres on Linux を起動させるには、データベースのデータを格納する「データベースクラスタ」が存在している必要があります。データベースクラスタを作成したり、データベースサーバの基本設定行うには、
メインメニューから「SETTING」を選択します。

5

4.1 データベースクラスタ初期化
データベースクラスタと呼ばれる、データ格納領域を作成・初期化します。実際にデータが保存されるとても重要な領域です。

1. サブメニューから「initdb」を選択します。

2.「データベースクラスタディレクトリの絶対パス」を入力します。
3. そのデータベースの文字エンコーディングやロケールの設定を行います。日本語データベースを作成するのであれば EUC-JP、もしくは UNICODE を選択するのが一般的です。また、ロケールの利用は推奨されません。

6

4.「実行」ボタンをクリックすると、初期化が開始されます。データベースクラスタの初期化に成功すると、現在選択しているデータベースクラスタが初期化されたものになります。

4.2 既存データベースクラスタの取り込み
すでに作成済みのデータベースクラスタを PowerGres Administrator Tool に取り込むことによって、そのデータベースクラスタを PowerGres Administrator Tool で管理することができます。

1. サブメニューから「import」を選択します。
2.「既存データベースクラスタディレクトリの絶対パス」を入力します。
3.「実行」をクリックします。データベースクラスタの取り込みに成功すると、現在選択しているデータ
ベースクラスタが取り込まれたものになります。

■注意 ここで取り込むことができるデータベースクラスタのメジャーバージョン番号は、PowerGres

on Linux のベースになっている PostgreSQL と同じ 7.4 でなければなりません。なお、メジャーバー
ジョン番号はデータベースクラスタディレクトリにある PG VERSION に記述されています。
メジャーバージョン番号が異なるデータベースクラスタを取り込む方法については第 11.1.2 章 (32ページ) を参照してください。

4.3 PostgreSQL 基本設定
データベースサーバの動作パラメータなどの設定を行います。ここで設定された内容はデータベースクラス
タディレクトリにある「postgresql.conf」に書き込まれ、データベースが起動されたとき、または再読み込み要求があった場合に読み込まれます。
設定できる各項目の詳細については「PostgreSQL 日本語ドキュメント」の「III. サーバの管理 第 16 章

7

サーバ実行時環境 16.4 実行時の設定」をご覧ください。なお、管理ツールから「PostgreSQL 日本語ドキュメント」を参照することができます。詳しくは第 10.2 章をご覧ください。

1. サブメニューから「postgresql.conf」を選択します。

2. 内容の修正が完了したら、「更新」ボタンをクリックします。これによって「postgresql.conf」の更新が行われます。更新内容はすぐには反映されません。表示されるメッセージに従い、DAEMON メニューから restart や reload を実行してください。

4.4 ネットワーク接続認証
サブメニューから「pg hba.conf」を選択します。ここで設定された内容はデータベースクラスタディレク
トリにある pg hba.conf に書き込まれます。
設定の詳細につきましては、「PostgreSQL 日本語ドキュメント」の「III. サーバの管理 第 19 章 クライア
ント認証」をご覧ください。なお、管理ツールから「PostgreSQL 日本語ドキュメント」を参照することができます。詳しくは第 10.2 章をご覧ください。

8

pg hba.conf は一番上に記述された設定情報から順に評価されます。従って、一番上に記述された設定が最も優先度の高い設定となり、一番下の設定情報は最も低いものとなります。

■ヒント

PostgreSQL のスーパユーザが安全にパスワードなしですべてのデータベースに接続するためには、ident 認証を使用することをお勧めします。具体的には、以下のような設定を作成し、pg hba.conf の先頭にくるようにします。
接続

local

データベースallユーザ

postgres

IP アドレス(空白のまま)ネットマスク(空白のまま)

認証方式

ident

なお、上の例では PowerGres on Linux のスーパユーザが「postgres」になっていますが、他のユーザ
名でインストールした場合には適宜読み替えてください。

4.4.1 認証情報の追加
1. 新しい認証条件を作成する場合は「追加」ボタンをクリックします。
2.「追加」ボタンをクリックすると、接続認証情報入力画面が表示されるので、必要な情報を入力します。

9

3. 入力が完了したら、「追加」ボタンをクリックします。
4. 追加した内容がネットワーク接続認証画面が表示されるので、確認の上、「更新」ボタンをクリックします。pg hba.conf に反映されます。

4.4.2 認証情報の修正
1. 認証情報を変更するには、修正したい設定行の右にある「修正/削除」ボタンをクリックします。
2. 設定内容を修正し、「更新」ボタンをクリックします。

3. 修正した内容がネットワーク接続認証画面が表示されるので、再度確認し、「更新」ボタンをクリックします。pg hba.conf に反映されます。

10

4.4.3 認証情報の削除
1. すでにある設定を削除する場合は、削除したい設定行の右にある「修正/ 削除」ボタンをクリックします。

2. 設定内容表示の下にある「削除」ボタンをクリックしてください。

3. 削除後のネットワーク接続認証設定内容が画面で表示されるので、確認の上、「更新」ボタンをクリッ
クしてください。pg hba.conf に反映されます。

4.4.4 認証情報の優先順序変更
1. ネットワーク接続認証画面の各接続認証設定の左に矢印があります。それを使って設定を上下させることができます。

2. 設定順序が確定したら、「更新」ボタンをクリックして pg hba.conf に反映します。

4.4.5 リセットボタン「リセット」ボタンを押すことによってまだ pg hba.conf に反映されていない変更は取り消されます。ボタンを押した後は現在の pg hba.conf の設定内容が画面に表示されます。

4.5 パスワードの変更
PowerGres Administrator Tool にログインするためのスーパーユーザのパスワードを変更します。
1. サブメニューから「password」を選択します。
2.「パスワード」と「確認のためのパスワード」を入力します。
3.「実行」をクリックします。

11

4.6 その他の設定
PowerGres on Linux では、第 4.3 章 (7 ページ) で設定できる基本設定以外に PowerGres on Linux 独自の設定項目があります。

1. サブメニューから「other」を選択します。
2. 内容の修正が完了したら、「更新」ボタンをクリックします。これによって設定の更新が行われます。
更新内容はすぐには反映されません。表示されるメッセージに従い、DAEMON メニューから restartや reload を実行してください。

なお、設定できる項目には以下のものがあります。

12• データベース– システム起動時に postmaster を起動する (startup on boot)OS を起動・再起動した際に自動的に postmaster を起動するかどうかを指定します。
• ログ– rotatelogs を有効にする (rotatelogs/enable)
PowerGres on Linux では rotatelogs によってログを取得しています。それを有効にするかどうかを指定します。

– ログを格納するディレクトリ (rotatelogs/logdir)
取得したログを格納するディレクトリを指定します。デフォルトではデータベースクラスタディ
レクトリ以下の rlog です。なお、rotatelogs が有効でありながらログを格納するディレクトリにログを書き込めない場合は postmaster を起動できません。

– ログを回転させる間隔 (秒) (rotatelogs/rotationtime)
ログをファイルに切り出す間隔を指定します。デフォルトでは 8400 秒、つまり 1 日ごとにファ
イルに切り出されます。

– UTC 時間との差 (分) (rotatelogs/oﬀset)
ログを回転させる際に基準となる UTC 時間との差を指定します。
これが指定されない場合は UTC 時間が基準となります。従って、日本では UTC 時間より 9 時
間進んでいるため、ログを回転させる間隔が 1 日であれば、毎日午前 9 時にログがファイルに切り出されます。もし、午前 0 時にファイルを切り出したければ 9 時間、つまり 540 分を指定します。
デフォルトでは 540 分が指定されます。

5 デーモン
PowerGres on Linux を起動させるには、postmaster と呼ばれるデータベースデーモンを起動 (start) する
必要があります。また、データベースサーバの設定を変更したら設定ファイルの再読み込み (reload)、あるいは再起動 (restart) が必要になります。それらの作業を行うためにはメインメニューから「DAEMON」を選
択します。

13

5.1 起動
1. サブメニューにある「start」ボタンをクリックします。

5.2 停止1. サブメニューにある「stop」ボタンをクリックします。

5.3 再起動
1. サブメニューにある「restart」ボタンをクリックします。

5.4 再読み込み
1. データベース基本設定の修正を行った後など、データベースデーモンに設定内容を再読み込みさせたい
場合は、サブメニューにある「reload」ボタンをクリックします。

5.5 デーモンログ閲覧
第 4.6 章 (12 ページ) の「その他の設定」において「rotatelogs を有効にする」が有効に設定されていれば、ログは「ログを回転させる間隔 (秒)」で設定された間隔で作成され、「ログを格納するディレクトリ」で設定されたディレクトリ以下に格納されます。

1. データベースデーモンのログを参照したい場合は、サブメニューにある「log」ボタンをクリックします。

14

2. ログ参照画面が表示されますので、ログを閲覧をしたい日時をプルダウンメニューから選択し、「表示」
ボタンをクリックします。
デフォルトでは最大の 20 行までのログが一度に表示されます。20 行を超える部分のログは、「次」、「前」のボタンを押すことにより、ページをめくるように参照することができます。また、一度に表示できる行数は「1 ページあたりの表示行数」メニューで変更できます。また、「最新のログから表示する」をチェックすれば最新のログから表示できます。

■注意

古いログはデフォルトでは削除されません。ログの保存期間を設定する方法については 11.2

章 (34 ページ) を参照してください。

■注 意

ロ グ は 、第 4.6 章 (12 ペ ー ジ) の「 そ の 他 の 設 定 」に お い て「rotatelogs を 有 効 に する」が有効に設定されており、PowerGres Administrator Tool の DAEMON メニュー、もしくは/etc/init.d/powergres スクリプトを利用して起動した場合のみ取得されます。ユーザが pg ctl や

postmaster を利用して手動で起動した場合にはログの取得が行われません。

6 オブジェクトの作成・更新・削除
データベース、ユーザ、グループを簡単に作成、修正、削除できます。それらを行うためにはメインメニュー
から「OBJECT」を選択します。

15

6.1 データベース
データベースの作成・削除を行うには、サブメニューで「database」を選択します。

6.1.1 作成
1. 新しくデータベースを作成するには「作成」ボタンをクリックします。
2.「作成」ボタンをクリックすると、データベース情報入力画面が表示されるので、情報を入力します。

16

3. 入力が完了したら、「実行」ボタンをクリックします。
4. 確認ダイアログが表示されるので、「はい」をクリックします。
5. 最新のデータベース一覧が表示されます。

6.1.2 削除
1. すでにあるデータベースを削除するには、削除したいデータベースの行の右にある「削除」ボタンをク
リックします。

2. 確認ダイアログが表示されるので、「はい」をクリックします。
3. 最新のデータベース一覧が表示されます。

17

6.2 ユーザ

6.2.1 作成
1. 新しくユーザを作成するには、「作成」ボタンをクリックします。
2.「作成」ボタンをクリックすると、ユーザ情報入力画面が表示されるので、情報を入力します。

3. 入力が完了したら、「実行」ボタンをクリックします。
4. 確認ダイアログが表示されるので、「はい」をクリックします。
5. 最新のユーザ一覧が表示されます。

18

6.2.2 修正
1. ユーザ情報を修正するには、修正したいユーザの行の右にある「修正/削除」ボタンをクリックします。

2. ユーザ情報を修正し、「実行」ボタンをクリックします。
3. 最新のユーザ一覧が表示されます。

6.2.3 削除
1. ユーザを削除するには、削除したいユーザの行の右にある「修正/削除」ボタンをクリックします。
2. 確認ダイアログが表示されるので、「はい」をクリックします。
3. 最新のユーザ一覧が表示されます。

19

6.3 グループ

6.3.1 作成
1. 新しくグループを作成するには「作成」ボタンをクリックします。
2.「作成」ボタンをクリックすると、ユーザ情報入力画面が表示されるので、情報を入力します。

3. グループ名を入力し、そのグループに所属するユーザを選択し、「実行」ボタンをクリックします。
4. 確認ダイアログが表示されるので、「はい」をクリックします。
5. 最新のユーザ一覧が表示されます。

20

6.3.2 修正
1. すでに存在するグループの所属ユーザを修正するには、修正したいグループの行の右にある「修正」ボタンをクリックします。

2. グループ情報を修正し、追加する場合は「追加」ボタンを、削除する場合は「削除」ボタンをクリックします。

3. 確認ダイアログが表示されますので、「はい」をクリックします。
4. 最新のグループ一覧が表示されます。

6.3.3 削除
1. すでにあるグループを削除する場合は、削除したいグループの行の右にある「削除」ボタンをクリックします。

2. 確認ダイアログが表示されるので、「はい」をクリックします。
3. 最新のグループ一覧が表示されます。

7 バックアップ・リストア
データベースクラスタ全体やデータベース単位でのバックアップ、リストアを行います。それらを行うためにはメインメニューから「BACKUP」を選択します。

21

7.1 バックアップ

1. サブメニューにある「backup」をクリックします。
2. バックアップを取る形式を選択します。
3. データベース単位でバックアップを取る場合は、バックアップするデータベース名を選択します。ラー
ジオブジェクトもバックアップをする場合は、「ラージオブジェクトあり」を選択します。

4. バックアップファイルを置くディレクトリを「バックアップディレクトリ」に入力します。ここで指定するバックアップディレクトリは、すでに存在していて、ディレクトリ内にディレクトリやファイルが存在していないことが条件になります。

5. 設定ファイル (postgresql.conf、pg hba.conf、pg ident.conf) をバックアップする場合は「設定ファイルをバックアップする」をチェックします。

6. 対象データベースにパスワードが設定されている場合は、パスワードを入力し、「実行」ボタンをクリッ
クします。

7. オプション指定画面が表示されるので、オプションを指定し、「実行」ボタンをクリックします。
8. 確認ダイアログが表示されるので、「はい」をクリックします。
9. バックアップ中は「. . . 」が表示されますのでそのままお待ちください。この間にブラウザの中断ボタンを押したり、他のページに移動したりするとバックアップ処理が中断してしまいますので、必ずバッ
クアップが終了するまでお待ちください。

10. バックアップが完了すると「バックアップ終了しました」と表示されます。

22

■注意

データベースクラスタ全体のバックアップを行う際には、「接続パスワード」の入力は必要あ

りませんが、PostgreSQL のスーパユーザがパスワードなしですべてのデータベースに接続できる設定になっている必要があります。もしもパスワードが必要な場合は、エラーが発生します。PostgreSQLのスーパユーザが安全にパスワードなしでデータベースに接続できるようにするには、ident 認証を使用することをお勧めします。ident 認証を使用する方法については、第 4.4 章 (8 ページ) を参照してください。

7.2 リストア

1. サブメニューにある「restore」をクリックします。
2. PowerGres Administrator Tool のバックアップから取得したバックアップディレクトリを絶対パスで指定します。

3. バックアップした設定ファイルをリストアする場合は「設定ファイルをリストアする」をチェックします。

4. パスワードが設定されている場合は、パスワードを入力し、「実行」ボタンをクリックします。
5. リストア対象がデータベース単位の場合は、リストアするデータベースを選択し、オプションの指定を行います。

6. 確認ダイアログが表示されるので、「はい」をクリックします。
7. リストア中は「. . . 」が表示されますのでそのままお待ちください。この間にブラウザの中断ボタンを押したり、他のページに移動したりするとリストア処理が中断してしまいますので、必ずリストアが終了するまでお待ちください。

8. リストアが完了すると「リストア終了しました」と表示されます。

23

■注意

データベースクラスタ全体のリストアを行う際には、「接続パスワード」の入力は必要ありま

せんが、PostgreSQL のスーパユーザがパスワードなしですべてのデータベースに接続できる設定になっている必要があります。もしもパスワードが必要な場合は、エラーが発生します。initdb 直後の状態ではすべてのローカルユーザがパスワードなしですべてのデータベースに接続できるようになっていますが、パスワードを設定する場合は、ident 認証を使用することをお勧めします。ident 認証を使用する方法については、第 4.4 章 (8 ページ) を参照してください。

8 監視ツール
テーブル、インデックス、シーケンス、データベースの状況、実行中の問い合わせ、ディスク使用量などを閲覧することができます。それらの情報を閲覧するにはメインメニューの「WATCH」から参照します。

8.1 監視情報閲覧
指定したデータベースの、指定したオブジェクト情報を閲覧できます。

1. サブメニューにある「object」ボタンをクリックします。

24

2. 閲覧したいデータベース、オブジェクトを選択します。
3. パスワードが設定されている場合は、パスワードを入力し、「表示」ボタンをクリックします。
4. 実行時の状況が表示されます。
■ヒント

この機能を有効にするには、postgresql.conf の stats start collector (統計情報収集のサブプロセスを起動する)、stats row level (行レベルのアクセス情報を統計情報収集プロセスに送る)、stats block level (ブロックレベルのアクセス情報を統計情報収集プロセスに送る) を有効にしておく必要があります。具体的な方法は、第 4.3 章 (7 ページ) を参照してください。

8.2 実行中のクエリー、およびユーザ情報
実行中の問い合わせ、およびそのユーザ情報を閲覧できます。

1. サブメニューにある「activity」ボタンをクリックします。
2. 現在実行中の問い合わせとその問い合わせを実行しているユーザ情報が表示されます。

25

■ヒント

この機能を有効にするには、postgresql.conf の stats start collector (統計情報収集のサブプロセスを起動する)、stats command string (実行中のコマンドを統計情報収集プロセスに送る) を有効にしておく必要があります。具体的な方法は、第 4.3 章 (7 ページ) を参照してください。

8.3 データベース情報
各データベースのバックエンド数やコミット回数などが閲覧できます。

1. サブメニューにある「database」ボタンをクリックします。
2. 各データベースのバックエンド数やコミット数、ロールバック回数などが表示されます。

26

■ヒント

この機能を有効にするには、postgresql.conf の stats start collector (統計情報収集のサブプロセスを起動する)、stats row level (行レベルのアクセス情報を統計情報収集プロセスに送る)、stats block level (ブロックレベルのアクセス情報を統計情報収集プロセスに送る) を有効にしておく必要があります。具体的な方法は、第 4.3 章 (7 ページ) を参照してください。

8.4 ロック情報
現在、テーブルにかかっているロック情報を表示できます。

1. サブメニューにある「lock」ボタンをクリックします。
2. 現在のロック情報が表示されます。

8.5 テーブル・インデックスのディスク使用量情報閲覧
指定したデータベースのテーブルやインデックスのディスク使用量情報が閲覧できます。

1. サブメニューにある「usage」ボタンをクリックします。

27

2. ディスク使用量を閲覧したいデータベースを選択します。
3. パスワードが設定されている場合は、パスワードを入力し、「表示」ボタンをクリックします。
■ヒント表示される情報は最後に VACUUM または ANALYZE を実行した時点のものです。最新の情報を得るためには、VACUUM または ANALYZE を実行してください。具体的な方法は、第 9.2
章 (29 ページ) を参照してください。

9 便利なツール
クエリの実行、ゴミ領域の回収と解析、統計情報の更新ができます。それらを行うためにはメインメニュー
から「OTHER」を選択します。

9.1 psql:SQL インタプリタ
指定したデータベースに対し、クエリーを実行できます。

1. サブメニューにある「psql」ボタンをクリックします。

28

2. クエリーを実行するデータベースを選択します。
3. 対象データベースにパスワードが設定されている場合は、パスワードを入力し、「実行」ボタンをクリックします。

4. 実行したいクエリーを入力します。
5. 確認ダイアログが表示されますので、クエリーを実行する場合は「はい」をクリックします。
6. 実行結果が表示されます。

9.2 vacuum
ゴミ領域を再利用可能にしたり、物理的にサイズを小さくします。定期的に VACUUM を行うことによって、パフォーマンスを維持することができます。なお、詳細については、「PostgreSQL 日本語ドキュメント」の「VI. リファレンス II. PostgreSQL クライアントアプリケーション」の「vacuumdb」をご覧ください。
なお、管理ツールから「PostgreSQL 日本語ドキュメント」を参照することができます。詳しくは第 10.2 章
をご覧ください。

1. サブメニューにある「vacuum」ボタンをクリックします。

29

2. vacuum を実行するデータベースを選択します。
3. 対象データベースにパスワードが設定されている場合は、パスワードを入力し、オプションを指定したら「実行」ボタンをクリックします。

4. 確認ダイアログが表示されますので、vacuum を実行する場合は「はい」をクリックします。
5. 実行結果が表示されます。

9.3 analyze
統計情報を更新します。

1. サブメニューにある「analyze」ボタンをクリックします。

30

2. analyze を実行するデータベースを選択します。
3. 対象データベースにパスワードが設定されている場合は、パスワードを入力し、オプションを指定したら「実行」ボタンをクリックします。

4. 確認ダイアログが表示されますので、analyze を実行する場合は「はい」をクリックします。
5. 実行結果が表示されます。

10 ヘルプPowerGres on Linux のバージョン、ライセンスキーの表示、「PostgreSQL 7.4.3 日本語ドキュメント」の参照ができます。それらを行うためにはメインメニューから「HELP」を選択します。

10.1 バージョン、ライセンスキー
1. サブメニューにある「info」ボタンをクリックします。
2. バージョン、ライセンスキーが表示されます。

10.2 マニュアルリンク
1. サブメニューにある「manual」ボタンをクリックします。
2.「PostgreSQL 日本語ドキュメント」へのリンクが表示されます。

31

11 その他
11.1 すでに PostgreSQL がインストール済みの場合
すでに PostgreSQL がインストール済みの場合、そのデータベースを PowerGres Administrator Tool の管理下に移行することができます。PostgreSQL のメジャーバージョン番号 (バージョン番号の最初の 2 つの数字) によって方法が異なります。

11.1.1 PostgreSQL 7.4.x がインストール済みの場合
すでに PostgreSQL 7.4.x がインストール済みの場合そのデータベースをそのまま PowerGres Administra-

tor Tool の管理下に移行することができます。詳細については第 4.2 章 (7 ページ) をご覧ください。
■注意

ソースや RPM から入れた PostgreSQL を PowerGres Administrator Tool で管理すると、PowerGres Administrator Tool の一部の機能が使えなくなったり、不具合を起こす可能性があります。必ず PowerGres on Linux をお使いください。

11.1.2 PostgreSQL 7.4.x 以外のバージョンがインストール済みの場合
既存のデータベースの pg dumpall などでバックアップを取得し、それを PowerGres on Linux に付属するpsql や pg restore でリストアする必要があります。
■注意

この方法により、既存のデータベースクラスタを PowerGres Administrator Tool の管理下に移行した場合、弊社はその結果を保証するものではありません。PostgreSQL のバグにより一部のデータが移行できないなどの障害が起きる可能性があります。

1. 現在使用中の PostgreSQL に付属する pg dumpall を使ってバックアップを取得します。ここでは取得したファイルは仮に/tmp/db.dump に置いたとします。

2. 現在使用中の PostgreSQL を停止します。
3. PowerGres Administrator Tool をインストールします。その際、スーパユーザは必ず現在使用中のPostgreSQL のスーパユーザと同じユーザにしてください。
4. PowerGres Administrator Tool の SETTING メニューから「initdb」を選択し、データベースクラス
タを作成します。

5. データベースのスーパユーザでログインします。
6. /tmp/db.dump から新しいデータベースクラスタにデータを復元します。
¨§$ /opt/powergres/bin/psql -f /tmp/db.dump template1¥¦

7. PowerGres Administrator Tool の DAEMON メニューから「start」を選択し、postmaster を起動します。

32

11.1.3 PostgreSQL 7.3.x と 7.4.x での postgresql.conf の違い
PowerGres on Linux 1.0.x から 2.0.x にアップグレードする場合、または PostgreSQL 7.3.x から PowerGres on Linux 2.0.x に移行する場合、データベースクラスタのみでなく、必要であれば設定ファイル(postgresql.conf、pg hba.conf、pg ident.conf など) を移行します。
しかし、PowerGres on Linux 2.0.x は PostgreSQL 7.4.x をベースとしているため、PowerGres on Linux

1.0.x (PostgreSQL 7.3.x) とはメジャーバージョンが異なります。従って、そのまま設定ファイルをコピーするのみでは移行できません。
とくに postgresql.conf には追加・削除されたパラメータ、名前が変更されたパラメータなどが存在するた
め、移行については注意する必要があります。ここでは PostgreSQL 7.3.x と 7.4.x での postgresql.conf の違いについて説明します。

• 追加されたパラメータ– add missing from (FROM に指定されていないテーブルの自動追加)– check function bodies (CREATE FUNCTION における関数本体の検証)– checkpoint warning (チェックポイントセグメント溢れに対する警告秒数)– default transaction read only (初期トランザクション隔離レベル)– enable hashagg (ハッシュ集約を有効にする)– from collapse limit (副問い合わせを上位問い合わせにマージする FROM リスト数)– join collapse limit (内部 JOIN を FROM リストに修正するリスト数)– log error verbosity (出力するログの詳細さ)– log min duration statement (指定時間以上の実行時間のかかるステートメントのログ出力)– preload libraries (サーバ起動時に読み込む共有ライブラリ)– regex ﬂavor (正規表現の種類)– rendezvous name (Rendezvous ブロードキャスト名)• 削除されたパラメータ– autocommit (オートコミットを有効にする)– geqo random seed (geqo 乱数 seed)• 名前が変更されたパラメータ
PostgreSQL 7.3.x

7.4.x

hostname lookup

log hostname (ホスト名を表示する)

server min messageslog min messages (サーバログに記録する最低ログレベル)

show executor stats

log executor stats (エグゼキュータの統計情報を記録する)

show parser statslog parser stats (パーサの統計情報を記録する)

show planner statslog planner stats (プランナの統計情報を記録する)

show source port

log source port (接続元のポート番号を表示する)

show statement stats

log statement stats (問い合わせの統計情報を記録する)• デフォルト値が変更されたパラメータ33

PostgreSQL 7.3.x

7.4.x

datestyle (日付出力形式)*1’iso, us’’iso, mdy’

max connections (最大接続ユーザ数)

32

100

max fsm pages (共有フリースペース内の最大ディスクページ数)

10000

20000

shared buﬀers (共有メモリバッファ数)

64

1000

• PowerGres on Linux によってデフォルト値と異なる初期値が設定されるパラメータ*2
デフォルト値

初期値

eﬀective cache size (有効ディスクキャッシュサイズ)1000

100000log pid (ログにプロセス ID を表示する)

false

true

log timestamp (ログにタイムスタンプを設定する)

false

true

max connections (最大接続ユーザ数)

100

128

max ﬁles per process (各サーバプロセスで開ける最大ファイル数)

1000

50

max fsm pages (共有フリースペース内の最大ディスクページ数)

20000

100000shared buﬀers (共有メモリバッファ数)

1000

4096

wal sync method (同期書き込み実行方法)’fsync’’open sync’

11.2 ログについて
PostgreSQL の実行時に出力されるメッセージは、第 4.6 章 (12 ページ) の「その他の設定」において「rotatelogs を有効にする」が有効に設定されていれば、「ログを格納するディレクトリ」で設定されたディレク
トリ以下に「log.%Y%m%d%H%M%S」という名前で「ログを回転させる間隔 (秒)」で設定された間隔ごとに保存されており、トラブルが起きたときの原因解析などに使用することができます。「%Y%m%d%H%M%S」
は以下のような意味を持っています。

%Y

年 (1970〜)%m

月 (01〜12)%d

日 (01〜31)%H

時 (00〜23)%M

分 (00〜59)%S

秒 (00〜61)

例えば、ログの開始日時が 2004 年 6 月 13 日 16 時 58 分 17 秒であれば「20040613165817」のような数字になります。

PowerGres Administrator Tool では、デフォルトではすべてのログファイルが保存されます。不要になった古いログを削除するためには、Linux に標準で備わっているコマンド cron と ﬁnd を利用します。たとえば、30 日よりも古いログを削除するコマンドは以下のようになります。

*1 datestyle(日付出力形式) のデフォルト値は変更されていますが、’ iso, us’ と’iso, mdy’ という値そのものは同じことを意味しています。
*2 初期値は PowerGres on Linux 1.0.x と 2.0.x では変更されていません。

34

¨
§

¥
# find /var/lib/pgsql/data/rlog -mtime +30 -print | xargs /bin/rm -f¦

なお、上記の例ではログを格納するディレクトリが/var/lib/pgsql/data/rlog になっていますが、他のディレクトリを設定した場合には適宜読み替えてください。
また、このコマンドを cron に登録することにより、自動的に 30 日よりも古いログを削除できるようになります。cron に登録するには、PowerGres on Linux のスーパユーザでログインして以下のコマンドを実行して
ください。

¨
§

¥
# crontab -e¦

コマンドを実行するとエディタ (デフォルトでは vi) が立ち上がるので、以下の内容を入力します。

¨§¥
0 3 * * * find /var/lib/pgsql/data/rlog -mtime +30 -print | xargs /bin/rm -f¦

この設定により、毎日深夜 3 時にログの削除処理が行われるようになります。crontab の詳細については、

man コマンドで crontab (1) と crontab (5) をご覧ください。

11.3 トラブルシューティング•「データベースに接続できませんでした」と表示される
まず postmaster が起動していないことが考えられるので、DAEMON メニューで postmaster の起動状況を確認してください。postmaster が起動していない場合は、起動してみてください。それでも起動されない場合は、postgresql.conf などの設定ファイルの内容が正しくない可能性があります。

DAEMON メニューの「ログ」から postmaster のログを確認してください。
次に、PowerGres on Linux のスーパユーザがパスワードなしでデータベースに接続できる設定になっていない可能性があります。pg hba.conf に以下のエントリのいずれかがあることを確認してくだ
さい。

¨
§
¨
§

¥
local all postgres trust¦¥

local all postgres ident sameuser¦

なお、上記の例では PowerGres on Linux のスーパユーザが「postgres」になっていますが、他のユーザ名でインストールした場合には適宜読み替えてください。
また、pg hba.conf の設定を誤ると、スーパユーザもデータベースに接続できなくなります。こうなると、pg hba.conf を修正しても、DAEMON メニューから「reload」や「restart」ができな
くなります。この場合は、PowerGres on Linux のスーパユーザでサーバマシンにログインして/opt/powergres/bin/pg ctl コマンドで直接 reload を行ってください。

35