GO通过ODBC方式连接到GBase 8s数据库，已知有两个插件alexbrainman/odbc和weigj/go-odbc。相对而言：alexbrainman/odbc近一年内有更新。

操作系统：CentOS 7.8 64-bit
软件需求：
GBase 8s CSDK 3.0.0
unixODBC 2.3.1(建议升级到2.3.7)

1，系统环境确认

1.1 unixODBC版本

Linux下root用户通过rpm确认unixODBC、unixODBC-devel均已经安装，如下：

[root@localhost ~]# rpm -qa unixODBC unixODBC-devel
unixODBC-devel-2.3.1-14.el7.x86_64
unixODBC-2.3.1-14.el7.x86_64

如果没有安装，通过yum源安装

[root@localhost ~]# yum -y install unixODBC unixODBC-devel

1.2 GBase 8s CSDK已经安装

手工安装CSDK或者解压包的方式安装CSDK。
加载GBase 8s CSDK需要的环境变量，包含连接到GBase 8s数据库所需的GBASEDBTDIR、PATH、LD_LIBRARY_PATH。同时准备ODBCINI环境变量。环境变量内容可写入到/etc/profile中。

# 增加到/etc/profile中
# GBase 8s CSDK安装目录
export GBASEDBTDIR=/opt/gbase
export PATH=$GBASEDBTDIR/bin:$PATH
  
export LD_LIBRARY_PATH=$GBASEDBTDIR/lib:$GBASEDBTDIR/lib/cli:$GBASEDBTDIR/lib/esql:$LD_LIBRARY_PATH
# ODBCINI
export ODBCINI=/root/odbc.ini

Linux下通过esql -V命令确认GBase 8s CSDK已经安装，如下：

[root@localhost ~]# check_version csdk
Currently installed version: 4.10.FC4G1_3.0.0
Previous latest version: 4.10.FC4G1
You have installed a newer version of ClientSDK over an older version

在sqlhosts中配置相应的数据库连接信息

[root@localhost ~]# cd /opt/gbase/etc/
[root@localhost etc]# more sqlhosts
gbase01 onsoctcp a02.gbasedbt.com 9088

2，ODBC配置

2.1 ODBC配置文件

修改ODBCINI配置文件，增加GBase 8s数据库连接信息，特别注意需要的环境变量都加上。

;---------------------------------------------------------------------------
; GBase ODBC Sample File
;
; File:        odbc.ini
;
;---------------------------------------------------------------------------
[ODBC Data Sources]
utf8=GBase ODBC DRIVER
;
; Define ODBC Database Driver's Below - Driver Configuration Section
;
[utf8]
Driver=/opt/gbase/lib/cli/iclis09b.so
Description=GBase ODBC DRIVER
Database=testdb
LogonID=gbasedbt
pwd=GBase123
Servername=gbase01
CursorBehavior=0
CLIENT_LOCALE=zh_CN.utf8
DB_LOCALE=zh_CN.utf8
TRANSLATIONDLL=/opt/gbase/lib/esql/igo4a304.so
;
; UNICODE connection Section
;
[ODBC]
;uncomment the below line for UNICODE connection
; 特别注意修改这里，使用unicode
UNICODE=UCS-2
;
; Trace file Section
;
Trace=0
TraceFile=/tmp/odbctrace.out
InstallDir=/opt/gbase
TRACEDLL=idmrs09a.so

2.2 验证ODBC配置

通过isql命令检查ODBC配置

[root@localhost ~]# isql -v utf8
+---------------------------------------+
| Connected!                            |
|                                       |
| sql-statement                         |
| help [tablename]                      |
| quit                                  |
|                                       |
+---------------------------------------+
SQL> select dbservername::varchar(40) from dual;
+-----------------------------------------+
|                                         |
+-----------------------------------------+
| gbase01                                 |
+-----------------------------------------+
SQLRowCount returns -1
1 rows fetched

3，安装GO和ODBC

3.1 安装GO

yum源增加epel源。

[root@localhost ~]# yum -y install epel-release

通过yum安装golang

[root@localhost ~]# yum -y install golang

查看golang的版本

[root@localhost ~]# go version
go version go1.17.7 linux/amd64

3.2 安装ODBC(alexbrainman) (选项一，推荐)

自动安装ODBC，将会安装在$GOPATH/pkg目录下

[root@localhost ~]# go get github.com/alexbrainman/odbc

3.3 安装GO-ODBC（选项二）

在$GOROOT/src目录下安装GO-ODBC
注：GOROOT的位置为/usr/lib/golang
GO-ODBC的下载地址：git://github.com/weigj/go-odbc.git
由于某些原因，如果无法通过git访问，也可以使用https://gbasedbt.com/dl/go-odbc/go-odbc.zip

[root@localhost ~]# cd /usr/lib/golang/src
 
[root@localhost src]# git clone git://github.com/weigj/go-odbc.git odbc
# 如果无法git clone, 则使本地zip包  
[root@localhost src]# wget https://gbasedbt.com/dl/go-odbc/go-odbc.zip --no-check-certificate
[root@localhost src]# unzip go-odbc.zip 
 
[root@localhost src]# cd odbc
 
[root@localhost odbc]# go install
 
[root@localhost odbc]# go list
odbc

4，编写程序测试

4.1 编写测试脚本程序TestGoOdbc.go

在GOPATH目录下创建TestGoOdbc.go测试程序

[root@localhost ~]# go env | grep GOPATH
GOPATH="/root/go"
[root@localhost ~]# mkdir -p /root/go && cd /root/go

脚本程序内容如下：

package main

import (
        "database/sql"
        "fmt"
        // 使用 go-odbc
        // _ "odbc/driver"
        // 使用 alexbrainman/odbc
        _ "github.com/alexbrainman/odbc"
)

func main() {
        fmt.Printf("%s\n\n", "GO ODBC测试程序开始运行.")
        // 对于 CM 和直连，使用 DSN 方式；若是直连，可使用 DSN-LESS 方式
        conn, err := sql.Open("odbc", "DSN=utf8;UID=gbasedbt;PWD=GBase123;")
        if err != nil {
                fmt.Println(err)
                fmt.Println("链接错误")
                return
        }
        defer conn.Close()
        fmt.Printf("%s\n\n", "构建查询")
        stmt, err := conn.Prepare("select tabid,tabname from systables where tabid < ?")
        if err != nil {
                fmt.Println("查询异常：", err)
                return
        }
        defer stmt.Close()
        row, err := stmt.Query(11)
        if err != nil {
                fmt.Println("查询错误：", err)
        }
        defer row.Close()
        fmt.Printf("%s\n", "数据集显示")
        for row.Next() {
                var tabid int
                var tabname string
                if err := row.Scan(&tabid,&tabname); err == nil {
                        fmt.Printf("%d\t%s\n",tabid,tabname)
                }
        }
        fmt.Printf("\n%s\n", "GO ODBC测试程序结束运行.")
        return
}

4.2 执行测试程序

[root@localhost go]# go run TestGoOdbc.go
GO ODBC测试程序开始运行.

构建查询

数据集显示
1    systables
2    syscolumns
3    sysindices
4    systabauth
5    syscolauth
6    sysviews
7    sysusers
8    sysdepend
9    syssynonyms
10    syssyntable
11    sysconstraints
12    sysreferences

GO ODBC测试程序结束运行.

注：该文档是对之前的 Linux下GO通过ODBC连接到GBase 8s数据库 文档的改进。