CRUD 操作

users テーブルに対して、レコードの追加(INSERT)、複数行の取得(SELECT / Query)、1行の取得(QueryRow)、更新・削除(UPDATE / DELETE)までを順に扱います。

1. ユーザの追加(INSERT)

本章では、空の users テーブルにレコードを追加するINSERTから始めます。SQLに外部から受け取った値を埋め込む場面では、SQLインジェクションを避けるためにプレースホルダを使うのが基本になります。

1.1 プリペアドステートメント

SQLに値を埋め込むときは、プレースホルダ ? を使ってプリペアドステートメントで実行するのが原則です。文字列連結でSQLを組み立てるとSQLインジェクションの原因になります。

書き方は以下のとおりです。? の位置に、第2引数以降で渡した値がドライバ側で安全にエスケープされて埋め込まれます。Exec の戻り値である sql.Result からは、LastInsertId() で AUTO_INCREMENT により採番されたIDを取り出せます。

result, err := db.Exec(
    "INSERT INTO テーブル名 (カラム1, カラム2) VALUES (?, ?)",
    値1, 値2,
)
id, _ := result.LastInsertId()   // 自動採番されたIDを取り出す

main.go を以下のように書き換えます。これは、users テーブルに1件ユーザを追加し、自動採番されたIDを表示するコードです。今回はDSNのデータベース名部分に .env の MYSQL_DATABASE を差し込んでいます。

package main

import (
    "database/sql"
    "fmt"
    "os"

    _ "github.com/go-sql-driver/mysql"
    "github.com/joho/godotenv"
)

func main() {
    if err := godotenv.Load(); err != nil {
        fmt.Println(".envファイル読み込み失敗:", err)
        return
    }

    dsn := fmt.Sprintf(
        "%s:%s@tcp(%s:%s)/%s?parseTime=true",
        os.Getenv("MYSQL_USER"),
        os.Getenv("MYSQL_PASSWORD"),
        os.Getenv("MYSQL_HOST"),
        os.Getenv("MYSQL_PORT"),
        os.Getenv("MYSQL_DATABASE"),
    )
    db, err := sql.Open("mysql", dsn)
    if err != nil {
        fmt.Println("Open失敗:", err)
        return
    }
    defer db.Close()

    result, err := db.Exec(
        "INSERT INTO users (name, email) VALUES (?, ?)",
        "Taro", "taro@example.com",
    )
    if err != nil {
        fmt.Println("INSERT失敗:", err)
        return
    }

    id, _ := result.LastInsertId()
    fmt.Println("追加したユーザのID:", id)
}

コードを解説します。

result, err := db.Exec(
    "INSERT INTO users (name, email) VALUES (?, ?)",
    "Taro", "taro@example.com",
)

? の部分に、db.Exec の第2引数以降で値を渡します。ドライバが値を安全にエスケープしてくれるため、SQLインジェクションを防げます。

id, _ := result.LastInsertId()
fmt.Println("追加したユーザのID:", id)

result.LastInsertId() は AUTO_INCREMENT で自動採番されたIDを返します。ここでは2つ目の戻り値(エラー)は _ で捨てています。

実行してユーザを追加します。

go run main.go

以下のような実行結果が表示されます(IDは実行のたびに変わります)。

追加したユーザのID: 1

AUTO_INCREMENT が自動で 1 を割り振り、そのIDが表示されました。想定通りIDが表示されていれば、INSERTが成功しています。

2. ユーザ一覧の取得(SELECT)

INSERTで追加したユーザが実際にテーブルに格納されているかは、SELECTで取り出して確認します。Exec とは異なり、結果セットを扱うためのAPIが用意されているので、その使い方を押さえます。

2.1 Query メソッドによる複数行の取得

複数行を返すSELECTには Query を使います。返ってきた行は Rows として受け、Next() でループしながら1行ずつ取り出します。

書き方は2ブロックに分けて見ます。まず db.Query にSQLと引数を渡すと、複数行の結果を保持する *sql.Rows が返ります。取得したあとは必ず defer rows.Close() で解放します。閉じ忘れると接続がプールに戻らず、いずれ接続不足になります。

rows, err := db.Query("SELECT カラム名 FROM テーブル名 WHERE 条件カラム = ?", 条件値)
defer rows.Close()

続けて、for rows.Next() でループしながら各行を rows.Scan で変数に詰めます。Scan にはSELECTで選んだ列と同じ順序でフィールドのポインタを渡します。ループを抜けた後は rows.Err() でイテレーション中に発生したエラーを最終確認します。

for rows.Next() {
    var 変数 モデル型
    if err := rows.Scan(&変数.フィールド1, &変数.フィールド2); err != nil {
        // Scan エラーの処理
    }
}
if err := rows.Err(); err != nil {
    // イテレーション中のエラー処理
}

main.go を以下のように書き換えます。これは、users テーブルの全レコードを取り出し、User struct に詰め替えて一覧表示するコードです。前ステップで登録した1件がそのまま残っている前提です。

package main

import (
    "database/sql"
    "fmt"
    "os"

    _ "github.com/go-sql-driver/mysql"
    "github.com/joho/godotenv"
)

type User struct {
    ID    int
    Name  string
    Email string
}

func main() {
    if err := godotenv.Load(); err != nil {
        fmt.Println(".envファイル読み込み失敗:", err)
        return
    }

    dsn := fmt.Sprintf(
        "%s:%s@tcp(%s:%s)/%s?parseTime=true",
        os.Getenv("MYSQL_USER"),
        os.Getenv("MYSQL_PASSWORD"),
        os.Getenv("MYSQL_HOST"),
        os.Getenv("MYSQL_PORT"),
        os.Getenv("MYSQL_DATABASE"),
    )
    db, err := sql.Open("mysql", dsn)
    if err != nil {
        fmt.Println("Open失敗:", err)
        return
    }
    defer db.Close()

    rows, err := db.Query("SELECT id, name, email FROM users")
    if err != nil {
        fmt.Println("SELECT失敗:", err)
        return
    }
    defer rows.Close()

    var users []User
    for rows.Next() {
        var u User
        if err := rows.Scan(&u.ID, &u.Name, &u.Email); err != nil {
            fmt.Println("Scan失敗:", err)
            return
        }
        users = append(users, u)
    }
    if err := rows.Err(); err != nil {
        fmt.Println("イテレーション中エラー:", err)
        return
    }

    fmt.Println("--- ユーザ一覧 ---")
    for _, u := range users {
        fmt.Printf("[%d] %s <%s>\n", u.ID, u.Name, u.Email)
    }
}

コードを解説します。

rows, err := db.Query("SELECT id, name, email FROM users")
...
defer rows.Close()

db.Query は *sql.Rows を返します。必ず defer rows.Close() で解放します。閉じ忘れると接続がプールに戻らず、いずれ接続不足になります。

for rows.Next() {
    var u User
    if err := rows.Scan(&u.ID, &u.Name, &u.Email); err != nil {
        ...
    }
    users = append(users, u)
}

rows.Scan にフィールドのポインタを SELECT で選んだ列順に渡すと、値が詰め込まれます。ここでも & を忘れると値が渡らずコンパイルエラーになる点に注意します。

if err := rows.Err(); err != nil {
    ...
}

ループを抜けた後で rows.Err() を確認するのが Go の慣用パターンです。イテレーション中に発生したエラーはここで検出できます。

実行してユーザ一覧が取得できることを確認します。

go run main.go

以下のような実行結果が表示されます。

--- ユーザ一覧 ---
[1] Taro <taro@example.com>

前ステップの INSERT で追加された1件のユーザが [ID] Name <email> の形で表示されました。

3. 1行のみの取得(QueryRow)

一覧取得では Query と Rows の解放を扱いましたが、IDで単一のユーザを引くように結果が1行と分かっているケースでは、より簡潔に書ける専用のメソッドが用意されています。ここではその使い方と、行が見つからなかった場合のエラー判定まで確認します。

3.1 QueryRow の使いどころ

「IDでユーザを1人だけ取得したい」のように結果が1行と分かっているときは、QueryRow を使うと Rows の解放を気にせず直接 Scan できます。

書き方は以下のとおりです。QueryRow は返された1行に対して直接 .Scan(...) を呼び出せます。行が見つからなかった場合は、sql.ErrNoRows という決まったエラーが返るので、それ以外のエラーとは分岐して扱うのが基本パターンです。

var 変数 モデル型
err := db.QueryRow(
    "SELECT カラム名 FROM テーブル名 WHERE 条件カラム = ?",
    条件値,
).Scan(&変数.フィールド1, &変数.フィールド2)

if err == sql.ErrNoRows {
    // 行が見つからなかったときの処理
} else if err != nil {
    // その他のエラー処理
}

main.go を以下のように書き換えます。これは、id = 1 のユーザを QueryRow で1件だけ取得し、存在するかどうかで分岐して表示するコードです。前ステップで登録した id = 1 のユーザが残っている前提です。

package main

import (
    "database/sql"
    "fmt"
    "os"

    _ "github.com/go-sql-driver/mysql"
    "github.com/joho/godotenv"
)

type User struct {
    ID    int
    Name  string
    Email string
}

func main() {
    if err := godotenv.Load(); err != nil {
        fmt.Println(".envファイル読み込み失敗:", err)
        return
    }

    dsn := fmt.Sprintf(
        "%s:%s@tcp(%s:%s)/%s?parseTime=true",
        os.Getenv("MYSQL_USER"),
        os.Getenv("MYSQL_PASSWORD"),
        os.Getenv("MYSQL_HOST"),
        os.Getenv("MYSQL_PORT"),
        os.Getenv("MYSQL_DATABASE"),
    )
    db, err := sql.Open("mysql", dsn)
    if err != nil {
        fmt.Println("Open失敗:", err)
        return
    }
    defer db.Close()

    var one User
    err = db.QueryRow(
        "SELECT id, name, email FROM users WHERE id = ?",
        1,
    ).Scan(&one.ID, &one.Name, &one.Email)

    if err != nil {
        if err == sql.ErrNoRows {
            fmt.Println("ID=1 のユーザは見つかりませんでした")
        } else {
            fmt.Println("QueryRow失敗:", err)
        }
        return
    }
    fmt.Printf("取得: [%d] %s <%s>\n", one.ID, one.Name, one.Email)
}

コードを解説します。

err = db.QueryRow(
    "SELECT id, name, email FROM users WHERE id = ?",
    1,
).Scan(&one.ID, &one.Name, &one.Email)

QueryRow は1行分だけ返す SELECT に使います。返された行に対して直接 Scan を呼び、フィールドに詰め込みます。Rows を扱わないので defer rows.Close() が不要になります。

if err == sql.ErrNoRows {
    fmt.Println("ID=1 のユーザは見つかりませんでした")
}

行が見つからない場合、Scan は sql.ErrNoRows を返します。他のエラーと区別して扱うのが基本パターンです。

実行して1件だけ取得できることを確認します。

go run main.go

以下のような実行結果が表示されます。

取得: [1] Taro <taro@example.com>

取得: [1] Taro <taro@example.com> のように該当ユーザが表示されれば、QueryRow が正しく動作しています。

4. ユーザの更新(UPDATE)

INSERT・SELECTで登録と参照ができるようになったので、次はUPDATEで既存レコードを更新する方法を確認します。UPDATEはINSERTと同じ Exec メソッドで扱えますが、実際に何行に反映されたかを確認する RowsAffected を組み合わせるのがポイントです。

4.1 RowsAffected による更新結果の確認

UPDATEはINSERTと同じく Exec を使い、RowsAffected で影響行数を確認できます。

書き方は以下のとおりです。Exec の戻り値 sql.Result から RowsAffected() を呼ぶと、実際に更新された行数を取り出せます。WHERE の条件にマッチする行がなかったときは 0 が返るため、想定通りに更新されたかをこの値で判断できます。

result, err := db.Exec(
    "UPDATE テーブル名 SET カラム名 = ? WHERE 条件カラム = ?",
    新しい値, 条件値,
)
affected, _ := result.RowsAffected()   // 実際に更新された行数を取り出す

main.go を以下のように書き換えます。これは、id = 1 のユーザ名を Taro Yamada に更新するコードです。前ステップまでで登録した id = 1 のユーザが残っている前提です。

package main

import (
    "database/sql"
    "fmt"
    "os"

    _ "github.com/go-sql-driver/mysql"
    "github.com/joho/godotenv"
)

func main() {
    if err := godotenv.Load(); err != nil {
        fmt.Println(".envファイル読み込み失敗:", err)
        return
    }

    dsn := fmt.Sprintf(
        "%s:%s@tcp(%s:%s)/%s?parseTime=true",
        os.Getenv("MYSQL_USER"),
        os.Getenv("MYSQL_PASSWORD"),
        os.Getenv("MYSQL_HOST"),
        os.Getenv("MYSQL_PORT"),
        os.Getenv("MYSQL_DATABASE"),
    )
    db, err := sql.Open("mysql", dsn)
    if err != nil {
        fmt.Println("Open失敗:", err)
        return
    }
    defer db.Close()

    upRes, err := db.Exec(
        "UPDATE users SET name = ? WHERE id = ?",
        "Taro Yamada", 1,
    )
    if err != nil {
        fmt.Println("UPDATE失敗:", err)
        return
    }
    affected, _ := upRes.RowsAffected()
    fmt.Println("更新行数:", affected)
}

コードを解説します。

upRes, err := db.Exec(
    "UPDATE users SET name = ? WHERE id = ?",
    "Taro Yamada", 1,
)
...
affected, _ := upRes.RowsAffected()

UPDATE も Exec で実行します。RowsAffected は「実際に更新された行数」を返します。0 だった場合、条件にマッチする行がなかったことを意味します。

実行して結果を確認します。

go run main.go

以下のような実行結果が表示されます。

更新行数: 1

「更新行数: 1」となっていれば、id = 1 の1件が更新されています。今回はSELECTの実行を省略していますが、先ほどのSELECTのコードをもう一度実行すると、id = 1 の name が Taro から Taro Yamada に変わっていることが確認できます。

5. ユーザの削除(DELETE)

登録・参照・更新まで扱えるようになったので、最後にDELETEでレコードを削除する方法を確認します。DELETEもUPDATEと同じく Exec と RowsAffected の組み合わせで扱えます。

5.1 RowsAffected による削除結果の確認

DELETEはUPDATEと同じく Exec を使い、RowsAffected で影響行数を確認できます。

書き方は以下のとおりです。WHERE の条件にマッチする行がなかった場合は RowsAffected が 0 を返すため、想定通りに削除されたかを行数で判断できます。

result, err := db.Exec(
    "DELETE FROM テーブル名 WHERE 条件カラム = ?",
    条件値,
)
deleted, _ := result.RowsAffected()   // 実際に削除された行数を取り出す

main.go を以下のように書き換えます。これは、id = 1 のユーザを削除するコードです。前ステップまでで登録した id = 1 のユーザが残っている前提です。

package main

import (
    "database/sql"
    "fmt"
    "os"

    _ "github.com/go-sql-driver/mysql"
    "github.com/joho/godotenv"
)

func main() {
    if err := godotenv.Load(); err != nil {
        fmt.Println(".envファイル読み込み失敗:", err)
        return
    }

    dsn := fmt.Sprintf(
        "%s:%s@tcp(%s:%s)/%s?parseTime=true",
        os.Getenv("MYSQL_USER"),
        os.Getenv("MYSQL_PASSWORD"),
        os.Getenv("MYSQL_HOST"),
        os.Getenv("MYSQL_PORT"),
        os.Getenv("MYSQL_DATABASE"),
    )
    db, err := sql.Open("mysql", dsn)
    if err != nil {
        fmt.Println("Open失敗:", err)
        return
    }
    defer db.Close()

    delRes, err := db.Exec("DELETE FROM users WHERE id = ?", 1)
    if err != nil {
        fmt.Println("DELETE失敗:", err)
        return
    }
    deleted, _ := delRes.RowsAffected()
    fmt.Println("削除行数:", deleted)
}

コードを解説します。

delRes, err := db.Exec("DELETE FROM users WHERE id = ?", 1)
...
deleted, _ := delRes.RowsAffected()

DELETE もUPDATEと同じパターンで、Exec の戻り値から RowsAffected を呼び出して「実際に削除された行数」を取得します。

実行して結果を確認します。

go run main.go

以下のような実行結果が表示されます。

削除行数: 1

「削除行数: 1」となっていれば、id = 1 の1件が削除されています。今回はSELECTの実行を省略していますが、先ほどのSELECTのコードをもう一度実行すると、id = 1 のレコードが一覧に表示されなくなっていることが確認できます。