Golang实践录：oracle数据库实践

本文在 Windows 7 64bit 系统上使用 golang 连接查询 oracle 数据库。

环境准备

前置条件：
安装mingw（取其gcc及库，因为要用cgo编译），安装git（取其bash）。安装oci。

oracle提供了编程接口，golang 有多个实现库，但均需依赖 oracle 的 instantclient。下载OCI：
https://www.oracle.com/database/technologies/instant-client/winx64-64-downloads.html 。
版本有 SDK 版本、Basic 版本。压缩包虽不同，但内含目录一致，解压到当前目录即可，拷贝到指定目录，示例：D:\oracle\instantclient。

PKG_CONFIG_PATH环境变量 (失败)

D:\mingw64\lib\pkg-config

执行echo $PKG_CONFIG_PATH查看目录，映射到 E:\Program Files\Git\mingw64\lib 下，不存在pkgconfig，创建之。

安装库

1、
获取oci8.pc。执行：

go get github.com/wendal/go-oci8
提示：
# pkg-config --cflags  -- oci8
Package oci8 was not found in the pkg-config search path.
Perhaps you should add the directory containing `oci8.pc'
to the PKG_CONFIG_PATH environment variable
No package 'oci8' found

无须理会错误，此处是下载源码，主要获取pkg-config.exe和oci8.pc文件。在下载包go-oci8的windows目录，将pkg-config.exe拷贝到git的bin目录，oci8.pc拷贝到 E:\Program Files\Git\mingw64\lib\pkgconfig 目录。

2、
再次执行：

go get github.com/wendal/go-oci8
提示：
# github.com/wendal/go-oci8
D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/../../../../x86_64-w64-mingw32/bin/ld.exe: cannot find -lclntsh
collect2.exe: error: ld returned 1 exit status

一说：把oci8.pc文件的lclntsh改为oci，修改后，再执行，通过。得到pkg\windows_amd64\github.com\wendal\go-oci8.a目录。

由作者说明得知，wendal是从mattn仓库fork得到的，也下载：

go get github.com/mattn/go-oci8

对比两者源码和生成的.a文件，mattn的文件也多，库也比较大。但对比使用者而言无区别。为安全起见，实际工程使用 mattn 库。

3、
oci8.pc内容：

#prefix=D:/oracle/instantclient
includedir=D:/oracle/instantclient/sdk/include
libdir=D:/oracle/instantclient/sdk/lib/msvc

Name: oci8
Description: Oracle Instant Client
Version: 19.8
Cflags: -I${includedir}
Libs: -L${libdir} -loci

注：使用全路径，不使用prefix（因为git安装的目录带有空格），将库修改为oci。

4、
编写测试代码。go build 出错：

# command-line-arguments
D:\go\pkg\tool\windows_amd64\link.exe: running gcc failed: exit status 1
D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/../../../../x86_64-w64-mingw32/bin/ld.exe: cannot find -loci
collect2.exe: error: ld returned 1 exit status

猜想：官方oci是.lib格式，gcc不认。而golang的驱动得到.a但没有包括oci里面的函数。将得到的go-oci8.a改名为liboci.a，再次go build，提示未定义的函数，用nm查之，函数前为U，猜测格式不对。

$ pkg-config --cflags -- oci8
-ID:/oracle/instantclient/sdk/include

在D:\oracle\instantclient目录找oci.dll，放到临时目录。从dll生成.a。

$ gendef.exe oci.dll  # 注：从dll生产def（下一步要用到）
 * [oci.dll] Found PE image
 
$ dlltool.exe -D oci.dll -d oci.def -l liboci.a # 从dll和def生成.a文件。

生成的文件为liboci.a，可用nm查函数，已有定义。将其放到mingw的lib目录（这样就不用再额外设置路径），本文为 D:\mingw64\lib 。

5、
疑惑1：
似乎golang生成的go-oci8.a没什么用，可能内部链接了里面的函数，但最终的oci函数，还是从官方的oci库中获取，如OCIStmtPrepare。
疑惑2：
在go get github.com/mattn/go-oci8处，会使用pc文件指定的参数，但似乎只针对头文件，也没有链接，具体未详细研究（因为.lib和.a格式已然不同，不通用，链接不上的，没报错，应该没链接）。

源码

package main

import (
	"database/sql"
	"log"
	"errors"
    // 导入mysql驱动
    _ "github.com/mattn/go-oci8"
)

func CreateOracle(dbstr string) (sqldb *sql.DB, err error) {
    sqldb, err = sql.Open("oci8", dbstr)
	if err != nil {
		return nil, errors.New("open database failed: " + err.Error())
	}
	err = sqldb.Ping()
	if err != nil {
		return nil, errors.New("connect database failed: " + err.Error())
	}
	log.Println("connect to oracle ok")
    //log.Println("connect to ", dbParam.server, dbParam.database, "ok")
    
    return
}

func GetVersion(sqldb *sql.DB) () {
	// 降序，最新的在前面
	results, err := sqldb.Query("select version, codetype, addtime from tablevesion order by tablevesion desc")
	if err != nil {
		fmt.Println("Query error: ", err)
		return
	}
	for results.Next() {
		var item1, item2, item3 sql.NullString
		err := results.Scan(&item1, &item2, &item3)
		if err != nil {
			fmt.Println("scan error: ", err)
			break
		}

		if (!item1.Valid || !item2.Valid || !item3.Valid) {
			continue
		}

		fmt.Println(item1.String, item2.String, item3.String)
	}

	return
}

var dbstr = "latelee/123456789@192.168.18.188:1521/mydb"
func main() {
    fmt.Println("oracle test")
    
    SQLDB, err := CreateOracle(dbstr)
    if err != nil {
        fmt.Println("open db failed", err)
        return
    }
    GetVersion(SQLDB)
}

参考资料

参考资料：
https://www.cnblogs.com/good-temper/p/3791874.html
https://blog.csdn.net/yh_coco/article/details/78068610