はじめに

本記事では、PostgreSQLのインストールから基本的なSQL操作・コマンド一覧までをまとめます。

初学者の方でも手を動かしながら理解できるように
手順・コマンド・コード例を丁寧に解説するつもりで
まとめていきます。

対象読者

データベースを初めて学ぶ方
PostgreSQLを業務・個人開発で使い始めたい方

実行環境

項目	内容
OS	Windows 11
PostgreSQL	16系

1. PostgreSQL とは

PostgreSQLはオープンソースのリレーショナルデータベース（RDBMS）です。
完全無料で商用利用も可能で、世界中のシステムで採用されています。

主な特徴

特徴	内容
オープンソース	無料・商用利用可
ACID準拠	トランザクションの信頼性が高い
豊富なデータ型	JSON・配列・地理情報など
SQL標準への高い準拠度	複雑なクエリも書きやすい
多言語対応	Python・Go・Java・Node.jsなど

MySQL との違い（簡易比較）

比較項目	PostgreSQL	MySQL
SQL標準準拠	高い	やや低い
複雑なクエリ	得意	やや苦手
書き込み速度	普通	速い
JSON対応	高機能	基本的な対応
ライセンス	PostgreSQL License	GPL / 商用

2. インストール（Windows 11）

インストーラーのダウンロード

公式サイトから Windows 用インストーラーを入手します。

https://www.postgresql.org/download/windows/

EnterpriseDB 製インストーラーを選択してください。
GUI付きで初心者に最適です。

インストール手順

手順	内容
1	ダウンロードした `.exe` を右クリック →「管理者として実行」
2	インストール先はデフォルト（`C:\Program Files\PostgreSQL\16`）でOK
3	コンポーネントを選択する
4	スーパーユーザー `postgres` のパスワードを設定する
5	ポート番号はデフォルト（`5432`）のまま進む

コンポーネントの選択

インストール時に以下をすべてチェックします。

☑ PostgreSQL Server   ← メインのDBサーバー
☑ pgAdmin 4           ← GUIツール（初学者に便利）
☑ Stack Builder       ← 追加ツール管理
☑ Command Line Tools  ← psql コマンドに必要

注意： スーパーユーザーのパスワードは後から変更が手間なので、最初にしっかり決めておきましょう。

PATH を環境変数に追加

psql コマンドをどこからでも使えるように PATH を設定します。

# PowerShell（管理者として実行）
[System.Environment]::SetEnvironmentVariable(
  "Path",
  $env:Path + ";C:\Program Files\PostgreSQL\16\bin",
  "Machine"
)

設定後、新しいターミナルを開いてバージョン確認します。

psql --version
# psql (PostgreSQL) 16.x と表示されれば成功

3. 初期設定・接続手順

psql でサーバーに接続

# 書式: psql -U ユーザー名 -d データベース名
psql -U postgres

パスワード入力後、以下のプロンプトが表示されれば接続成功です。

postgres=#

データベースとユーザーの作成

-- 新しいユーザー（ロール）を作成
CREATE USER myuser WITH PASSWORD 'mypassword';

-- データベースを作成
CREATE DATABASE mydb OWNER myuser;

-- 権限付与
GRANT ALL PRIVILEGES ON DATABASE mydb TO myuser;

-- mydb に切り替え
\c mydb myuser

テーブルの作成と基本操作

-- テーブル作成
CREATE TABLE users (
    id         SERIAL PRIMARY KEY,
    name       VARCHAR(100) NOT NULL,
    email      VARCHAR(200) UNIQUE,
    age        INTEGER,
    created_at TIMESTAMP DEFAULT NOW()
);

-- データ挿入
INSERT INTO users (name, email, age)
VALUES ('山田太郎', 'yamada@example.com', 25);

-- データ取得
SELECT * FROM users;

-- データ更新
UPDATE users SET age = 26 WHERE name = '山田太郎';

-- データ削除
DELETE FROM users WHERE id = 1;

4. コマンド一覧

psql メタコマンド（`\` 系）

コマンド	説明	使用例
`\l`	データベース一覧を表示	`\l`
`\c [DB名]`	データベースに切り替え	`\c mydb`
`\dt`	テーブル一覧を表示	`\dt`
`\d [テーブル名]`	テーブル構造を表示	`\d users`
`\du`	ユーザー（ロール）一覧	`\du`
`\i [ファイル]`	SQLファイルを実行	`\i setup.sql`
`\o [ファイル]`	出力をファイルに書き出し	`\o result.txt`
`\timing`	クエリ実行時間を表示	`\timing`
`\e`	外部エディタでSQL編集	`\e`
`\q`	psqlを終了	`\q`
`\?`	メタコマンドのヘルプ	`\?`
`\h [SQL]`	SQL構文のヘルプ	`\h SELECT`

DDL（データ定義言語）

コマンド	説明	使用例
`CREATE DATABASE`	データベースを作成	`CREATE DATABASE mydb;`
`DROP DATABASE`	データベースを削除	`DROP DATABASE mydb;`
`CREATE TABLE`	テーブルを作成	`CREATE TABLE t (id SERIAL PRIMARY KEY, name TEXT);`
`ALTER TABLE`	テーブルを変更（列追加など）	`ALTER TABLE t ADD COLUMN age INT;`
`DROP TABLE`	テーブルを削除	`DROP TABLE IF EXISTS t;`
`CREATE INDEX`	インデックスを作成（検索高速化）	`CREATE INDEX idx_name ON t(name);`
`CREATE VIEW`	ビューを作成	`CREATE VIEW v AS SELECT * FROM t WHERE age > 20;`

DML（データ操作言語）

コマンド	説明	使用例
`SELECT`	データを検索・取得	`SELECT name, age FROM users WHERE age >= 20;`
`INSERT INTO`	データを挿入	`INSERT INTO users (name) VALUES ('鈴木');`
`UPDATE`	データを更新	`UPDATE users SET age = 30 WHERE id = 1;`
`DELETE`	データを削除	`DELETE FROM users WHERE id = 1;`
`UPSERT`	挿入 or 更新（重複時）	`INSERT INTO t VALUES(1,'A') ON CONFLICT(id) DO UPDATE SET name='A';`
`TRUNCATE`	全データを高速削除	`TRUNCATE TABLE users;`

よく使う関数・句

コマンド / 関数	説明	使用例
`COUNT()`	件数を数える	`SELECT COUNT(*) FROM users;`
`SUM()` / `AVG()`	合計 / 平均	`SELECT AVG(age) FROM users;`
`MAX()` / `MIN()`	最大 / 最小	`SELECT MAX(age) FROM users;`
`GROUP BY`	グループ集計	`SELECT age, COUNT(*) FROM users GROUP BY age;`
`ORDER BY`	並び順を指定	`SELECT * FROM users ORDER BY age DESC;`
`LIMIT` / `OFFSET`	取得件数 / 開始位置	`SELECT * FROM users LIMIT 10 OFFSET 20;`
`JOIN`	テーブルを結合	`SELECT u.name, o.item FROM users u JOIN orders o ON u.id = o.user_id;`
`LIKE`	パターン検索	`SELECT * FROM users WHERE name LIKE '山%';`
`NOW()` / `CURRENT_DATE`	現在日時 / 日付	`SELECT NOW();`
`COALESCE()`	NULL を別値に置換	`SELECT COALESCE(age, 0) FROM users;`
`CAST()`	型変換	`SELECT CAST('123' AS INTEGER);`
`EXPLAIN ANALYZE`	クエリ実行計画を確認	`EXPLAIN ANALYZE SELECT * FROM users;`

バックアップ・復元（シェルから実行）

コマンド	説明	使用例
`pg_dump`	DBをバックアップ（SQL形式）	`pg_dump -U postgres mydb > backup.sql`
`pg_dump -Fc`	カスタム形式でバックアップ	`pg_dump -U postgres -Fc mydb > backup.dump`
`pg_restore`	カスタム形式から復元	`pg_restore -U postgres -d mydb backup.dump`
`psql`（リストア）	SQLファイルから復元	`psql -U postgres mydb < backup.sql`
`pg_dumpall`	全DBをバックアップ	`pg_dumpall -U postgres > all.sql`

まとめ

手順	コマンド
バージョン確認	`psql --version`
サーバーに接続	`psql -U postgres`
DB切り替え	`\c mydb`
テーブル一覧	`\dt`
テーブル構造確認	`\d users`
psqlを終了	`\q`

さいごに

PostgreSQL は個人開発から大規模な業務システムまで幅広く使われているデータベースです。
OSS-DBの資格取得予定ですのでハンズオンで学んでいきます。