GORM on Go言語用ポストイット

Go言語で簡単にDBアクセスを実現！GORMを使ってORMを体験しよう-Create編(2)

Thu, 13 Apr 2023 08:30:23 +0900

はじめに

以下の 2 つのエントリで Go 言語で利用可能な O/R マッパーである GORM の概要、導入方法、基本的な使い方とデータの登録方法について学びました。

今回は前回のデータ登録 Create で説明しきれなかった登録機能とアソシエーション(テーブル同士の関連)の設定されているデータの登録方法を学びます。

また、 default キーワードを使ってカラムを作成したときにハマるケースについても説明します。

「Belongs To」アソシエーションと関連モデルの登録方法

belongs to アソシエーションは１対１のモデル関係を表現する際に使用されます。

特に、一方のモデルがもう一方に「属する」 ( 依存している ) 関係を表現します。

例をあげます。

作成中のアプリケーションに users と companies という 2 つのモデルがあるとします。 users モデルは必ず companies テーブルのレコードに依存しているとします。

このような状況で users テーブルと companies テーブルにデータを登録する処理を、 GORM のコードで記述してみます。 ( データベース環境の用意を省略するために、今回は SQLite を使用しています )

Go言語で簡単にDBアクセスを実現！GORMを使ってORMを体験しよう-Create編(1)

Wed, 12 Apr 2023 08:30:47 +0900

はじめに

前回は GORM の導入方法と基本的な機能を紹介しました。

Go 言語で簡単に DB アクセスを実現！GORM を使って ORM を体験しよう-導入編 | Go 言語用ポストイット

gorm.Open 関数を呼び出した結果、取得される gorm.DB インスタンス ( インスタンスと呼んでいいのか Go 言語の思想がわからませんが ) のメソッドを使って様々な操作を行うことができます。

今回は Create (登録処理)に関するさまざまな機能を紹介します。

Create ( 登録 )

gorm.DB#Create() を使います。

サンプルコードを以下に記載します。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29


package main

import (
	"fmt"
	"time"

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

type User struct {
	gorm.Model
	Name string
	Age uint
	Biarthday time.Time
}

func main() {
	db, _ := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})

	db.AutoMigrate(&User{})

	user := User{Name: "Jinzhu", Age: 18, Biarthday: time.Now()}
	result := db.Create(&user)

	fmt.Printf("%+v\n", user.ID) // Value of user.ID is 1
	fmt.Printf("%+v\n", result.Error) // Value of result.Error is nil
	fmt.Printf("%+v\n", result.RowsAffected) // Value of result.RowsAffected is 1
}

gorm.DB#Create() を実行した結果は「戻り値」と「引数で指定した構造体(のポインタ)」から取得できます。

Go言語で簡単にDBアクセスを実現！GORMを使ってORMを体験しよう-導入編

Tue, 11 Apr 2023 08:48:37 +0900

はじめに

Go 言語上で SQL を発行せずに DB アクセスを実現するための GORM というライブラリを触ってみます。

GORM は Go 言語上で SQL を発行せずに DB アクセスを実現するための O/R マッパーライブラリです。特徴として、アソシエーション機能、イベントフック、トランザクションなどが提供されています。本記事では、GORM の基本的な使い方を紹介し、次回以降に登録・更新・削除操作に踏み込んで行きたいと思っています。

検証環境

1
2
3
4
5


$ go version
go version go1.20.2 darwin/arm64

$ grep 'gorm.io/gorm' go.mod
	gorm.io/gorm v1.24.6 // indirect

GORM とは？

名前から推測できる通り、GO 言語で使える O/R マッパーライブラリです。

特徴

O/R マッパーとして提供されている他言語のライブラリと同じような機能が提供されています。
アソシエーション機能 ( Has one、Has many、Belongs to、Many to many、Polymorphism などなど )
イベントフック ( 利用できるトリガは Before、After create、S;ve、Update、Delete、Find など )
トランザション、ネスティッドトランザクション、セーブポイントにロールバック、コミット
プリペアドステートメント
バッチインサート
SQL ビルド
Upsert、Lock、インデックスヒント
マイグレーション
ロギング

インストール方法

go mod init 、 go mod tidy を実行し、ディレクトリ配下に go.mod ファイルが存在している状態であれば、以下のコマンドを実行するだけでインストールできます。