PostgreSQL データベース接続

JPKODA 編集部 May 11, 2026

PostgreSQLデータベースへの接続は、このシステムを利用する上での基礎となるステップです。
本章では、PostgreSQLデータベースに接続するための2つの主要な方法である「psql（コマンドラインインターフェース）」と「pgAdmin（グラフィカルユーザーインターフェース）」について詳しく解説します。

1. psql を使用したデータベース接続

psql は、PostgreSQLのターミナルベース（コマンドライン）のフロントエンドツールです。クエリをインタラクティブに入力してPostgreSQLに送信し、その結果を確認することができます。シンプルなクエリの実行から、複雑なデータベース管理タスクまで対応する非常に強力なツールです。

1.1 基本的な接続

最も基本的な接続方法は、ターミナルで直接 psql と入力することです。この方法は、ローカルコンピュータ上のデータベースに接続しており、オペレーティングシステムのユーザー名がデータベースのユーザー名と一致していることを前提としています。

psql

接続に成功すると、以下のようなプロンプトが表示されます：

postgres=#

このプロンプトは、現在デフォルトのオペレーティングシステムユーザーとして、postgres という名前のデフォルトデータベースに接続されていることを示しています。

1.2 接続文字列 (Connection Strings) の使用

接続パラメータをより精密にコントロールするために、接続文字列を使用できます。一般的なフォーマットは以下の通りです：

psql "host=ホスト名 dbname=データベース名 user=ユーザー名 password=パスワード"

各パーツの解説：

host: PostgreSQLサーバーのホスト名またはIPアドレス。ローカル接続の場合は localhost または 127.0.0.1 を使用します。
dbname: 接続したい具体的なデータベース名（例：dbname=mydatabase）。
user: 接続に使用するPostgreSQLのユーザー名（例：user=myuser）。
password: 指定したユーザーのパスワード。セキュリティ上の理由（ターミナルの履歴にパスワードがプレーンテキストで残るのを防ぐため）から、コマンドラインに直接パスワードを記述することは推奨されません。このパラメータを省略すると、psqlは安全にパスワードの入力を求めてきます。

完全な例： データベース名が mydatabase、ユーザー名が myuser で、サーバーがローカルで動作している場合：

psql "host=localhost dbname=mydatabase user=myuser"

実行後、システムからパスワードの入力が求められます。

1.3 環境変数 (Environment Variables) の利用

接続パラメータを管理するためのより安全で便利な方法は、環境変数を使用することです。よく使われる環境変数には以下があります：

PGHOST: データベースサーバーのホスト名。
PGDATABASE: データベース名。
PGUSER: ユーザー名。
PGPASSWORD: パスワード（漏洩防止のため、使用には十分注意してください）。
PGPORT: ポート番号（デフォルトは 5432）。

環境変数の設定例（Linux/macOSの場合）：

export PGHOST=localhost
export PGDATABASE=mydatabase
export PGUSER=myuser
# PGPASSWORDを直接設定するのではなく、システムに入力を促させることを強く推奨します

設定完了後は、単に以下を実行するだけです：

psql

1.4 psql の主要なショートカットコマンド

接続成功後、よく使用される組み込みコマンドをいくつか紹介します：

\l : サーバー上のすべてのデータベースを一覧表示します。
\c データベース名 : 別のデータベースに接続を切り替えます（例：\c mydatabase）。
\dt : 現在のデータベース内のすべてのテーブルを一覧表示します。
\d テーブル名 : 特定のテーブルの構造の詳細（カラム名、データ型、制約など）を表示します（例：\d customers）。
\q : psql を終了してターミナルに戻ります。
? : psql コマンドに関するヘルプ情報を表示します。

操作例：mydatabase データベース内のすべてのテーブルを表示する

まず接続します：

psql -d mydatabase -U myuser -h localhost

psql に入った後、次のように入力します：

\dt

1.5 SQLスクリプトファイルの実行

-f オプションを使用すると、作成済みのSQLスクリプトファイルをコマンドラインから直接実行できます：

psql -f /パス/script.sql -d mydatabase -U myuser -h localhost

これは、データベースの自動セットアップや一連のバッチクエリを実行する際に非常に有用です。

1.6 psql の高度なテクニック

コマンド履歴: psql はコマンドの履歴を記憶しています。キーボードの上下方向キーを使用して、以前入力したコマンドを素早く呼び出すことができます。
Tabキーによる補完: psql はTabキーによるコマンド、テーブル名、カラム名のオートコンプリート（自動補完）をサポートしており、入力効率を大幅に向上させます。
マルチラインクエリ: 長いクエリ文を複数行に分けて記述できます。psql はセミコロン (;) を検出したときにはじめて、それを文の終わりとみなして実行します。

2. pgAdmin を使用したデータベース接続

pgAdmin は、PostgreSQLで最も人気のあるオープンソースのグラフィカル管理ツール（GUI）です。直感的でフレンドリーなインターフェースを提供し、データベースの管理、クエリの実行、その他の管理タスクを容易にします。

2.1 インストールと起動

pgAdmin は通常、PostgreSQLの公式インストーラーに同梱されていますが、OSやパッケージマネージャーによっては別途インストールが必要な場合もあります。インストール後、pgAdminを開くと、通常はデフォルトのWebブラウザで起動します。

2.2 サーバー接続の追加

左側のブラウザツリーメニューで「Servers (サーバー)」を右クリックします。
「Register (登録)」 -> 「Server... (サーバー...)」を選択します。（古いバージョンでは "Create -> Server" の場合があります）
表示されたダイアログの「General (一般)」タブで、この接続に名前を付けます（例：「ローカル PostgreSQL」）。
「Connection (接続)」タブに切り替え、以下の情報を入力します：

Host name/address (ホスト名/アドレス): ローカル接続の場合は localhost または 127.0.0.1。
Port (ポート): デフォルトの 5432 のままにします。
Maintenance database (メンテナンスデータベース): 通常は postgres のままにします。
Username (ユーザー名): PostgreSQLのユーザー名（postgres や myuser など）。
Password (パスワード): そのユーザーのパスワードを入力します。「Save password? (パスワードを保存する)」にチェックを入れると、次回の接続がスムーズになります。

「Save (保存)」をクリックします。

接続に成功すると、指定した名前のサーバーが左側の「Servers」リストに表示されます。

2.3 pgAdmin でのナビゲーション

接続後は、左側のパネルでノードを展開してデータベースオブジェクトをブラウズできます：

Databases (データベース): サーバーノードを展開し、すべてのデータベースリストを確認します。
Schemas (スキーマ): 特定のデータベースノードを展開し、そこに含まれるスキーマを確認します（デフォルトは通常 public スキーマを使用します）。
Tables (テーブル): スキーマノードを展開すると、そのスキーマ内のすべてのテーブルを確認できます。

2.4 クエリの実行

左側のツリーメニューで、特定のデータベース（またはスキーマ）をクリックして選択します。
上部ツールバーの「Query Tool (クエリツール)」アイコン（通常、データベースアイコンに虫眼鏡または稲妻が重なったもの）をクリックします。
クエリエディタウィンドウが開くので、ここにSQL文を入力します。

例：customers テーブルからデータを取得する

エディタに以下を入力します：

SELECT * FROM customers;

上部の「Execute/Refresh (実行/リフレッシュ)」ボタン（通常、再生ボタンのようなアイコン。ショートカットキーは F5）をクリックしてクエリを実行します。結果は下部の結果グリッドにテーブル形式で表示されます。

2.5 pgAdmin の強力な機能

SQLエディタ: 構文ハイライト、コード補完、クエリ履歴をサポートしています。
データ編集: Excelのように、結果グリッド内で直接セルをダブルクリックしてテーブルデータを修正できます。
バックアップとリストア: グラフィカルなデータベースバックアップおよびリストアウィザードを提供します。
サーバーモニタリング: サーバーのパフォーマンスやアクティビティの状態をリアルタイムで可視化して監視できます。
オブジェクト管理: 右クリックメニューからデータベース、テーブル、インデックスなどのオブジェクトを簡単に作成、変更、削除できます。

3. psql vs. pgAdmin：どちらを選ぶべきか？

特性	psql (コマンドライン)	pgAdmin (グラフィカルインターフェース)
インターフェース形式	プレーンテキスト・コマンドライン	グラフィカルユーザーインターフェース (GUI)
学習曲線	初期はやや険しいが、習得後は極めて効率的	初心者でも直感的で分かりやすく、メニューが豊富
自動化能力	スクリプト作成や自動化タスクに非常に適している	自動化タスクにはあまり向かない
リモートアクセス	SSH経由で非常に軽量かつ高速に接続可能	リモート接続にはネットワーク設定やファイアウォール規則の調整が必要な場合がある
リソース使用量	極めて低い	比較的高い（Webサービスやデスクトップクライアントを動かすため）
最適なシナリオ	スクリプト作成、自動化運用、簡単なコマンドの即時実行	データ探索、複雑な管理設定、データベース構造とデータの視覚的確認

まとめのアドバイス：

一般的に、psql はスクリプト作成、自動デプロイ、およびリモートサーバーの迅速な管理に好まれます。一方で pgAdmin は、日常的なインタラクティブなデータ探索、複雑な構成管理、およびデータベース構造の直感的な分析に適しています。ほとんどのプロフェッショナルなデータベース開発者や管理者は、これら2つのツールを組み合わせ、直面している具体的なタスクに応じて最適なものを選択しています。