金仓数据库KingbaseES客户端编程接口指南-Gokb （3. 管理连接）

数据猿 2022-08-12

1059

3. 管理连接

我们可以使用以下语句连接到数据库：

connStr := "host=127.0.0.1 user=SYSTEM password=123456 dbname=TEST"
db, err := sql.Open("kingbase", connStr)
err = db.Ping()

和其他语言不同， Open 函数并不会建立连接，也不会验证连接参数。

Go语言使用惰性求值，仅在初次使用时才会建立连接，因此，需要使用 Ping 函数进行检查。

连接参数说明可参考下表。

表 3.1.25 连接参数说明
参数名	说明	备注
host	连接至的IP地址，也可以是UNIX domain socket	默认为localhost
port	端口号	默认为54321
user	登录的用户名
password	用户名的密码
dbname	连接至的数据库名
sslmode	是否使用SSL	默认开启使用;可选参数为``Disable, Require, verify-ca, verify-full``
sslcert	证书路径，必须包含PEM编码数据
sslkey	密钥文件路径，必须包含PEM编码数据
sslrootcert	根证书路径，必须包含PEM编码数据
connect_timeout	连接的最长等待时间，单位为秒	0值或未指定均为无限等待

连接参数之间以空格分隔，若参数值包含空格，需要使用''（单引号）将该值括起来。示例：

"user=SYSTEM password=123456 dbname=TEST sslmode=disable"

"user='space man' password='it\'s valid'"

要关闭与数据库的连接，只需要对数据库对象 db调用 Close 方法。

db.Close()

但db对象是为了长连接而设计的，如无必要，不要频繁调用 Open 和 Close 函数，尽量遵守database/sql库的设计准则。

database/sql包中实现了通用的连接池，只提供了非常简单的接口，除了限制连接数和设置生命周期外，基本没有定制选项。

db对象代表着0到多个底层连接的连接池，可以安全地被多个Go协程并发使用。

Go会自动创建并管理连接，也保持空闲的连接。

当调用Begin函数开启事务时，返回的对象才会绑定到单个连接上，调用Commit或Rollback后，该事务绑定的连接才会返回到连接池中。

「喜欢这篇文章，您的关注和赞赏是给作者最好的鼓励」

关注作者