2. 概述
2.1. 驱动说明
Gokb是基于database/sql包的、完全由Golang编写的kingbase驱动,它为数据库提供了轻量级的访问接口。
通常情况下,用户使用database/sql包,而不直接使用驱动包。驱动包提供了对具体操作的实现,而不对外提供其实现细节。
本章主要说明了Gokb如何使用以及使用时应当注意的情况。
2.2. 配置说明
首先,需要安装golang,且配置GOPATH环境变量。
将Gokb驱动解压后,把 kingbase.com 文件夹放在某个目录下,以下均以 ~/drivers 目录为例。
2.3. 查看版本信息
在kingbase.com文件夹下,执行命令 strings gokb.a |grep GOKBVersion
,即可查看驱动版本信息。如下图所示:
一般情况下,不同平台的驱动不能通用,但Windows版本的驱动也可以拷贝至Linux平台, 然后使用同样的方法查看版本信息。
2.4. 导入说明
Gokb实现了database/sql包的接口,因此,使用时需要导入database/sql包,还需要匿名导入驱动,如下所示:
import ( "database/sql" _ "kingbase.com/gokb" )
2.5. 编译说明
使用静态库时,不能直接使用 go run
或者 go build
命令,这样无法正确链接库。
需要手动指定导入库的路径和需要链接库的路径。如下所示,其中test.go为测试文件:
go tool compile -I ~/drivers/ test.go #指定导入库的路径 go tool link -L ~/drivers/ test.o #指定链接库的路径
更进一步的信息,可以通过执行 go tool compile
和 go tool link
查看帮助说明。