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 のレコードが一覧に表示されなくなっていることが確認できます。