数据仓库服务 GAUSSDB(DWS)-连接数据库:参数

时间:2024-12-09 15:13:06

参数

表1 数据库连接参数

参数

描述

url

gsjdbc4.jar数据库连接描述符。格式如下:

  • jdbc:postgresql:database
  • jdbc:postgresql://host/database
  • jdbc:postgresql://host:port/database
  • jdbc:postgresql://host:port[,host:port][...]/database
说明:

使用gsjdbc200.jar时,将“jdbc:postgresql”修改为“jdbc:gaussdb”

  • database为要连接的数据库名称。
  • host为数据库服务器名称或IP地址,当集群绑定弹性负载均衡(ELB)时,应设置为ELB的IP地址

    由于安全原因,数据库CN禁止集群内部其他节点无认证接入。如果要在集群内部访问CN,请将JDBC程序部署在CN所在机器,host使用"127.0.0.1"。否则可能会出现“FATAL: Forbid remote connection with trust method!”错误。

    建议业务系统单独部署在集群外部,否则可能会影响数据库运行性能。

  • port为数据库服务器端口。缺省情况下,会尝试连接到localhost的8000端口的database。
  • 支持多ip端口配置形式,jdbc自动实现了负载均衡,多ip端口配置形式是采取随机访问+failover的方式,这个过程系统会自动忽略不可达IP。

    以","隔开,例如jdbc:postgresql://10.10.0.13:8000,10.10.0.14:8000/database

  • 使用JDBC连接集群时集群链接地址只支持指定jdbc连接参数,不支持增加变量参数。

info

数据库连接属性。常用的属性如下:

  • user:String类型。表示创建连接的数据库用户。
  • password:String类型。表示数据库用户的密码。
  • ssl:Boolean类型。表示是否使用SSL连接。
  • loggerLevel:string类型。为LogStream或LogWriter设置记录进DriverManager当前值的日志信息量。目前支持"OFF"、"DEBUG"和"TRACE"。 值为"DEBUG"时,表示只打印DEBUG级别以上的日志,将记录非常少的信息。值等于TRACE时,表示打印DEBUG和TRACE级别的日志,将产生详细的日志信息。默认值为OFF,表示不打印日志。
  • prepareThreshold:integer类型。用于确定在转换为服务器端的预备语句之前,要求执行方法PreparedStatement的次数。缺省值是5。
  • batchMode : boolean类型,用于确定是否使用batch模式连接。
  • fetchsize : integer类型,用于设置数据库链接所创建statement的默认fetchsize。
  • ApplicationName:string类型。应用名称,在不做设置时,缺省值为PostgreSQL JDBC Driver。
  • allowReadOnly:boolean类型,用于设置connection是否允许设置readonly模式,默认为false,若该参数不被设置为true,则执行connection.setReadOnly不生效。
  • blobMode:string类型,用于设置setBinaryStream方法为不同的数据类型赋值,设置为on时表示为blob数据类型赋值,设置为off时表示为bytea数据类型赋值,默认为on。
  • connectionExtraInfo:Boolean类型。表示驱动是否上报当前驱动的部署路径、进程属主用户到数据库。
    说明:

    取值范围:true或false,默认值为true。设置connectionExtraInfo为true,JDBC驱动会将当前驱动的部署路径、进程属主用户上报到数据库中,记录在connection_info参数(参见connection_info)里;同时可以在PG_STAT_ACTIVITYPGXC_STAT_ACTIVITY中查询到。

user

数据库用户。

password

数据库用户的密码。

support.huaweicloud.com/devg-910-dws/dws_04_0093.html