［Linux］Docker で PostgreSQL のコンテナの使用

Docker で PostgreSQL のコンテナの使用します。

docker run -d \
  --name postgres-test \
  --network my-app-network \
  -e POSTGRES_PASSWORD=password \
  -p 5432:5432 \
  postgres:18.1

--name で、コンテナ名を指定します。

--network で、ネットワークを指定します。PostgreSQL 単独で使う場合は省略可能。

docker network ls                     # ネットワーク一覧
docker network create my-app-network  # ネットワークの作成

-e POSTGRES_PASSWORD で、ユーザ postgres のパスワードを設定します。

-p はポートフォワーディングです。

postgres:18.1 は「イメージ名:タグ」です。
PostgreSQL の他のバージョンは、Docker 公式イメージで確認できます。

PostgreSQL のコンテナに接続して bash で操作できるようにする。

docker exec -it postgres-test bash

バージョンの確認

psql -V

# 結果：psql (PostgreSQL) 18.1 (Debian 18.1-1.pgdg13+2)

PostgreSQL に接続

psql -U {ユーザ名}  
psql -U postgres     # postgres は MySQL の root

データベースの作成

CREATE DATABASE testdb;

データベースの一覧の表示

\l  (小文字のエル)

                                                    List of databases
   Name    |  Owner   | Encoding | Locale Provider |  Collate   |   Ctype    | Locale | ICU Rules |   Access privileges
-----------+----------+----------+-----------------+------------+------------+--------+-----------+-----------------------
 postgres  | postgres | UTF8     | libc            | en_US.utf8 | en_US.utf8 |        |           |
 template0 | postgres | UTF8     | libc            | en_US.utf8 | en_US.utf8 |        |           | =c/postgres          +
           |          |          |                 |            |            |        |           | postgres=CTc/postgres
 template1 | postgres | UTF8     | libc            | en_US.utf8 | en_US.utf8 |        |           | =c/postgres          +
           |          |          |                 |            |            |        |           | postgres=CTc/postgres
 testdb    | postgres | UTF8     | libc            | en_US.utf8 | en_US.utf8 |        |           |
(4 rows)

# データベースの切り替え（MySQL の use）
\c testdb
##/src##

# テーブル作成

CREATE TABLE users (
    id INT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    name TEXT NOT NULL,
    email TEXT UNIQUE NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

GENERATED ALWAYS AS IDENTITY：常に採番する。任意指定不可。
GENERATED BY DEFAULT AS IDENTITY：任意指定可能。未指定の場合は採番する。

テーブル一覧の表示

\dt

          List of tables
 Schema | Name  | Type  |  Owner
--------+-------+-------+----------
 public | users | table | postgres
(1 row)

# トランザクション開始
BEGIN; # または START TRANSACTION;

# 追加
INSERT INTO users (name, email) VALUES ('Taro', 'taro@example.com'), ('Jori', 'jiro@example.com');

# 検索
SELECT * FROM users;

# 更新
UPDATE users SET name = 'Test' where id = 1;

# ロールバック
ROLLBACK;

# コミット
COMMIT;