この記事では pgAdmin 4 の概要、インストールおよび起動・アクセス、DB サーバ登録の手順を説明します。

pgAdmin 4 とは

pgAdmin 4 は pgAdmin Development Team によって開発され、PostgreSQL と同じく PostgreSQL ライセンス で公開されています。Linux や Windows、macOS 上で動作し、PostgreSQL 10 以降に対応しています。PowerGres など、PostgreSQL ベースのデータベースでも利用できます。

pgAdmin 4 のおもな機能は以下のとおりです。

• SQL 実行機能
• データグリッド表示・編集機能
• 実行計画グラフィカル表示機能
• アクセス権限対話型設定機能
• 手続き言語 PL/pgSQL デバッグ機能
• スキーマ差分管理機能
• 自動 VACUUM 管理機能
• 監視ダッシュボード機能
• メンテナンス実行機能
• ジョブスケジュール実行機能
• データベースオブジェクト管理機能

pgAdmin 4 の名前についている 4 は pgAdmin の 4 世代目を表します。単にpgAdmin と書いてある場合は、1 世代前の pgAdmin III (3) を指している場合もあるので、注意してください。バージョン番号は 4 とは別についています。最新バージョンは 2022 年 1 月時点で 6.3 で、名前を含めて書くと pgAdmin 4 v6.3 になります。

pgAdmin 4 には 2 つのモードがあります。デスクトップモードはユーザが pgAdmin 4 を起動し、利用するモードです。それに対して、サーバモードは pgAdmin 4 を Web アプリケーションとして起動しておき、ユーザが Web ブラウザでログインし、利用するモードです。サーバモードは Web モードとも呼ばれます。

pgAdmin 4 のインストール

pgAdmin 4 のソースコードや各プラットフォーム向けのバイナリは ダウンロードページ で入手できます。ここでは Red Hat 系 Linux と Windows へのインストール手順を説明します。

Red Hat 系 Linux へのインストール

pgAdmin 4 は Red Hat 系 Linux として RHEL/CentOS 7 および 8、Rocky Linux 8、Fedora 33 および34 に対応しています。

Red Hat 系 Linux へのインストール手順は以下のとおりです。

1. PostgreSQL のリポジトリをインストールしている場合は、インストール対象から pgAdmin を外します。リポジトリの設定ファイルは /etc/yum.repos.d ディレクトリに格納されていて、ファイル名は RHEL/CentOS/Rocky Linux の場合は pgdg-redhat-all.repo、Fedora の場合は pgdg-fedora-all.repo です。ファイルを編集し、[pgdg-common] セクションに exclude=pgadmin* の行を追加します。

   [pgdg-common]
   name=PostgreSQL common RPMs for RHEL/CentOS $releasever - $basearch
   baseurl=https://download.postgresql.org/pub/repos/yum/common/redhat/rhel-$releasever-$basearch
   enabled=1
   gpgcheck=1
   gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-PGDG
   repo_gpgcheck = 1
   exclude=pgadmin*
   

   この設定を行っておかないと、リポジトリのインストール後に pgAdmin 4 をインストールしようとしても、なぜかリポジトリをインストールしようとし、リポジトリがインストール済みで、インストールが進まない状態になってしまいます。

   (以下、例示のため、実行しない)
   $ sudo yum -y install pgadmin4
   Last metadata expiration check: 0:00:27 ago on 2021年12月29日 04時02分58秒.
   Package pgadmin4-redhat-repo-0.9-2.noarch is already installed.
   Dependencies resolved.
   Nothing to do.
   Complete!
   

2. pgAdmin 4 のリポジトリをインストールします。リポジトリの URL は OS によって異なり、新しいバージョンがリリースされている場合もあるので、RPM 向けダウンロードページ を確認してください。以下は RHEL/CentOS/Rocky Linux の場合です。

   $ sudo yum -y install https://ftp.postgresql.org/pub/pgadmin/pgadmin4/yum/pgadmin4-redhat-repo-2-1.noarch.rpm
   (省略)
   Installed:
     pgadmin4-redhat-repo-2-1.noarch
   
   Complete!
   

3. pgAdmin 4 をインストールします。何をインストールするかによってパッケージが異なります。デスクトップモードのみの場合は pgadmin4-desktop、サーバモードのみの場合は pgadmin4-web、両方ともの場合は pgadmin4 です。ここでは両方ともインストールします。

   $ sudo yum -y install pgadmin4
   (省略)
   Installed:
     apr-1.6.3-12.el8.x86_64
     apr-util-1.6.1-6.el8.x86_64
     apr-util-bdb-1.6.1-6.el8.x86_64
     apr-util-openssl-1.6.1-6.el8.x86_64
     centos-logos-httpd-85.8-2.el8.noarch
     httpd-2.4.37-43.module_el8.5.0+1022+b541f3b1.x86_64
     httpd-filesystem-2.4.37-43.module_el8.5.0+1022+b541f3b1.noarch
     httpd-tools-2.4.37-43.module_el8.5.0+1022+b541f3b1.x86_64
     libatomic-8.5.0-4.el8_5.x86_64
     mailcap-2.1.48-3.el8.noarch
     mod_http2-1.15.7-3.module_el8.4.0+778+c970deab.x86_64
     pgadmin4-6.3-1.el8.noarch
     pgadmin4-desktop-6.3-1.el8.x86_64
     pgadmin4-server-6.3-1.el8.x86_64
     pgadmin4-web-6.3-1.el8.noarch
     python3-mod_wsgi-4.6.4-4.el8.x86_64
     xdg-utils-1.1.2-5.el8.noarch
   
   Complete!
   

   これで Red Hat 系 Linux へのインストールは完了です。

4. サーバモードをインストールした場合は、セットアップスクリプトを実行します。スクリプトでは semanage コマンドで SELinux の設定を行うので、コマンドがない場合はインストールしておきます。パッケージは RHEL/CentOS 7 の場合は policycoreutils-python、それ以外の場合は policycoreutils-python-utils です。スクリプトの途中で pgAdmin 4 のログインに使用する Email アドレス、パスワードの入力が求められるので、入力します。また、Web サーバが起動していない場合は、サービスを有効にし、起動するかの確認が求められるので、そうする場合は y、そうしない場合は n を入力します。ここでは y を入力します。

   $ sudo /usr/pgadmin4/bin/setup-web.sh
   Setting up pgAdmin 4 in web mode on a Redhat based platform...
   Creating configuration database...
   NOTE: Configuring authentication for SERVER mode.
   
   Enter the email address and password to use for the initial pgAdmin user account:
   
   Email address: (Email アドレスを入力)
   Password: (パスワードを入力)
   Retype password: (パスワードをもう一度入力)
   pgAdmin 4 - Application Initialisation
   ======================================
   
   Creating storage and log directories...
   Configuring SELinux...
   The Apache web server is not running. We can enable and start the web server for you to finish pgAdmin 4 installation. Continue (y/n)? y
   Created symlink from /etc/systemd/system/multi-user.target.wants/httpd.service → /usr/lib/systemd/system/httpd.service.
   Apache successfully enabled.
   Apache successfully started.
   You can now start using pgAdmin 4 in web mode at http://127.0.0.1/pgadmin4
   

Windows へのインストール

pgAdmin 4 は Windows として Windows 8 以降および Windows Server 2012 以降に対応しています。

pgAdmin 4 は、Windows では PostgreSQL に付属しているので、PostgreSQL のインストール時にチェックを外さなければ、インストールされています。バージョンは PostgreSQL リリース時の最新ですが、その後、アップデートされないので、少し古い場合があります。PostgreSQL 14.1 に付属の pgAdmin 4 はバージョン 6.1 で、6.3 の 2 つ前のバージョンです。

pgAdmin 4 は PostgreSQL とは別に単体でもインストールできます。Windows へのインストール手順は以下のとおりです。

1. インストーラをダウンロードします。Windows 向けダウンロードページ にアクセスし、インストールするバージョンのリンクをたどります。

   

   リンク先でインストーラのファイルをダウンロードします。ここでは v6.3 をインストールするので、pgAdmin 4 v6.3 のリンクをクリックし、pgadmin4-6.3-x64.exe のファイルをダウンロードします。

   

2. ダウンロードしたファイルをダブルクリックし、インストーラを起動します。

   

3. インストールモード選択のダイアログが表示されるので、個人向けにインストールする場合は Install for me only、全ユーザ向けにインストールする場合は Install for all users をクリックします。ここでは個人向けにインストールします。

   

4. インストーラが起動されるので、Next をクリックします。

   

5. ライセンスの内容が表示されるので、確認し、同意する場合は I accept the agreement を選択し、Next をクリックします。ライセンスに同意しなければ、インストールできません。

   

6. インストール先のフォルダのパスを入力するか、Browse… をクリックし、フォルダを選択し、Next をクリックします。個人向けにインストールする場合のデフォルトは C:\Users\ユーザ名\AppData\Local\Programs\pgAdmin 4\v6 で、ここではデフォルトのままにします。

   

7. スタートメニューのフォルダ名を入力するか、Browse… をクリックし、フォルダを選択し、Next をクリックします。フォルダを作成したくない場合は Don’t create a Start Menu folder にチェックを入れます。デフォルトは pgAdmin 4 で、ここではデフォルトのままにします。

   

8. これでインストールの準備は完了です。インストールの設定が表示されるので、確認し、問題なければ、Install をクリックします。問題があれば、Back をクリックし、前に戻って設定を変更します。

   

9. インストールが開始されるので、完了するまでしばらく待ちます。

   

10. これで Windows へのインストールは完了です。Finish をクリックすると、インストーラが閉じられます。

    

pgAdmin 4 の起動・アクセス

pgAdmin 4 の利用にあたり、デスクトップモードでの起動方法と、サーバモードでのアクセス方法を説明します。

デスクトップモードでの起動

デスクトップモードで pgAdmin 4 を起動するには、Red Hat 系 Linux では RHEL/CentOS/Rocky Linux 8 の場合には画面左上のアクティビティをクリックし、画面左のダッシュ内、一番下のグリッド (9 つの丸からなるアイコン) をクリックすると、画面中央にアプリケーションの一覧が表示されるので、その中から pgAdmin 4 をクリックします。

または以下のコマンドを実行します。

$ /usr/pgadmin4/bin/pgadmin4

Windows では pgAdmin 4 を個別にインストールした場合にはスタートメニューのアプリケーションの一覧から pgAdmin 4 フォルダ内の pgAdmin 4 をクリックします。

デスクトップモードで起動すると、最初にマスタパスワードの設定を行います。マスタパスワードは DB サーバのパスワードを暗号化するのに利用します。ここで指定したマスタパスワードは次回から起動時に入力が求められます。

表示言語はデフォルトで英語になっています。日本語に変更するには、File メニューの Preferences をクリックし、Miscellaneous 内の User language を開き、表示言語として Japanese を選択し、Save をクリックします。

表示言語の設定を反映するには、pgAdmin 4 を再起動する必要があります。

サーバモードでのアクセス

サーバモードで pgAdmin 4 にアクセスするには、Red Hat 系 Linux では Web ブラウザで http://(ホスト名または/ IP アドレス)/pgadmin4 の URL にアクセスします。ログイン画面が表示されるので、インストール時に指定した Email アドレス、パスワードを入力し、表示言語として Japanese を選択し、Login をクリックします。

Windows でもサーバモードで起動できますが、Web サーバがフレームワークに付属のテスト用なので、別途 Apache HTTP Server をインストールし、利用したほうがよいでしょう。その手順について、ここでは説明を省略しますが、興味があれば マニュアル を参照してください。

DB サーバの登録

Windows では自動的にローカルホストの DB サーバを検出し、登録してくれますが、検出されなかった場合や Red Hat 系 Linux の場合には、手動で DB サーバを登録します。

DB サーバの登録手順は以下のとおりです。

1. ダッシュボードのクイックリンク内の新しいサーバを追加をクリックします。

   

2. 登録するサーバの設定を入力し、保存をクリックします。最低限入力が必要な設定は General タブの名前、接続タブのホスト名/アドレスです。名前は識別子として使用する DB サーバの名前、ホスト名/アドレスは接続先の DB サーバのホスト名/アドレスです。ここでは、あらかじめ作成済みの PostgreSQL 14 の DB サーバを登録するため、まず、General タブで名前として PostgreSQL 14 を入力します。

   

   次に、接続タブでホスト名/アドレスとして localhost、パスワードを入力し、パスワードを保存を有効にします。

   

   ポート番号やユーザ名がデフォルトと異なる場合には、それらに合わせて設定を入力してください。

3. DB サーバの登録が完了すると、画面左のブラウザ内の指定したサーバグループ内に指定した名前で DB サーバが表示されます。ここではサーバグループ Servers 内に DB サーバ PostgreSQL 14 が表示されます。

   

   おわりに

   この記事では PostgreSQL 用の GUI 管理ツール pgAdmin4 の概要と、インストールおよび起動・アクセス、DB サーバ登録の手順を説明しました。pgAdmin 4 は多くの機能を備えていて、個々の機能は説明できていませんが、GUI なので直感的に操作できると思います。

   pgAdmin 4 は基本的にコマンド操作に不慣れなユーザ向けですが、それだけでなく、実行計画グラフィカル表示機能や手続き言語 PL/pgSQL デバッグ機能など、コマンドでは実現できない機能も提供しているので、GUI だと毛嫌いせずに一度利用してみてもよいでしょう。