Go驱动环境搭建

环境类

• Go环境配置
  用户需要在环境变量中配置以下参数：

  • GO111MODULE：用户使用在线导入的方式安装Go驱动时需要设置GO111MODULE为on。如果不希望进行go mod工程的改造，需将GO111MODULE设置为off，并手动下载依赖包。依赖包与驱动根目录和业务代码保持同级。
  • GOPROXY：用户使用在线导入时需配置包含Go驱动包的路径。
  • 用户可以根据自己场景参数配置Go其他相关环境变量。

  通过go env查看Go环境变量配置结果，并且查看Go版本是否在1.13或以上。

• Go驱动安装
  • 从发布包中获取Go驱动包到本地。包名为GaussDB-Kernel_数据库版本号_操作系统版本号_64bit_Go.tar.gz。解压后为Go驱动源码包。
  • 进入Go驱动代码根路径，执行go mod tidy下载相关依赖，需要在环境变量中配置GOPATH=${Go驱动依赖包存放路径}。
  • 若依赖已下载至本地，可以在go.mod里面添加一行“通过replace将Go驱动包替换为本地Go驱动包地址”，表示代码里面所有的import Go驱动包都是走本地路径， 同时依赖也不会从代理里下载。
  

  • 通过go mod tidy下载相关依赖时，可能会下载某个依赖的低版本，如果依赖的低版本存在漏洞，可以通过更改go.mod文件中对应依赖的版本号的方式，更新依赖到漏洞修复后的版本进行规避风险。
  • 用户不涉及驱动开发，调用Go 1.13版本或以上即可，runtime运行库需要更新至1.18版本及以上。

驱动类

在创建数据库连接时，需要传入数据库驱动名称“gaussdb”。

由于数据库的Go驱动当前不适配业界成熟的ORM框架（比如xorm），且无法与PostgreSQL的Go驱动共存，因此在创建数据库连接时，必须确保传入驱动名称的兼容性。

• 使用数据库的Go驱动连接postgres时，需要传入驱动名“postgresql”。
• 使用PostgreSQL的Go驱动连接postgres时，需要传入驱动名“postgres”。