PostgreSQL: PostgreSQLのインストールと初回接続の方法

# DockerでPostgreSQL 17を取得して実行
docker run --name my-postgres \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=bob \
  -e POSTGRES_DB=dev_shop \
  -p 5432:5432 \
  -d postgres:17

# コンテナが稼働していることを確認
docker ps | grep my-postgres

# ステップ1: PostgreSQL 17イメージを取得
docker pull postgres:17

# ステップ2: カスタム設定でコンテナを実行
docker run --name pg-dev \
  -e POSTGRES_USER=devuser \
  -e POSTGRES_PASSWORD=devpass123 \
  -e POSTGRES_DB=shopdb \
  -p 5432:5432 \
  -v pgdata:/var/lib/postgresql/data \
  -d postgres:17

# ステップ3: コンテナが稼働していることを確認
docker ps

# ステップ4: コンテナ内でpsql経由で接続
docker exec -it pg-dev psql -U devuser -d shopdb

psql (17.0)
Type "help" for help.

shopdb=>

1. https://www.enterprisedb.com/downloads/postgres からインストーラーをダウンロード
2. postgresql-17-windows-x64.exe を実行
3. インストールディレクトリを選択（デフォルト: C:\Program Files\PostgreSQL\17）
4. スーパーユーザー（postgres）のパスワードを設定
5. ポート番号を設定（デフォルト: 5432）
6. ロケールを選択（デフォルト: [Default locale]）
7. 「Launch Stack Builder at exit」をチェック（オプション、追加ツール用）
8. 「完了」をクリック

# HomebrewでPostgreSQL 17をインストール
brew install postgresql@17

# PostgreSQLサービスを起動
brew services start postgresql@17

# デフォルトデータベースに接続
psql postgres

# バージョンを確認
SELECT version();

# psql command executed successfully

# PostgreSQL公式APTリポジトリを追加
sudo apt update
sudo apt install -y curl ca-certificates
sudo install -d /usr/share/postgresql-common/pgdg
sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc \
  --fail https://www.postgresql.org/media/keys/ACCC4CF8.asc

sudo sh -c 'echo "deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] \
  https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" \
  > /etc/apt/sources.list.d/pgdg.list'

# PostgreSQL 17をインストール
sudo apt update
sudo apt install -y postgresql-17

# postgresユーザーに切り替えて接続
sudo -u postgres psql

# インストールを確認
SELECT version();

# psql command executed successfully

1. https://www.pgadmin.org/download/ からダウンロード
2. インストールしてpgAdmin 4を起動
3. 「Add New Server」をクリック
4. Generalタブ: Name = "Local Dev"
5. Connectionタブ:
   - Host: localhost（または127.0.0.1）
   - Port: 5432
   - Maintenance database: shopdb
   - Username: devuser
   - Password: devpass123
6. 「Save」をクリック

1. https://dbeaver.io/download/（Community Edition）からダウンロード
2. インストール��てDBeaverを起動
3. 「New Database Connection」（プラグアイコン）をクリック
4. PostgreSQLを選択
5. 接続設定を入力:
   - Host: localhost
   - Port: 5432
   - Database: shopdb
   - Username: devuser
   - Password: devpass123
6. 「Test Connection」をクリック（PG JDBCドライバーのダウンロードを促される）
7. 「Finish」をクリック

# ローカルPostgreSQLに接続
psql -h localhost -p 5432 -U devuser -d shopdb

# または接続URIを使用
psql "postgresql://devuser:devpass123@localhost:5432/shopdb"

# またはDocker経由
docker exec -it pg-dev psql -U devuser -d shopdb

CONTAINER ID   IMAGE     STATUS    
abc123         latest    Up 2 hours

-- 接続情報を確認
\conninfo

-- データベースを一覧表示
\l

-- テストテーブルを作成
CREATE TABLE test_greeting (
    id SERIAL PRIMARY KEY,
    message TEXT NOT NULL,
    created_at TIMESTAMP DEFAULT NOW()
);

-- データを挿入
INSERT INTO test_greeting (message) VALUES ('Hello, PostgreSQL!');

-- データを検索
SELECT * FROM test_greeting;

-- テストテーブルを削除
DROP TABLE test_greeting;

-- \conninfo output:
You are connected to database "shopdb" as user "devuser" on host "localhost" at port "5432".

-- SELECT output:
 id |      message       |         created_at
----+--------------------+----------------------------
  1 | Hello, PostgreSQL! | 2026-07-13 10:30:00.123456

# ============================================
# 完全なワークフロー: インストール、接続、確認
# ゼロから稼働まで5コマンド
# ============================================

# 1. DockerでPostgreSQLを起動
docker run --name pg-dev \
  -e POSTGRES_USER=devuser \
  -e POSTGRES_PASSWORD=devpass123 \
  -e POSTGRES_DB=shopdb \
  -p 5432:5432 \
  -d postgres:17

# 2. コンテナの準備完了を待つ（約5秒）
sleep 5

# 3. psqlで接続
docker exec -it pg-dev psql -U devuser -d shopdb

# 4. psql内で: 確認クエリを実行
# （これらのコマンドをpsqlプロンプトで入力）

-- PostgreSQLのバージョンを表示
SELECT version();

-- 現在の接続を表示
\conninfo

-- 利用可能な拡張機能を表示
SELECT name, default_version FROM pg_available_extensions LIMIT 5;

-- テストテーブルを作成してデータを挿入
CREATE TABLE hello_pg (
    id SERIAL PRIMARY KEY,
    greeting TEXT,
    created_at TIMESTAMPTZ DEFAULT NOW()
);

INSERT INTO hello_pg (greeting) VALUES
    ('Hello from PostgreSQL!'),
    ('Docker install works!'),
    ('Ready to learn!');

-- 確認
SELECT * FROM hello_pg;

-- クリーンアップ
DROP TABLE hello_pg;

-- psqlを終了
\q

# 5. 終了時にコンテナを停止
docker stop pg-dev

                                                     version
-----------------------------------------------------------------------------------------------------------------
 PostgreSQL 17.0 on x86_64-pc-linux-gnu, compiled by gcc (Debian 12.2.0-14) 12.2.0, 64-bit

     name      | default_version
---------------+-----------------
 plpgsql       | 1.0
 uuid-ossp     | 1.1
 pg_trgm       | 1.6

 id |       greeting        |          created_at
----+-----------------------+-------------------------------
  1 | Hello from PostgreSQL! | 2026-07-13 10:30:00+00
  2 | Docker install works!  | 2026-07-13 10:30:00+00
  3 | Ready to learn!        | 2026-07-13 10:30:00+00