金仓数据库KingbaseES客户端编程接口指南-Gokb（2. 概述）

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 查看帮助说明。