金仓数据库KingbaseES V8R3使用Gorm指南

 【关键工具】gorm

1.概述

1.1 gorm说明

Gorm，一个神奇的，对开发人员友好的 Golang ORM 库

• 全功能 ORM
• 关联 (Has One，Has Many，Belongs To，Many To Many，多态，单表继承)
• Create，Save，Update，Delete，Find 中钩子方法
• 支持 Preload、Joins 的预加载
• 事务，嵌套事务，Save Point，Rollback To Saved Point
• Context，预编译模式，DryRun 模式
• 批量插入，FindInBatches，Find/Create with Map，使用 SQL 表达式、Context Valuer 进行 CRUD
• SQL 构建器，Upsert，数据库锁，Optimizer/Index/Comment Hint，命名参数，子查询
• 复合主键，索引，约束
• Auto Migration
• 自定义 Logger
• 灵活的可扩展插件 API：Database Resolver（多数据库，读写分离）、Prometheus…
• 每个特性都经过了测试的重重考验
• 开发者友好

1.2 安装

首先，需要安装golong,且配置了GOPATH环境变量。

在联网环境下，执行 go get -u github.com/jinzhu/gorm和go get -u github.com/lib/pq获取源码包。（若设置了代理，执行git config --global --unset https.proxy取消代理）

离线环境下，解压压缩包到GOPATH目录下。

1.3 导入说明

import (

    "fmt"

    "github.com/jinzhu/gorm"

    _ "github.com/jinzhu/gorm/dialects/postgres"

)

1.4 编译说明

执行go build或go run 命令编译测试案例

go build test.go;./test 或 go run test.go

2.管理连接

2.1 建立连接

const (

       host     = "192.168.6.128"

       port     = 54321

       user     = "system"

       password = "123456"

       dbname   = "test"

) //全局常量

//连接串

connInfo := fmt.Sprintf("host=%s port=%d user=%s password=%s dbname=%s sslmode=disable",host, port, user, password, dbname)

//连接数据库

db, err := gorm.Open("postgres", connInfo)

if err!= nil{

    panic(err)

}

defer db.Close()

2.2 关闭连接

db.Close()

2.3 连接池

GORM 使用 database/sql 维护连接池，dotabase/sql包中实现了通用的连接池。

sqlDB, err := db.DB()

// SetMaxIdleConns 设置空闲连接池中连接的最大数量

sqlDB.SetMaxIdleConns(10)

// SetMaxOpenConns 设置打开数据库连接的最大数量。

sqlDB.SetMaxOpenConns(100) 

// SetConnMaxLifetime 设置了连接可复用的最大时间。

sqlDB.SetConnMaxLifetime(time.Hour)

3.CURD接口

3.1 模型定义

模型是标准的 struct，由 Go 的基本数据类型。默认情况下，GORM 使用 ID 作为主键，使用结构体名的 蛇形复数 作为表名，字段名的 蛇形 作为列名

通过tag标记gorm来创建在数据库中字段的约束和属性配置

// UserInfo 结构

type UserInfo struct {

ID uint       `gorm:"primary_key;AUTO_INCREMENT"`

UserId uint   `gorm:"not null;index:idx_user_id"`

    Name string 

    Age int

    Sex string

    Hobby string

}

gorm定义	数据库字段约束
gorm:"primary_key"	字段设置为主键
gorm:"AUTO_INCREMENT"	字段设置为自增
gorm:"size:20	字段长度设置为20
gorm:"index:idx_user_id	字段设置普通索引，名称为idx_user_id
gorm:"not null	设置字段为非空
gorm:"type:varchar(64)"	设置字段为varchar类型，长度为64
gorm:"column:remark"	设置数据库字段名为remark
gorm:"-"	忽略此字段，不在表中创建该字段
gorm:"default:'默认'"	设置字段的默认值

3.2 迁移建表

AutoMigrate 用于自动迁移schema，保持schema 是最新的。

db.AutoMigrate(&UserInfo{})

注：在gorm中，表名创建是以复数存在的插入，创建表名为user_infos

3.3 创建记录

    u1 := UserInfo{1, "王武", 17, "男", "篮球"}

    u2 := UserInfo{2, "张佳", 15, "女", "乒乓"}

    u3 := UserInfo{3, "李白", 16, "男", "足球"}

    db.Create(&u1)

    db.Create(&u2)

    db.Create(&u3)

3.4 查询

    // First查询第一条记录

    var u = new(UserInf)

    db.First(u)

    fmt.Printf("%d, %d, %s, %s, %s\n", u.ID, u.UserId, u.Name,u.Sex,u.Hobby)

    //Find查询 ID=2

    var uu UserInf

    db.Find(&uu,2)

    fmt.Printf("%d, %d, %s, %s, %s\n\n", uu.ID, uu.UserId,uu.Name,uu.Sex,uu.Hobby)

    //查询多个记录

    var users []UserInf = make([]UserInf, 3)

    db.Where("user_id > ?", 0).Order("ID").Find(&users)

    for _,user := range users {

             fmt.Printf("%d, %d, %s, %d, %s, %s\n", user.ID, user.UserId,user.Name,user.Age, user.Sex,user.Hobby)

    }

3.5 更新

// Update更新
var u = new(UserInf)   
db.Model(&u).Update("hobby", "双色球")

// Save更新所有字段
u.Hobby = "篮球"
	u.Age = 20
	db.Save(&u)

3.6 删除

//单个结构删除

db.Delete(&u)

//批量删除

db.Where("ID>=?",0).Delete(UserInf{})