Contents
GORM ORM 使用ガイド：Go言語でのデータベース操作の基本と実装手順
GORMは、Go言語でWebアプリケーションを開発する際にデータベース操作を効率化するためのORMライブラリとして広く利用されています。本記事では2023年現在の技術情報に基づき、GORMの基本的な使用法から実装手順までを解説します。将来的な技術変更に備えて、最新情報の確認が推奨される点に注意が必要です。
GORMの導入とプロジェクト初期設定
Go言語でのGORM導入は、プロジェクト構成が整った上で簡単に行えます。以下にインストール手順と初期設定の流れを解説します。
重要なポイント
GORMはGo 1.20以降に対応しており、古いバージョンでは機能制限が生じる可能性があります。公式ドキュメントでバージョン互換性を確認してください。
GORM公式ドキュメント (英語) / 日本語版
GORMのインストール方法
GORMはGo Modules経由で簡単に導入可能です。以下のコマンドで公式ライブラリを取得してください。
|
1 2 |
go get -u gorm.io/gorm |
このコマンド実行後、プロジェクト内のimport文に以下のように記述することでGORMを使用できます。
|
1 2 3 4 |
import ( "gorm.io/gorm" ) |
プロジェクト初期化の手順
新たにプロジェクトを作成する際は、以下のステップを実施します。
- プロジェクトフォルダを作成し移動
go mod init [module-name]でモジュールを初期化- 上記の
go getコマンドでGORMをインストール - 任意でデータベースドライバ（例: MySQL、PostgreSQL）を追加
データベース接続の基本構文
GORMを使用する際には、まずデータベースに接続する必要があります。以下に基本的な接続方法を紹介します。
SQLデータベースとの接続手順
GORMではgorm.Open()関数を使ってデータベースに接続します。例としてPostgreSQLの接続コードを示します。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
import ( "gorm.io/driver/postgres" "gorm.io/gorm" ) func main() { dsn := "host=localhost user=gorm password=gorm dbname=gorm port=5432 sslmode=disable TimeZone=Asia/Tokyo" db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{}) if err != nil { panic("failed to connect database") } } |
接続パラメータの設定方法
接続に必要なパラメータ（ホスト、ユーザー名、パスワードなど）はdsn変数に格納します。各データベースごとに適切なドライバを指定してください。
| データベース | 対応ドライバ | 例 |
|---|---|---|
| MySQL | gorm.io/driver/mysql |
mysql://user:pass@localhost/dbname?charset=utf8mb4&parseTime=True&loc=Local |
| PostgreSQL | gorm.io/driver/postgres |
上記参照 |
| SQLite | gorm.io/driver/sqlite |
file:test.db?cache=64k&mode=rwc |
モデル定義と自動マイグレーション
GORMでは構造体を使用してモデルを定義し、自動的にテーブルを作成できます。以下に具体的な手順を解説します。
構造体ベースのモデル定義
モデルはGo言語の構造体で定義され、データベースのテーブルと対応させます。以下の例ではUserモデルを定義しています。
|
1 2 3 4 5 6 |
type User struct { gorm.Model Name string Email string `gorm:"unique_index"` } |
- gorm.Model: タイムスタンプやIDなどの共通フィールドを持たせるための構造体
- タグによるカラム設定:
gorm:"unique_index"のようにタグを付けることで、データベースの制約（ユニークインデックスなど）を指定可能です
AutoMigrateの実行方法
モデル定義後はAutoMigrate()関数を使ってテーブルを作成します。
|
1 2 |
db.AutoMigrate(&User{}) |
この処理により、usersという名前のテーブルが自動的に作成され、データベースに反映されます。
CRUD操作とアソシエーションの実装例
GORMではデータベースに対する基本的なCRUD（Create, Read, Update, Delete）操作を簡潔なコードで実現できます。また、複数テーブル間の関係性（アソシエーション）も扱えます。
CRUD操作の具体例
以下にCRUD操作のサンプルコードを示します。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
// 作成 user := User{Name: "Alice", Email: "[メールアドレス削除]"} db.Create(&user) // 読み込み var user User db.First(&user, 1) // ID=1のレコード取得 // 更新 db.Model(&user).Update("Name", "Bob") // 削除 db.Delete(&user) |
アソシエーションの設定方法
関係性を定義するには、構造体内にgorm.ForeignKeyやgorm.Associationなどのタグを追加します。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
type User struct { gorm.Model Name string Email string // 1対多の関係（HasMany） Posts []Post `gorm:"foreignkey:AuthorID"` } type Post struct { gorm.Model Title string Content string AuthorID uint } |
これにより、UserとPostの間に1対多の関係性が定義され、以下のようにデータを取得できます。
|
1 2 3 |
var user User db.Preload("Posts").First(&user, 1) |
クエリビルダの基本構文と高階関数
GORMでは、データベースのクエリを直接記述せずに、チェーン式で構築できます。以下に代表的なクエリ操作を紹介します。
Where/Order/Preloadなどの基本クエリ
特定の条件でレコードを取得するにはWhere()関数を使用します。
|
1 2 3 4 5 6 7 |
// 条件指定（メールアドレスが[メールアドレス削除]） var user User db.Where("email = ?", "[メールアドレス削除]").First(&user) // ソート（投稿日降順） db.Order("created_at desc").Find(&users) |
高階メソッドの活用
レコードの取得方法には以下の関数が利用できます。
| 関数名 | 概要 |
|---|---|
First |
ID順で最初のレコードを取得 |
Take |
ランダムに1件取得 |
Limit |
結果の上限を指定 |
|
1 2 3 4 5 6 |
// 最初のレコード取得（ID昇順） db.First(&user) // 5件まで取得 db.Limit(5).Find(&users) |
まとめと今後の展望
本記事では、GORMの基本的な使用法から実装手順までを体系的に解説しました。主なポイントは以下の通りです。
- 導入: Go Modules経由でのインストールとプロジェクト初期設定
- データベース接続:
gorm.Open()関数による接続構文とエラーハンドリング - モデル定義: 構造体とタグを用いたテーブル作成
- CRUD操作: シンプルなコードで基本的なデータ操作を実現
- アソシエーション: レレーションシップを定義して複数テーブルのデータを扱う
- クエリビルダ: 条件指定やソート、関連データ取得など、柔軟なクエリ構築
より詳しい情報や最新の機能については、以下から公式ドキュメントをご確認ください。
- GORM公式ドキュメント (英語)
- GORM公式ドキュメント (日本語)
- 実践コードサンプルはこちら：GitHubリポジトリ（※リンクは本記事作成時点の最新バージョンを指す）
注意: 2026年の技術情報は現時点では検証が困難であり、将来的な技術変更に備えて公式ドキュメントやリリースノートを定期的に確認してください。