テーブル定義書の読み方

テーブル定義書とは

テーブル定義書の構成

よくある構成要素

カラム定義の要素

よく使うデータ型

文字列型

数値型

日時型

【サンプル】テーブル定義書の実例

usersテーブル定義書

基本情報

カラム定義

ordersテーブル定義書

基本情報

カラム定義

ステータス値

制約

インデックス

usersテーブル

ordersテーブル

外部キー

読み方のポイント

1. 主キー（PK）を確認する

• レコードを一意に識別するカラム
• JOINの条件に使う
• 通常はidという名前

2. 外部キー（FK）を確認する

• 他テーブルとの関連
• JOINの条件に使う
• 参照整合性の制約

3. NULL可/不可を確認する

4. デフォルト値を確認する

• INSERT時に省略できるか
• どんな値が入るか

5. インデックスを確認する

• どのカラムに検索条件がつくか
• ユニーク制約があるか

SQLを書くときの活用

SELECT文の例

-- usersテーブルから有効なユーザーを取得
SELECT id, email, name, phone
FROM users
WHERE status = 1
ORDER BY created_at DESC;

JOIN文の例

-- ordersとusersを結合
SELECT o.id, o.order_number, o.total_amount,
       u.name, u.email
FROM orders o
JOIN users u ON o.user_id = u.id
WHERE o.status = 2;

INSERT文の例

-- usersに新規レコード追加
INSERT INTO users (email, password_hash, name, phone)
VALUES ('user@example.com', 'hashed_password', '山田太郎', '03-1234-5678');
-- id, status, created_at, updated_at はデフォルト値が入る

よくある疑問

テーブル定義書でよくある落とし穴

【実践】テーブル定義書からエンティティを作る

サンプルのusersテーブル定義書から、Javaのエンティティクラスを作成してみましょう。

ステップ1：基本構造を決める

テーブル基本情報を見て、クラスの基本構造を決めます。

import javax.persistence.*;
import java.time.LocalDateTime;

@Entity
@Table(name = "users")  // テーブル名（物理）: users
public class User {
    // カラム定義をもとにフィールドを定義
}

ステップ2：主キーを設定する

カラム定義のPK列を見て、主キーを設定します。

// No.1: id - BIGINT, PK, AUTO
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

ステップ3：各カラムをフィールドにマッピングする

@Entity
@Table(name = "users")
public class User {

    // No.1: id - BIGINT, PK, AUTO
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    // No.2: email - VARCHAR(256), NOT NULL, ユニーク
    @Column(nullable = false, length = 256, unique = true)
    private String email;

    // No.3: password_hash - VARCHAR(256), NOT NULL
    @Column(name = "password_hash", nullable = false, length = 256)
    private String passwordHash;  // スネークケース→キャメルケース変換

    // No.4: name - VARCHAR(100), NOT NULL
    @Column(nullable = false, length = 100)
    private String name;

    // No.5: phone - VARCHAR(15), NULL許可
    @Column(length = 15)
    private String phone;  // nullableはデフォルトtrue

    // No.6: status - INT, NOT NULL, デフォルト1
    @Column(nullable = false)
    private Integer status = 1;  // デフォルト値を設定

    // No.7: last_login_at - DATETIME, NULL許可
    @Column(name = "last_login_at")
    private LocalDateTime lastLoginAt;

    // No.8: created_at - DATETIME, NOT NULL, デフォルトCURRENT_TIMESTAMP
    @Column(name = "created_at", nullable = false, updatable = false)
    private LocalDateTime createdAt;

    // No.9: updated_at - DATETIME, NOT NULL, ON UPDATE
    @Column(name = "updated_at", nullable = false)
    private LocalDateTime updatedAt;

    // ライフサイクルコールバック
    @PrePersist
    protected void onCreate() {
        createdAt = LocalDateTime.now();
        updatedAt = LocalDateTime.now();
    }

    @PreUpdate
    protected void onUpdate() {
        updatedAt = LocalDateTime.now();
    }

    // getter/setter は省略
}

カラム定義とアノテーションの対応表

外部キーがある場合

ordersテーブルのuser_id（FK）を例に、リレーションを設定します。

@Entity
@Table(name = "orders")
public class Order {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    // No.2: user_id - BIGINT, FK → users(id)
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "user_id", nullable = false)
    private User user;

    @Column(name = "order_number", nullable = false, length = 20, unique = true)
    private String orderNumber;

    @Column(name = "total_amount", nullable = false)
    private BigDecimal totalAmount;

    @Column(nullable = false)
    private Integer status = 1;

    @Column(name = "ordered_at", nullable = false)
    private LocalDateTime orderedAt;

    @Column(name = "shipped_at")
    private LocalDateTime shippedAt;  // NULL許可

    // ... created_at, updated_at
}

ステータス値の対応

テーブル定義書にステータス値の一覧がある場合、Enum化すると便利です。

// ordersテーブルのステータス値をEnumに
public enum OrderStatus {
    ORDERING(1, "注文中"),
    PAID(2, "決済完了"),
    PREPARING(3, "出荷準備中"),
    SHIPPED(4, "発送済み"),
    DELIVERED(5, "配達完了"),
    CANCELLED(9, "キャンセル");

    private final int code;
    private final String label;

    OrderStatus(int code, String label) {
        this.code = code;
        this.label = label;
    }

    public int getCode() { return code; }
    public String getLabel() { return label; }

    public static OrderStatus fromCode(int code) {
        for (OrderStatus status : values()) {
            if (status.code == code) return status;
        }
        throw new IllegalArgumentException("Unknown code: " + code);
    }
}

関連ドキュメント

• 設計書・仕様書の読み方 - 設計書全般の読み方
• 詳細設計書の読み方 - 詳細設計書全般
• ER図の読み方 - テーブル間の関係
• API仕様書の読み方 - APIとの対応