golang访问KingbaseES V8R6

概述

本文介绍go语言连接KingbaseES V8R6数据库的步骤

测试环境

操作系统：CentOS 7.2.1511
数据库版本：KINGBASE (KingbaseES) V008R006C007B0012
go版本：go version go1.19.4 linux/amd64

KingbaseES go驱动获取

go连接kingbase数据库需要该数据库的go驱动，驱动位于Kingbase数据库安装目录Interface/golang子目录下：

另外，驱动版本需要与go编译运行环境版本一致，本人测试环境的go版本为：1.19.4

kingbase自带的 go驱动版本为：1.11.5

注意：驱动编译的go环境版本，和本地go版本不一致，后面应用go代码编译时会报错，需要换对应版本的kingbase go驱动。

go 1.19.4版本kingbase go驱动编译

用Kingbase的go驱动源码重新编译对应版本go驱动：
1、获取驱动源码包: gokb-source.tar.gz
2、解压驱动源码压缩包到当前路径：

源码位于解压后的kingbase.com/gokb文件夹内：

3、kingbase go驱动包含gokb.a、oid.a、scram.a 3个静态库文件需要重新编译
1）编译gokb.a

2)编译oid.a

3)编译scram.a

静态库形式驱动使用

1、新建drivers目录(Note: 目录名可以随便命起，编译时指定对路径即可)以及和kingbase自带驱动一样的子目录存放新编译的驱动
mkdir -p ~/drivers/kingbases.com/gokb/

新建/home/kingbase/gotest目录，存放go测试代码gotest.go，简单测试代码的功能为连接位于192.168.40.101上的Kingbase ES V8R6数据库，端口：54321，连接成功打印connection test success!到控制台

[kingbase@oracle gotest]$ pwd
/home/kingbase/gotest
[kingbase@oracle gotest]$ cat gotest.go 

package main

import (
	"database/sql"
	"fmt"
	_ "kingbase.com/gokb"
)

func main() {
connStr := "host=192.168.40.101 user=system password=111111 dbname=test sslmode=disable"
db, err := sql.Open("kingbase", connStr)
err = db.Ping()

if err != nil {
	fmt.Println(err)
		return
	}
fmt.Println("Connection test success!")

if db != nil {
	db.Close()
		}

}
[kingbase@oracle gotest]$

生成go.mod:

[kingbase@oracle gotest]$ ls
gokb-source.tar.gz  gotest.go
[kingbase@oracle gotest]$ go mod init example.com/gotest
go: creating new go.mod: module example.com/gotest
go: to add module requirements and sums:
	go mod tidy
[kingbase@oracle gotest]$ cat go.mod 
module example.com/gotest

go 1.19
[kingbase@oracle gotest]$ 

编译gotest.go

使用静态库时，不能直接使用 go run 或者 go build 命令，这样无法正确链接库。
需要手动指定导入库的路径和需要链接库的路径。如下所示:
编译生成gotest.o：

链接生成可执行文件：

执行连库测试程序：

源码形式驱动使用

Kingbase自带的驱动只有1个版本，与本地环境未必一致，下面再介绍下，直接引用驱动源码连库的方法

1、把go驱动源码kingbase.com文件夹放入gopath所在路径（本人路径为/home/kingbase/go/src）

2、使用go mod edit命令编辑go.mod，让gotest.go程序可以找到驱动的位置
go mod edit -replace kingbase.com/gokb=驱动源码所在实际路径
例：
go mod edit -replace kingbase.com/gokb=/home/kingbase/go/src/kingbase.com/gokb

go mod edit执行完成后，go.mod中会增加一行：

replace kingbase.com/gokb => /home/kingbase/go/src/kingbase.com/gokb

再执行go mod tidy

执行完，go.mod会增加一行：
require kingbase.com/gokb v0.0.0-00010101000000-000000000000

直接使用源码，可以不用编译，接下来就可以直接用go run命令执行测试程序

以上内容，简单介绍了使用go语言连接kingbase数据库，希望对大家有用，谢谢！

参考资料：
https://pkg.go.dev/cmd/go#hdr-Compile_packages_and_dependencies

https://go.dev/doc/tutorial/call-module-code