首页 > 其他分享 >openGauss JDBC常用参数参考

openGauss JDBC常用参数参考

时间:2024-05-16 18:56:30浏览次数:10  
标签:语句 建议 JDBC 参考 ip 超时 openGauss 默认值 连接

JDBC常用参数参考

targetServerType

原理: 值为master时会依次尝试连接串中配置的ip,直到能够连接到集群中的主机,

值为slave时会依次尝试连接串中配置的ip,直到能够连接到集群中的备机(查询语句为:select local_role, db_state from pg_stat_get_stream_replications();)。

建议: 有写操作的业务建议配置master,以保证主备切换后能正常连接主机,但是要注意在主备倒换过程中备机没有完全升主的时候无法正常建连,导致业务语句无法正常执行。

hostRecheckSeconds

原理: JDBC内部存储的dn列表保持可信的时间,未超过此时间时会从中直接读取存储的主机地址,当超过此时间时或者在可信时间内连接主机失败时会通过更新dn列表中该节点状态,之后连接其他的ip。

建议: 默认值10s,建议根据业务进行调整,配合参数targetServerType使用。

allowReadOnly

原理: 是否可以通过setReadOnly来修改事务访问模式,如果为true则可以修改,如果为false则无法通过此接口来修改,修改语句为SET SESSION CHARACTERISTICS AS TRANSACTION + READ ONLY / READ WEITE。

建议: 保持默认值为true。

fetchsize

原理: fetchsize在设置为n后,数据库服务器端在执行查询后,调用者在执行resultset.next()的时候,JDBC会先与服务器端进行通信,取n条数据到jdbc的客户端中,然后返回第一条给调用者,当调用者取到第n+1条数据的时候,会再次到数据库服务端去拿数据。

作用: 避免了数据库一下把所有结果全部传输到客户端来,将客户端的内存资源撑爆掉。

建议: 建议根据自身的业务查询数据数量和客户端机器内存情况来配置此参数,设置fetchsize时要关闭自动提交(autocommit=false),否则会导致fetchsize无法生效。

defaultRowFetchSize

作用: fetchsize默认值为0,defaultRowFetchSize会修改fetchsize的默认值。

batchMode

作用: 用于确定是否使用batch模式连接。默认值为on,开启后可以提升批量更新的性能,同时批量更新的返回值会发生改变,例如,批量插入三条数据,在开启时返回值为[3,0,0],在关闭后返回值为[1,1,1]。

建议: 如果本身业务框架(例如hibernate)在批量更新时会检测返回值,可以通过调整此参数来解决。

loginTimeout

作用: 控制与数据库建联时间,其中时间包括connectiontimeout和sockettimeout,超过阈值则退出。计算方式为:loginTimeout=connectiontimeout*节点数量+连接认证时间+初始化语句执行时间。

建议: 配置后会每次建连都会开启一个异步线程,在连接数较多的情况可能会导致客户端压力增大,如果业务确认需要此设置此参数,需要注意在集中式下建议调整为3*connectTimeout防止在网络异常情况且第三个IP为主的情况下,无法连接。

须知

此参数设置后对于多ip而言,时间是尝试连接ip的时间,可能会出现因为设置的值较小导致后面的ip无法连接的问题,例如设置了三个ip,如果logintimeout为5s,但前两个ip建连总共用了5s,第三个ip会无法进行连接,在集中式环境下,此最后一个ip恰好为主机,可能会导致自动寻主失败。

cancelSignalTimeout

作用: 发送取消消息本身可能会阻塞,此属性控制用于取消命令的“connect超时”和“socket超时”。超时时间单位为秒。主要为了防止连接超时取消时本身执行超时检测。

建议: 默认值为10秒,建议根据业务进行调整。

connectTimeout

作用: 控制建立连接时套接字超时阈值(此时是jdbc通过socket连接到数据的时间,并不是返回connection对象的时间),超过阈值查找下一个IP。

建议: 该参数决定了每个节点TCP连接建立的最大超时时间,如果某节点网络故障,与该节点建立连接时会等待connectTimeout超时,然后尝试连接下一个节点。考虑到网络抖动,时延等情况,默认建议设置为3s。

socketTimeout

作用: 控制套接字操作超时值,如果业务语句执行或者从网络读取数据流超过此阈值,连接中断(即语句超过规定时间执行,没有数据返回的时候)。

建议: 该参数限制单SQL最长的执行时间,单语句执行超过该值则会超时报错退出,建议根据业务特征进行配置。

socketTimeoutInConnecting

作用: 控制建连阶段套接字操作超时值,在建连阶段,如果从网络中读取数据流超过此阈值,则尝试查找下一个节点建连。

建议: 该参数仅影响建连阶段的socket超时时间,如果未配置,默认为5s。

autosave

作用: 值为always时可以在事务中每个语句前面设置一个savepoint点,在事务中语句执行报错时会返回到最近的上一个savepoint点,可以让事务中后续语句可以正常执行,最终可以正常提交。

建议: 不建议设置此参数,性能劣化严重。

currentSchema

作用: 设置当前连接的schema,如果未设置,则默认schema为连接使用的用户名。

建议: 建议配置此参数,业务数据所在的schema。

prepareThreshold

作用: 默认值为5,如果一个会话连续多次执行同一个SQL,在达到prepareThreshold次数以上时,JDBC将不再对这个SQL发送parse命令,会将其缓存起来,提升执行速度。

建议: 默认值为5,根据业务需要进行调整。

preparedStatementCacheQueries

作用: 确定每个连接中缓存的查询数,默认情况下是256。若在prepareStatement()调用中使用超过256个不同的查询,则最近最少使用的查询缓存将被丢弃。

建议: 默认值为256,根据业务需要进行调整。配合prepareThreshold使用。

blobMode

作用: setBinaryStream方法为不同类型的数据赋值,设置为on时表示为blob类型数据赋值,设置为off时表示为bytea类型数据赋值,默认为on。例如在preparestatement和callablestatement对象中对参数进行赋值操作。

建议: 默认值为true。

setAutocommit方法

作用: 值为true时,执行每个语句都会自动开启事务,在执行结束后自动提交事务,即每个语句都是一个事务。值为false时,会自动开启一个事务,事务需要通过执行SQL手动提交。

建议: 根据业务特征进行调整,如果基于性能或者其它方面考虑,需要关闭autocommit时,需要应用程序自己来保证事务的提交。例如,在指定的业务SQL执行完之后做显式提交,特别是客户端退出之前务必保证所有的事务已经提交。

bitToString

作用: 值为false时,bit或者bit(n)类型getObject返回的类型为Boolean类型;值为true时,bit或者bit(n)类型的getObject返回的结果自动转换为String类型。

建议: 默认值为false。请根据业务特征进行调整,如果使用bit或者bit(n)类型是标准的1位插入0/1时可以设置此值为false; 而如果使用的是非标准0/1,如"1111",那么就必须设置此值为true,否则getObject或者getBit将抛出转换错误。

详情查看:https://opengauss.org

详情查看:https://docs-opengauss.osinfra.cn

标签:语句,建议,JDBC,参考,ip,超时,openGauss,默认值,连接
From: https://www.cnblogs.com/techbing/p/18196499

相关文章

  • openGauss JDBC包-驱动类和环境类
    JDBC包、驱动类和环境类JDBC包openGauss提供两种JDBCjar包:postgresql.jar和openGauss-jdbc-x.x.x.jar,两种jar包功能一致,仅仅是为了解决和PostgreSQL之间的JDBC驱动包名冲突。在Linux服务器端源代码目录下执行build.sh,获得驱动jar包postgresql.jar和opengauss-jdbc-x.x.x.jar,包......
  • openGauss libpq接口参考
    libpq接口参考数据库连接控制函数数据库执行语句函数大对象操作函数异步命令处理取消正在处理的查询示例链接参数详情查看:https://opengauss.org详情查看:https://docs-opengauss.osinfra.cn......
  • openGauss JDBC配置
    JDBC配置目前,openGauss相关的第三方工具都是通过JDBC进行连接的,此部分将介绍工具配置时的注意事项。连接参数【关注】第三方工具通过JDBC连接openGauss时,JDBC向openGauss发起连接请求,会默认添加以下配置参数,详见JDBC代码ConnectionFactoryImpl类的实现。params={{"user"......
  • openGauss lo_close
    lo_close功能描述关闭一个大对象描述符。原型intlo_close(PGconn*conn,intfd);参数表1lo_close参数关键字参数说明conn一个数据库连接fd文件描述符返回值int:成功时返回1,失败时返回-1。示例请参见示例章节。详情查看:https://opengauss.org......
  • openGauss Linux下配置数据源
    Linux下配置数据源将openGauss提供的ODBCDRIVER(psqlodbcw.so)配置到数据源中便可使用。配置数据源需要配置“odbc.ini”和“odbcinst.ini”两个文件(在编译安装unixODBC过程中生成且默认放在“/usr/local/etc”目录下),并在服务器端进行配置。操作步骤获取unixODBC源码包。获取......
  • openGauss lo_export
    lo_export功能描述把一个大对象导出到一个服务器端的操作系统文件。原型intlo_export(PGconn*conn,OidlobjId,constchar*filename);参数表1lo_export参数关键字参数说明conn一个数据库连接lobjId要导出的大对象的OIDfilename要导出的文件路......
  • openGauss lo_create
    lo_creat功能描述创建一个大对象。原型Oidlo_creat(PGconn*conn,intmode);参数表1lo_creat参数关键字参数说明conn一个数据库连接mode指定只读、只写或者读写,已弃用、会被忽略,为兼容旧版本而保留参数返回值oid:返回值是分配给新大对象的OID或I......
  • openGauss lo_lseek
    lo_lseek功能描述改变一个大对象描述符的当前读或写位置。原型intlo_lseek(PGconn*conn,intfd,intoffset,intwhence);参数表1lo_lseek参数关键字参数说明conn一个数据库连接fd文件描述符offset将文件描述符的当前位置指针移动到由offset指......
  • openGauss lo_import
    lo_import功能描述将一个服务器端的操作系统文件导入成一个大对象。原型Oidlo_import(PGconn*conn,constchar*filename);参数表1lo_import参数关键字参数说明conn一个数据库连接filename要导入的文件的路径返回值oid:导入的大对象分配到的OID......
  • openGauss lo_tell
    lo_tell功能描述得到一个大对象描述符的当前读或写位置。原型intlo_tell(PGconn*conn,intfd);参数表1lo_tell参数关键字参数说明conn一个数据库连接fd文件描述符返回值int:失败时返回值为-1。lo_tell64功能描述将一个(可能超过2GB大小)大对......