云数据库 GaussDB-连接数据库:参数

时间：2023-11-01 16:18:27

云数据库 GaussDB 基于Go驱动开发

参数

表1 数据库连接参数
参数名称	参数说明
host	主机IP地址，也可通过环境变量${PGHOST}来指定。
port	主机服务器的端口号，也可通过环境变量${PGPORT}来指定。
dbname	数据库名，也可通过环境变量${PGDATABASE}来指定。
user	要连接的用户名，也可通过环境变量${PGUSER}来指定。
password	要连接用户对应的连接密码。
connect_timeout	用于连接服务器操作的超时值，也可通过环境变量${PGCONNECT_TIMEOUT}来指定。
sslmode	启用SSL加密的方式，也可通过环境变量${PGSSLMODE}来指定。参数取值范围： disable：不使用ssl安全连接。 allow：如果数据库服务器要求使用，则可以使用SSL安全加密连接，但不验证数据库服务器的真实性。 prefer：如果数据库支持，那么首选使用SSL安全加密连接，但不验证数据库服务器的真实性。 require：必须使用SSL安全连接，但是只做了数据加密，而并不验证数据库服务器的真实性。 verify-ca：必须使用SSL安全连接，并验证服务器是否具有由可信任的证书机构签发的证书。 verify-full：必须使用SSL安全连接，并且验证服务器是否具有由可信任的证书机构签发的证书，以及验证服务器主机名是否与证书中的一致
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。 any：尝试连接URL连接串中的任何一个数据节点。 master：尝试连接到URL连接串中的主节点，如果找不到就抛出异常。 slave：尝试连接到URL连接串中的备节点，如果找不到就抛出异常。 preferSlave：尝试连接到URL连接串中的备数据节点（如果有可用的话），否则连接到主数据节点。 read-write：读写模式，表示只能连接主节点。 read-only：只读模式，表示只能连接备节点。
loggerLevel	日志级别，打印相关调试信息，也可通过环境变量${PG LOG GERLEVEL}来指定。支持trace/debug/info/warn/error/none，级别从高到低。
application_name	设置正在使用连接的GO驱动的名称。缺省值为go-driver，该参数不建议用户配置。
RuntimeParams	要在连接上设置为会话默认值的运行时参数。例如参数名search_path,application_name,timezone等。各参数的详细介绍参见客户端连接缺省设置，可通过show语法查看参数是否设置成功。
enable_ce	密态数据库开关。enable_ce=1表示go驱动支持密态等值查询基本能力，enable_ce=3表示go驱动支持软硬融合全密态模式，不设置或其他值表示不开启密态数据库。
auto_sendtoken	自动传输密钥模式开关。auto_sendtoken=yes表示在DB实例连接池connection初始化时自动触发密钥传输操作，设置为no或不设置表示关闭该模式。注意，该模式无法保证密钥信息及时更新，同时当且仅当设置enable_ce=3时该模式可以被开启。