GORM簡(jiǎn)介

GORM 是 Go 語(yǔ)言中最受歡迎的 ORM 庫(kù)之一，它提供了強(qiáng)大的功能和簡(jiǎn)潔的 API，讓數(shù)據(jù)庫(kù)操作變得更加簡(jiǎn)單和易維護(hù)。本文將詳細(xì)介紹 GORM 的常見(jiàn)用法，包括數(shù)據(jù)庫(kù)連接、模型定義、CRUD、事務(wù)管理等方面，幫助大家快速上手使用 GORM 進(jìn)行 Web 后端開(kāi)發(fā)。

安裝

通過(guò)如下命令安裝 GORM：

$ go get -u gorm.io/gorm

你也許見(jiàn)過(guò)使用 go get -u github.com/jinzhu/gorm 命令來(lái)安裝 GORM，這個(gè)是老版本 v1，現(xiàn)已過(guò)時(shí)，不建議使用。新版本 v2 已經(jīng)遷移至 github.com/go-gorm/gorm 倉(cāng)庫(kù)下。

快速開(kāi)始GORM使用

如下示例代碼帶你快速上手 GORM 的使用：

package main
import (
    "gorm.io/driver/sqlite"
    "gorm.io/gorm"
)
// Product 定義結(jié)構(gòu)體用來(lái)映射數(shù)據(jù)庫(kù)表
type Product struct {
    gorm.Model
    Code  string
    Price uint
}
func main() {
    // 建立數(shù)據(jù)庫(kù)連接
    db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})
    if err != nil {
        panic("failed to connect database")
    }
    // 遷移表結(jié)構(gòu)
    db.AutoMigrate(&Product{})
    // 增加數(shù)據(jù)
    db.Create(&Product{Code: "D42", Price: 100})
    // 查找數(shù)據(jù)
    var product Product
    db.First(&product, 1)                 // find product with integer primary key
    db.First(&product, "code = ?", "D42") // find product with code D42
    // 更新數(shù)據(jù) - update product's price to 200
    db.Model(&product).Update("Price", 200)
    // 更新數(shù)據(jù) - update multiple fields
    db.Model(&product).Updates(Product{Price: 200, Code: "F42"}) // non-zero fields
    db.Model(&product).Updates(map[string]interface{}{"Price": 200, "Code": "F42"})
    // 刪除數(shù)據(jù) - delete product
    db.Delete(&product, 1)
}

提示：這里使用了 SQLite 數(shù)據(jù)庫(kù)驅(qū)動(dòng)，需要通過(guò) go get -u gorm.io/driver/sqlite 命令安裝。

將以上代碼保存在 main.go 中并執(zhí)行。

$ go run main.go

執(zhí)行完成后，我們將在當(dāng)前目錄下得到 test.db SQLite 數(shù)據(jù)庫(kù)文件。

① 進(jìn)入 SQLite 命令行。

② 查看已存在的數(shù)據(jù)庫(kù)表。

③ 設(shè)置稍后查詢(xún)表數(shù)據(jù)時(shí)的輸出模式為按列左對(duì)齊。

④ 查詢(xún)表中存在的數(shù)據(jù)。

有過(guò)使用 ORM 框架經(jīng)驗(yàn)的同學(xué)，以上代碼即使我不進(jìn)行講解也能看懂個(gè)大概。

這段示例代碼基本能夠概括 GORM 框架使用套路：

• 定義結(jié)構(gòu)體映射表結(jié)構(gòu)：Product 結(jié)構(gòu)體在 GORM 中稱(chēng)作「模型」，一個(gè)模型對(duì)應(yīng)一張數(shù)據(jù)庫(kù)表，一個(gè)結(jié)構(gòu)體實(shí)例對(duì)象對(duì)應(yīng)一條數(shù)據(jù)庫(kù)表記錄。
• 連接數(shù)據(jù)庫(kù)：GORM 使用 gorm.Open 方法與數(shù)據(jù)庫(kù)建立連接，連接建立好后，才能對(duì)數(shù)據(jù)庫(kù)進(jìn)行 CRUD 操作。
• 自動(dòng)遷移表結(jié)構(gòu)：調(diào)用 db.AutoMigrate 方法能夠自動(dòng)完成在數(shù)據(jù)庫(kù)中創(chuàng)建 Product 結(jié)構(gòu)體所映射的數(shù)據(jù)庫(kù)表，并且，當(dāng) Product 結(jié)構(gòu)體字段有變更，再次執(zhí)行遷移代碼，GORM 會(huì)自動(dòng)對(duì)表結(jié)構(gòu)進(jìn)行調(diào)整，非常方便。不過(guò)，我不推薦在生產(chǎn)環(huán)境項(xiàng)目中使用此功能。因?yàn)閿?shù)據(jù)庫(kù)表操作都是高風(fēng)險(xiǎn)操作，一定要經(jīng)過(guò)多人 Review 并審核通過(guò)，才能執(zhí)行操作。GORM 自動(dòng)遷移功能雖然理論上不會(huì)出現(xiàn)問(wèn)題，但線上操作謹(jǐn)慎為妙，個(gè)人認(rèn)為只有在小項(xiàng)目或數(shù)據(jù)不那么重要的項(xiàng)目中使用比較合適。
• CRUD 操作：遷移好數(shù)據(jù)庫(kù)后，就有了數(shù)據(jù)庫(kù)表，可以進(jìn)行 CRUD 操作了。

更換第三方SQLite驅(qū)動(dòng)解決

最近在開(kāi)發(fā)一個(gè)程序時(shí)用到GORM來(lái)操作SQLite數(shù)據(jù)庫(kù)，GORM默認(rèn)使用gorm.io/driver/sqlite這個(gè)庫(kù)作為SQLite驅(qū)動(dòng)，該庫(kù)用CGO實(shí)現(xiàn)，在使用過(guò)程中遇到一些問(wèn)題，最后更換第三方SQLite驅(qū)動(dòng)解決。

問(wèn)題

正是因?yàn)镚ORM官方SQLite驅(qū)動(dòng)使用CGO實(shí)現(xiàn)，因此我在使用過(guò)程中遇到以下錯(cuò)誤：

[error] failed to initialize database, got error Binary was compiled with 'CGO_ENABLED=0', go-sqlite3 requires cgo to work. This is a stub panic: Binary was compiled with 'CGO_ENABLED=0', go-sqlite3 requires cgo to work. This is a stub

大致意思是GORM SQLite驅(qū)動(dòng)使用了CGO實(shí)現(xiàn)，需要在CGO環(huán)境下才能工作。

那么解決方法也很簡(jiǎn)單，只需要修改CGO_ENABLED這個(gè)環(huán)境變量啟用CGO支持即可：

go env -w CGO_ENABLED=1

啟用CGO后，編譯的是動(dòng)態(tài)鏈庫(kù)的二進(jìn)制文件，那么你一旦更換平臺(tái)，比如將程序放到Windows下運(yùn)行，可能因?yàn)槿鄙傧嚓P(guān)的一些動(dòng)態(tài)鏈庫(kù)（比如：SQLite）從而無(wú)法運(yùn)行，為了保持編譯的二進(jìn)制文件能夠無(wú)動(dòng)態(tài)依賴(lài)的情況下正常運(yùn)行，因此不得不考慮靜態(tài)編譯，所以就和GORM SQLite驅(qū)動(dòng)產(chǎn)生了沖突。

解決方案：更換GORM默認(rèn)的SQLite驅(qū)動(dòng)

在GORM官方的Issues發(fā)現(xiàn)也有人反饋此類(lèi)問(wèn)題，于是順藤摸瓜，找到了github.com/glebarez/sqlite這個(gè)庫(kù)，該庫(kù)使用純go實(shí)現(xiàn)，不依賴(lài)CGO，地址是：https://github.com/glebarez/sqlite

于是將官方的驅(qū)動(dòng)：

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

更換為：

import (
    "github.com/glebarez/sqlite"
    "gorm.io/gorm"
)

這樣就可以在不依賴(lài)CGO的情況下編譯出靜態(tài)二進(jìn)制文件，從而解決跨平臺(tái)依賴(lài)動(dòng)態(tài)鏈庫(kù)的問(wèn)題。

代價(jià)

• glebarez/sqlite性能不及官方驅(qū)動(dòng)，但犧牲少部分性能來(lái)?yè)Q取方便個(gè)人覺(jué)得還是值得的，如果沒(méi)有跨平臺(tái)需求，使用官方默認(rèn)驅(qū)動(dòng)即可
• 靜態(tài)編譯打包后的文件體積明顯增加

以上就是更換GORM默認(rèn)SQLite驅(qū)動(dòng)出現(xiàn)的問(wèn)題解決分析的詳細(xì)內(nèi)容，更多關(guān)于更換GORM默認(rèn)SQLite驅(qū)動(dòng)的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論