GORMの基本的な使い方

Sat, 17 Jan 2026 22:22:44 +0900

最近、Goを勉強していてGORMを触る機会があったので、基本的な部分を調べてみました。

モデル定義

GORMでは構造体をそのままテーブルにマップします。gorm.Modelを埋め込むとIDやCreatedAtなど便利なカラムが自動で付きます。

package main

import "gorm.io/gorm"

type User struct {
    gorm.Model
    Name  string
    Email string `gorm:"uniqueIndex"`
    Age   uint
}

DB接続とマイグレーション

PostgreSQLを例に、DBへ接続し、モデルに沿ってテーブルを自動生成します。dsnは環境に合わせて書き換えてください。

package main

import (
    "log"

    "gorm.io/driver/postgres"
    "gorm.io/gorm"
)

func main() {
    dsn := "host=localhost user=postgres password=postgres dbname=app port=5432 sslmode=disable"
    db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{})
    if err != nil {
        log.Fatal(err)
    }

    // モデルに合わせてテーブルを作成・更新
    if err := db.AutoMigrate(&User{}); err != nil {
        log.Fatal(err)
    }
}

CRUD操作

基本的なCRUD操作は以下のように行います。

package main

import (
    "fmt"
    "log"

    "gorm.io/driver/postgres"
    "gorm.io/gorm"
)

type User struct {
    gorm.Model
    Name  string
    Email string `gorm:"uniqueIndex"`
    Age   uint
}

func main() {
    dsn := "host=localhost user=postgres password=postgres dbname=app port=5432 sslmode=disable"
    db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{})
    if err != nil {
        log.Fatal(err)
    }
    if err := db.AutoMigrate(&User{}); err != nil {
        log.Fatal(err)
    }

    // CREATE: レコードを追加
    alice := User{Name: "Alice", Email: "alice@example.com", Age: 28}
    if err := db.Create(&alice).Error; err != nil {
        log.Fatal(err)
    }

    // READ: 1件取得（主キーまたは条件指定）
    var user User
    if err := db.First(&user, "email = ?", "alice@example.com").Error; err != nil {
        log.Fatal(err)
    }
    fmt.Printf("found: %+v\n", user)

    // UPDATE: 1カラム更新（モデルを指定）
    if err := db.Model(&user).Update("Age", 29).Error; err != nil {
        log.Fatal(err)
    }

    // DELETE: ソフトデリート（DeletedAtにタイムスタンプが入る）
    if err := db.Delete(&user).Error; err != nil {
        log.Fatal(err)
    }
}

よく使うクエリの書き方

// 条件付きで複数取得
var users []User
db.Where("age >= ?", 25).Order("age desc").Limit(5).Find(&users)

// 複数カラムをまとめて更新
db.Model(&user).Updates(map[string]interface{}{
    "Name": "Alice Updated",
    "Age":  30,
})

参考

Go 1.22のHTTPルーティング改善について

Mon, 29 Dec 2025 12:56:44 +0900

最近、Goの勉強をしているんですが、その中で Gin・Echo・chi など多くの選択肢があり、どのフレームワーク（ライブラリ）を選ぶべきか迷いました。そんな中、Go 1.22（2024年2月リリース）から標準ライブラリのhttp.ServeMuxが強化されたことを知りました。今回は、Go 1.22でのServeMuxの改善点について調べてみました。

これまでのServeMux（Go 1.21以前）の課題

Go 1.21以前のServeMuxには、以下のような制約がありました。

HTTPメソッドを指定できない

// Go 1.21以前: HTTPメソッドの区別ができない
mux := http.NewServeMux()
mux.HandleFunc("/users", func(w http.ResponseWriter, r *http.Request) {
    // GET、POST、PUT、DELETEなど、すべてのHTTPメソッドがこのハンドラに来る
    // 自分でメソッドを判定する必要があった
    switch r.Method {
    case http.MethodGet:
        // GETの処理
    case http.MethodPost:
        // POSTの処理
    default:
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
    }
})

このように、メソッドごとに処理を分けたい場合は、自分でswitch文を書く必要がありました。

パスパラメータを扱えない

// Go 1.21以前: パスパラメータが使えない
// /users/123 のような動的なパスを扱うには、自分でパースが必要
mux.HandleFunc("/users/", func(w http.ResponseWriter, r *http.Request) {
    // URLからIDを手動で抽出する必要があった
    id := strings.TrimPrefix(r.URL.Path, "/users/")
    fmt.Fprintf(w, "User ID: %s", id)
})

完全一致が難しい

// Go 1.21以前: /users にアクセスしたかったが、/users/ も /users/abc もマッチしてしまう
mux.HandleFunc("/users", handler)
// これは /users だけでなく /users/ にもマッチする

こうした課題から、多くのプロジェクトでサードパーティのルーターライブラリが使われていました。

Go 1.22での新機能

Go 1.22では、これらの課題を解決する3つの大きな機能が追加されました。

Go on kkato.dev