连接数据库
使用Go驱动时，调用Go sql的标准接口open创建数据库连接，返回一个连接对象，传入驱动名称和描述字符串。
函数原型
Go驱动提供了如下的方法用于生成一个数据库连接对象。
func Open(driverName, dataSourceName string) (*DB, error)
参数说明：
- driverName为驱动的名称，数据库的驱动名称为“gaussdb”。
- dataSourceName为连接的数据源，支持DSN和URL两种：
- DSN格式：key1 = value1 key2 = value2 …，每组关键字间使用空格隔开，等号左右的空格是可选的。
- URL格式：driverName://[userspec@][hostspec][/dbname][?paramspec]，
其中，driverName为驱动名称，数据库的驱动名称为“gaussdb”。
userspec表示user[:password]，需要注意的是使用URL进行连接时，密码中不可包含URL串中的分隔符。如果密码中包含分隔符的话，建议采用DSN格式。
hostspec表示[host][:port][,…]
dbname为数据库名称。注意：不允许使用初始化用户进行远程登录。paramspec为name=value[&…]。
- 在DSN格式中，对于多IP的场景：
- 当num(ip) = num(port)时，ip和port是一一对应匹配。
- 当num(ip) > num(port)时，无法匹配到port的ip均与第一个port匹配。例如，host = ip1, ip2, ip3 port = port1, port2的匹配情况为ip1:port1, ip2:port2, ip3:port1。
- 当num(ip) < num(port)时，则多余的port被舍弃，即使用不到。例如host = ip1, ip2, ip3 port = port1, port2, port3, port4的匹配情况为ip1:port1, ip2:port2, ip3:port3。
- 在URL格式中，对于多IP的场景：
- URL串中ip:port必须成对出现，即num(ip) = num(port)，并以逗号隔开。例如， gaussdb://user:password@ip1:port1, ip2:port2, ip3:port3/gaussdb。
- URL串中仅包含多ip，port由环境变量指定或采用默认值5432。例如gaussdb://user:password@ip1, ip2, ip3/gaussdb并设置环境变量PGPORT = "port1, port2"，其匹配情况为ip1:port1, ip2:port2, ip3:port1。未设置环境变量的匹配情况为ip1:5432,ip2:5432,ip3:5432。
参数
参数名称 |
参数说明 |
|---|---|
host |
主机IP地址，也可通过环境变量${PGHOST}来指定。 |
port |
主机服务器的端口号，也可通过环境变量${PGPORT}来指定。 |
dbname |
数据库名，也可通过环境变量${PGDATABASE}来指定。 |
user |
要连接的用户名，也可通过环境变量${PGUSER}来指定。 |
password |
要连接用户对应的连接密码。 |
connect_timeout |
用于连接服务器操作的超时值，也可通过环境变量${PGCONNECT_TIMEOUT}来指定。 |
sslmode |
启用SSL加密的方式，也可通过环境变量${PGSSLMODE}来指定。
参数取值范围：
|
sslkey |
指定用于客户端证书的密钥位置，如果需要使用SSL连接，并且该参数未指定，可通过设置环境变量${PGSSLKEY}来指定。 |
sslcert |
指定客户端SSL证书的文件名，或者通过设置环境变量${PGSSLCERT}来指定。 |
sslrootcert |
指定一个包含SSL证书机构（CA）证书的文件名称，或者通过设置环境变量${PGSSLROOTCERT}来指定。 |
sslcrl |
指定SSL证书撤销列表（CRL）的文件名。列在这个文件中的证书如果存在，在尝试认证该服务器证书时会被拒绝，从而连接失败。也可通过环境变量${PGSSLCRL}来指定。 |
sslpassword |
指定对密钥解密成明文的密码短语，当指定该参数的时候表示sslkey是一个加密存储的文件，当前sslkey支持des/aes加密方式。
说明：
DES加密算法安全性低，存在安全风险，建议使用更安全的加密算法。 |
disable_prepared_binary_result |
字符串类型，若设置为yes，表示此连接在从预准备语句接收查询结果时不应使用二进制格式。该参数仅用于调试。 取值范围：yes/no。 |
binary_parameters |
字符串类型，该参数表示是否始终以二进制形式发送[]byte。取值范围：yes/no。若该参数设置为yes，建议绑定参数按照[]byte绑定，可以减少内部类型转换。 |
target_session_attrs |
指定数据库的连接类型，该参数用于识别主备节点，也可通过环境变量${PGTARGETSESSIONATTRS}来指定。默认值为“any”，共有六种：any、master、slave、preferSlave、read-write、read-only。
|
loggerLevel |
日志级别，打印相关调试信息，也可通过环境变量${PGLOGGERLEVEL}来指定。 支持trace/debug/info/warn/error/none，级别从高到低。 |
application_name |
设置正在使用连接的GO驱动的名称。缺省值为go-driver，该参数不建议用户配置。 |
RuntimeParams |
设置连接会话时默认运行的set类型的guc参数的值。例如参数名search_path、application_name、timezone等。各参数的详细介绍参见客户端连接缺省设置，可通过show语法查看参数是否设置成功。 |
autoBalance |
字符串类型，分布式环境下，使用该参数开启负载均衡连接。默认值为false，共有六种：true、balance、roundrobin、shuffle、priorityn、false。
|
recheckTime |
integer类型，定期检测数据库集群中CN状态，获取可用CN的IP列表的时间间隔，取值范围为5到60秒，默认为10秒。 |
usingEip |
boolean类型。此值用于控制是否使用弹性公网IP做负载均衡。默认值为true，表示使用弹性公网IP做负载均衡；false表示使用数据IP做负载均衡。 |
