カテゴリ: Go言語 更新日: 2026/02/08

Go言語でのテスト用DB設定とテストデータ管理のコツ|初心者でも安心

Go言語のテスト用DB設定とテストデータ管理のコツ
Go言語のテスト用DB設定とテストデータ管理のコツ

先生と生徒の会話形式で理解しよう

生徒

「Go言語でデータベースのテストをするとき、毎回本番用のデータベースを使うのは危険ですよね?」

先生

「そうです。本番データを直接操作するのは非常に危険です。テスト用のデータベースを別に用意して使うのが基本です。」

生徒

「テスト用のデータベースってどうやって作るんですか?」

先生

「DockerやローカルにPostgreSQLやMySQLを立ち上げて、テスト用のデータベースを作ります。また、テストの前に毎回データを初期化するのがポイントです。」

生徒

「テストデータを準備するコツはありますか?」

先生

「テストデータは簡潔で、必要最低限の情報だけを用意することです。多すぎるとテストが複雑になり、管理も大変になります。」

1. テスト用DBの準備

1. テスト用DBの準備
1. テスト用DBの準備

Go言語でテスト用のデータベースを準備する場合、まず本番と分けて独立したDBを用意します。PostgreSQLならCREATE DATABASE testdb;で作成できます。テスト用DBを使うことで、本番データを汚さず安全にテストできます。

2. 環境変数で接続情報を管理

2. 環境変数で接続情報を管理
2. 環境変数で接続情報を管理

接続情報は環境変数で管理すると安全です。Goではos.Getenvで読み込めます。こうすることで、テスト環境ごとに異なる情報を簡単に切り替えられます。


import "os"

dbUser := os.Getenv("DB_USER")
dbPass := os.Getenv("DB_PASS")
dbHost := os.Getenv("DB_HOST")
dbName := os.Getenv("DB_NAME")

3. テストデータの準備

3. テストデータの準備
3. テストデータの準備

テストを行う前に、データベースに必要なデータを登録します。例えば、ユーザー情報や商品データなど、テストに必要な最小限のデータだけを準備します。


_, err := db.Exec("INSERT INTO users (name, email) VALUES ($1, $2)", "テスト太郎", "taro@example.com")
if err != nil {
    panic(err)
}

これにより、テスト中に必要な情報が確実に揃います。

Go言語を基礎からスッキリ学びたい人や、 文法だけでなく「実用的な使い方」まで押さえたい人には、 定番の入門書がこちらです。

基礎からわかるGo言語をAmazonで見る

※ Amazon広告リンク

4. テスト終了後のデータ削除

4. テスト終了後のデータ削除
4. テスト終了後のデータ削除

テストが終わったらデータを削除して、次回のテストに影響を与えないようにします。Go言語ではdb.Execで削除できます。


_, err := db.Exec("DELETE FROM users")
if err != nil {
    panic(err)
}

これをテストの前後に自動で実行すると、常にクリーンな状態でテストが可能です。

5. テスト用マイグレーションを使う

5. テスト用マイグレーションを使う
5. テスト用マイグレーションを使う

テスト用のデータベースでも、スキーマは本番と同じにしておくことが重要です。golang-migrateなどのマイグレーションツールを使って、テーブル作成や変更を自動で反映させると便利です。


m, err := migrate.New(
    "file://migrations",
    "postgres://user:pass@localhost/testdb?sslmode=disable")
if err != nil {
    panic(err)
}
m.Up()

6. テストの自動化と管理

6. テストの自動化と管理
6. テストの自動化と管理

Go言語のtestingパッケージを使えば、テストの自動化が可能です。テスト用DBを初期化してデータを投入する処理をsetup関数にまとめると、複数のテストケースで再利用できます。


func setupTestDB() *sql.DB {
    db, _ := sql.Open("postgres", "接続文字列")
    db.Exec("DELETE FROM users")
    db.Exec("INSERT INTO users (name, email) VALUES ('テスト太郎', 'taro@example.com')")
    return db
}

7. 注意点とコツ

7. 注意点とコツ
7. 注意点とコツ

テスト用データは最小限にし、テストごとに初期化を行うことが基本です。また、本番用のDB情報は絶対にテストコードに直接書かないことが重要です。DockerやCI/CD環境を使って、自動化された安全なテスト環境を構築すると便利です。

関連記事:
カテゴリの一覧へ
新着記事
New1
Swift
SwiftPMで自作パッケージを公開する方法を完全ガイド!初心者でもわかる公開手順
New2
Kotlin
Kotlinの拡張関数をライブラリとしてまとめる方法!初心者でもできるコード再利用術
New3
Go言語
Go言語のDBアクセス層の設計パターンとベストプラクティス|初心者向け解説
New4
Kotlin
Kotlinのスコープ関数の戻り値の違いと使い分けを初心者向けに解説!
人気記事
No.1
Java&Spring記事人気No1
Go言語
Go言語のドライバ設定を完全解説!MySQL・PostgreSQLの接続手順を初心者向けにやさしく説明
No.2
Java&Spring記事人気No2
Kotlin
KotlinのChannelでデータをやり取りする方法を完全ガイド!初心者にもわかる非同期通信の基本
No.3
Java&Spring記事人気No3
Kotlin
Kotlin DSLとGroovy DSLの違いをやさしく解説!初心者でもわかるGradleスクリプトの使い分け
No.4
Java&Spring記事人気No4
Kotlin
Android Studioのインストール手順と初期設定を初心者向けに完全解説!
No.5
Java&Spring記事人気No5
Swift
Swift UIKitとSwiftUIの違いを徹底比較!初心者はどちらを選ぶべき?
No.6
Java&Spring記事人気No6
Kotlin
Kotlinでテキスト表示・編集!初心者でもわかるTextViewとEditTextの使い方
No.7
Java&Spring記事人気No7
Kotlin
Kotlinのビルド設定エラーと解決法まとめ!初心者向けGradleトラブル対処ガイド
No.8
Java&Spring記事人気No8
Kotlin
Kotlinでデータベースのテストを行う方法を徹底解説!初心者でもわかるRoomのテスト入門

💻 作業効率アップに

ノートPCを縦置きしてデスクを広く。
省スペースで片づく定番スタンド

UGREEN 縦型スタンドをAmazonで見る

※ Amazon広告リンク