Skip to content

适用虚谷数据库版本

v12.9



适用虚谷数据库版本

v12.9


连接字串及参数设置

📄字数 2.6K
👁️阅读量 加载中...

XuguDB-JDBC驱动连接URL串格式。

txt
jdbc:xugu://serverIP:portNumber/databaseName[?property=value[&property=value]]

说明

  • jdbc:xugu:// :(必需)虚谷数据库特定协议。
  • serverIP :(必需)虚谷数据库所在服务器的IP地址。
  • portNumber:(必需)是虚谷数据库服务TCP访问端口,默认5138。
  • databaseName:(必需)虚谷数据库数据库名称。
  • property:(可选)虚谷数据库的URL连接属性。多个连接属性之间使用“&”分隔,不可重复。

property设置虚谷数据库连接属性,常用连接属性可见下表:

会话参数名 连接参数名说明初始值
databasedatabase数据库名
useruser用户名
passwordpassword用户密码
versionversion服务器版本301
encryptorencryptor数据库解密密钥
char_setcharset客户端字符集(utf8gbk)GBK
lob_retlob_ret大对象返回方式
time_zonetimeZone客户端时区
iso_levelisoLevel事务隔离级别READ COMMITTED读已提交
lock_timeoutlockTimeout最大加锁等候时间
recv_moderecv_mode结果集数据接收方式0
auto_commitautoCommit是否自动提交true
return_rowidreturn_rowid是否返回rowidfalse
is_debugCommand.debug是否开启调试(初始化falsefalse
recv_typediscadeRow是否丢弃已经接收到记录false
batch_modeuseBatch是否在满足条件时使用批处理false
uselikeuseLike是否使用likegetTablesgetColumns中模糊查询false
islogversionlogVersionDate是否在JDBC日志中输出版本打包日期信息
isprintversionprintVersionTimes控制打印JDBC驱动打包时间信息的开关,只打印一次,默认值为00
compatibleoracleisora是否兼容ORACLE的BIGINT、DATE、DATETIME、NULL类型false
emptystringasnullemptyStringAsNull是否把空串当空处理false
rebuilconnectionrebuildConnection是否在连接被卡断后重建连接,默认false不重建连接false
curfetchsizecursorFetchSizerecv_mode=2时,每次从服务器读取记录条数1000
xgversionversion服务器版本301
ddlprepareddlPrepare是否支持DDL语句的PreparedStatementfalse
validatefrequencyvalidateFrequency活性探测的时间间隔(分钟)1
validateconalivevalidateConAlive是否开启死链接探活功能true
validatetimesvalidatePerTimes一次task任务执行死链接探活的次数500
slowsqltimeslowSQLRecordTimeSQL阈值,当阈值大于0时,开启慢SQL日志记录功能。默认为0不开启
schemaonreturn_schema查询SQL是否返回模式信息(此参数存在一个疑问)on
closecurrresultcloseCurrResult结果集数据全部读取完后,是否自动关闭false
resultkeepsizeresultkeepsize每个Statement实例对象保留ResultSetList对象的队列大小
benchmarkmodebenchmarkMode是否开启benchmark优化模式false
benchmarkmodewidbenchmarkModeWid是否开启benchmark 分域优化模式(只有在benchmarkMode=true时,才起效)false
cursorfirstsizecursorFirstSizerecv_mode=2时,firstResult从服务器首次读取记录条数10
insertbatchmodebatchOrMoreResultMode接收结果I时,是多结果集接受还是批量(insert命令的多()批量,1:多括号批量;0:多结果集)1
identity_modeidentity_mode数据库服务端自增长使用模式(DEFAULTdefault自增,NULL_AS_AUTO_INCREMENTNULL自增,ZERO_AS_AUTO_INCREMENT0NULL自增)
keyword_filterkeyword_filter数据库连接配置连接上需要开放的关键字串,已逗号分隔,例如TABLE,FUNCTION,CONSTANT
disable_binlogdisable_binlog不记载binlog日志
current_schemacurrent_schema指定连接的模式名
connect_timeoutsockeTimeOutsocket超时时间3600
compatiblemodecompatiblemode适配其他数据库(MySQL/ORACLE/PostgreSQL)NONE
iskerneliskernel控制数据库元信息返回false
isStoisSto是否开启分域功能false
compatiblemysqlcompatiblemysql是否兼容MySQL数据库将BIGINT映射为Java Long类型false
replaceProcessingEnabledreplaceProcessingEnabled是否对预处理语句中参数占位符?前后添加空格处理true
ipsipsips负载均衡,参考负载均衡
ssluseSSL是否开启传输数据加密保护,参考传输安全配置false

XuguDB-JDBC设置连接属性示例如下(版本号、大对象描述符、时区、关闭连接自动提交)

java
String url="jdbc:xugu://localhost:5138/System?user=GUEST&password=GUEST&version=110&auto_commit=false&lob_ret=descriptor&time_zone=GMT-8:00";