Go言語のORMライブラリ – GORM：詳細な使い方について解説

はじめに
GORMとは？
GORMのインストール
GORMを使った基本的なCRUD操作
リレーションの取り扱い
トランザクションの管理
まとめ

はじめに

今回は、Goの世界で注目を集めているORMライブラリ、GORMの使い方を深堀りしていきたいと思います。これからGORMの基本的な概念、CRUD操作、リレーション、トランザクションの取り扱いなど、具体的なコードサンプルとともに詳しく解説していきます。

goについてはこちらも参考にしてください

流行りに乗ってGo言語を使ってみた（インストールからHelloWorld表示まで）

Go言語とは 2009年、GoogleでRobert Griesemer、ロブ・パイク、ケン・トンプソンによって設計された。Goは、静的型付け、C言語の伝統に則ったコンパイル言語、メモリ安全性、ガベージコレクション、構造的型付け（英語版）、...

GORMとは？

GORMは、Go言語用のORM（Object-Relational Mapping）ライブラリです。GORMは、開発者がSQLクエリを直接書く代わりに、より直感的で安全なGoのAPIを通じてデータベースとのやり取りを行えるようにします。

GORMのインストール

GORMのインストールは、go getコマンドを用いて簡単に行うことができます。

go get -u gorm.io/gorm

使用するデータベースによって必要なドライバーについてもインストールします

今回はsqliteを使います

go get gorm.io/driver/sqlite

GORMを使った基本的なCRUD操作

データベースのCRUD（Create, Read, Update, Delete）操作を直感的に行うことができます。以下に、シンプルなUser構造体に対するCRUD操作の例を示します。

package main

import (
	"gorm.io/driver/sqlite"
	"gorm.io/gorm"
)

type User struct {
	gorm.Model
	Name  string
	Email string
}

func main() {
	db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})
	if err != nil {
		panic("failed to connect database")
	}

	// Migrate the schema
	db.AutoMigrate(&User{})

	// Create
	db.Create(&User{Name: "John", Email: "john@example.com"})

	// Read
	var user User
	db.First(&user, 1) // find user with id 1
	db.First(&user, "name = ?", "John") // find user with name John

	// Update - update user's email
	db.Model(&user).Update("Email", "john@newexample.com")

	// Delete - delete user
	db.Delete(&user)
}

この例では、まずgorm.Open()関数を使ってデータベースに接続します。次に、db.AutoMigrate(&User{})でデータベーススキーマを自動的に移行します。そして、db.Create(),db.First(),db.Model().Update(),db.Delete()関数を使ってCRUD操作を行います。

以上がGORMの基本的な使い方の一部です。この他にもリレーションの取り扱いやトランザクションの管理など、GORMにはさまざまな機能があります。

リレーションの取り扱い

一対一、一対多、多対多の各種リレーションを簡単に扱うことができます。例えば、Userが複数のBookを所有しているという一対多のリレーションを以下のように表現できます。

type User struct {
	gorm.Model
	Name  string
	Email string
	Books []Book
}

type Book struct {
	gorm.Model
	Title  string
	UserID uint
}

GORMではリレーションを表現するために、親モデル内に子モデルのスライスを含めます。また、子モデルには親モデルへの参照（ここではUserID）を含めます。

トランザクションの管理

データベース操作を行う際には、トランザクションを適切に管理することが重要です。GORMでは、Begin(), Commit(), Rollback()関数を使ってトランザクションを簡単に管理できます。

func main() {
	db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})
	if err != nil {
		panic("failed to connect database")
	}

	// Start a transaction
	tx := db.Begin()

	// Do some database operations
	...

	// Commit or rollback the transaction
	if err := tx.Commit().Error; err != nil {
		tx.Rollback()
	}
}

ここでは、db.Begin()を使ってトランザクションを開始します。そして、データベース操作の後に、tx.Commit()を使ってトランザクションをコミットします。もし何か問題が発生した場合には、tx.Rollback()を使ってトランザクションをロールバックします。