连接字串及参数设置
📄字数 3.0K
👁️阅读量 加载中...
XuguDB-JDBC驱动连接URL串格式。
txt
jdbc:xugu://serverIP:portNumber/databaseName[?property=value[&property=value]]说明
- jdbc:xugu:// ：（必需）虚谷数据库特定协议。
- serverIP ：（必需）虚谷数据库所在服务器的IP地址。
- portNumber：（必需）是虚谷数据库服务TCP访问端口，默认5138。
- databaseName：（必需）虚谷数据库数据库名称。
- property：（可选）虚谷数据库的URL连接属性。多个连接属性之间使用“&”分隔，不可重复。
property设置虚谷数据库连接属性，常用连接属性可见下表：
| 会话参数名 | 连接参数名 | 说明 | 初始值 | 支持版本 |
|---|---|---|---|---|
| database | database | 数据库名 | ||
| user | user | 用户名 | ||
| password | password | 用户密码 | ||
| version | version | 服务器版本 | 301 | |
| encryptor | encryptor | 数据库解密密钥 | ||
| char_set | charset | 客户端字符集(utf8或gbk) | GBK | |
| lob_ret | lob_ret | 大对象返回方式 | ||
| time_zone | timeZone | 客户端时区 | ||
| iso_level | isoLevel | 事务隔离级别 | READ COMMITTED读已提交 | |
| lock_timeout | lockTimeout | 最大加锁等候时间 | ||
| recv_mode | recv_mode | 结果集数据接收方式: 0:表示普通方式,(默认接受方式) 1:网络缓存据量方式 2:服务器端游标方式 | 0 | |
| auto_commit | autoCommit | 是否自动提交 | true | |
| return_rowid | return_rowid | 是否返回rowid | false | |
| recv_type | discadeRow | 是否丢弃已经接收到记录 | false | |
| batch_mode | useBatch | 是否在满足条件时使用批处理 | false | |
| islogversion | logVersionDate | 是否在JDBC日志中输出版本打包日期信息 | ||
| isprintversion | printVersionTimes | 控制打印JDBC驱动打包时间信息的开关，只打印一次，默认值为0 | 0 | |
| compatibleoracle | isora | 是否兼容ORACLE的BIGINT、DATE、DATETIME、NULL类型 | false | |
| emptystringasnull | emptyStringAsNull | 是否把空串当空处理 | false | |
| rebuilconnection | rebuildConnection | 是否在连接被卡断后重建连接，默认false不重建连接 | false | |
| ips | ips | ips负载均衡，参考负载均衡 | ||
| curfetchsize | cursorFetchSize | recv_mode=2时，每次从服务器读取记录条数 | 1000 | V12.0.0 |
| xgversion | version | 服务器版本 | 301 | V12.0.0 |
| ddlprepare | ddlPrepare | 是否支持DDL语句的PreparedStatement | false | V12.0.0 |
| validatefrequency | validateFrequency | 活性探测的时间间隔(分钟) | 1 | V12.0.0 |
| validateconalive | validateConAlive | 是否开启死链接探活功能 | true | V12.0.0 |
| validatetimes | validatePerTimes | 一次task任务执行死链接探活的次数 | 500 | V12.0.0 |
| slowsqltime | slowSQLRecordTime | 慢SQL阈值，当阈值大于0时，开启慢SQL日志记录功能。默认为0不开启 | 0 | V12.0.0 |
| schemaon | return_schema | 查询SQL是否返回模式信息（此参数存在一个疑问） | on | V12.1.0 |
| closecurrresult | closeCurrResult | 结果集数据全部读取完后，是否自动关闭 | false | V12.1.0 |
| resultkeepsize | resultkeepsize | 每个Statement实例对象保留ResultSetList对象的队列大小 | V12.1.0 | |
| benchmarkmode | benchmarkMode | 是否开启benchmark优化模式 | false | V12.1.0 |
| benchmarkmodewid | benchmarkModeWid | 是否开启benchmark 分域优化模式（只有在benchmarkMode=true时，才起效） | false | V12.1.0 |
| cursorfirstsize | cursorFirstSize | recv_mode=2时，firstResult从服务器首次读取记录条数 | 10 | V12.1.0 |
| insertbatchmode | batchOrMoreResultMode | 接收结果I时，是多结果集接受还是批量（insert命令的多（）批量，1：多括号批量；0：多结果集） | 1 | V12.1.0 |
| identity_mode | identity_mode | 数据库服务端自增长使用模式（DEFAULT：default自增,NULL_AS_AUTO_INCREMENT：NULL自增,ZERO_AS_AUTO_INCREMENT：0和NULL自增） | V12.1.0 | |
| keyword_filter | keyword_filter | 数据库连接配置连接上需要开放的关键字串，已逗号分隔，例如TABLE,FUNCTION,CONSTANT | V12.2.0 | |
| is_debug | Command.debug | 是否开启调试（初始化false） | false | V12.2.0 |
| uselike | useLike | 是否使用like在getTables和getColumns中模糊查询 | false | V12.2.0 |
| disable_binlog | disable_binlog | 不记载binlog日志 | V12.2.0 | |
| connect_timeout | sockeTimeOut | socket超时时间 | 3600 | V12.2.0 |
| compatiblemode | compatiblemode | 适配其他数据库(MySQL/ORACLE/PostgreSQL) | NONE | V12.2.6 |
| current_schema | current_schema | 指定连接的模式名 | V12.3.0 | |
| iskernel | iskernel | 控制数据库元信息返回 | false | V12.3.0 |
| isSto | isSto | 是否开启分域功能 | false | V12.3.0 |
| compatiblemysql | compatiblemysql | 是否兼容MySQL数据库将BIGINT映射为Java Long类型 | false | V12.3.4 |
| replaceProcessingEnabled | replaceProcessingEnabled | 是否对预处理语句中参数占位符?前后添加空格处理 | true | V12.3.5 |
| ssl | useSSL | 是否开启传输数据加密保护，参考传输安全配置 | nssl | V12.3.6 |
| isdisplayAD | isdisplayAD | 日期类型数据使用 getString 时是否保存 AD BC 后缀 | true | V12.3.6 |
| retainMilliseconds | retainMilliseconds | 日期类型datetime、timestamp是否保留毫秒值 | true | V12.3.6 |
| allowMultiQueries | allowMultiQueries | 区分是否将SQL语句发往服务器预处理,当为false表示不发送,当为true表示要发送 | true | V12.3.6 |
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";