连接字串及参数设置

虚谷JDBC驱动连接URL串格式。

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

说明：

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

property设置虚谷数据库连接属性，常用连接属性见表1。

会话参数名称	连接参数名称	初始值	说明
database	database		数据库名（必填）
user	user		用户名称（必填）
password	password		用户密码（必填）
version	version	301	服务器版本
encryptor	encryptor	301	用于启动加密数据库，若库未加密，则可不要，但带上此参数不会影响连接
char_set	charset	GBK	连接字符集。'GB2312'、'GBK'、'UTF8' 等
lob_ret	lob_ret		大对象（Blob、Clob）数据返回方式。属性为descriptor时，以描述符方式返回；其他以数据流方式返回。默认：以数据流方式返回
time_zone	timeZone		客户端时区。默认：数据库配置参数def_timezone所设置时区（只对系统时间函数生效）
iso_level	isoLevel	READ COMMITED	事务隔离级别。'READ COMMITED'：读已提交； 'REPEATIABLE READ'：可重复读；'SERIALIZABLE'：序列化
lock_timeout	lockTimeout	0	表示连接中的事务锁征用时，最大等候时间，单位：毫秒。若在设置时间内加锁失败，回滚事务并报错
recv_mode	recv_mode	0	接收模式选项。属性值为0时，本地全接收模式；属性值为1时，网络接收模式；属性值为2时，服务器端游标接收模式。
auto_commit	autoCommit	true	事务是否自动提交。属性为TRUE时，连接自动提交；属性为FALSE时，连接非自动提交。
return_rowid	return_rowid	false	是否返回记录rowid值。属性为TRUE时，返回rowid；其他返回FALSE。
is_debug	Command.debug	false	是否开启调试。
recv_type	discadeRow	false	是否丢弃已经接收到记录。
batch_mode	useBatch	false	PreparedStatement是否使用批量处理。属性为TRUE时，executeBatch采用批量模型；FALSE则采用单条处理模型。
uselike	useLike	false	是否使用like在getTables和getColumns中模糊查询。
iscompatibleqx	compatibleQX	false	是否兼容气象局。
islogversion	logVersionDate		是否在JDBC日志中输出版本打包日期信息。
isprintversion	printVersionTimes	0	控制打印JDBC驱动打包时间信息的开关，只打印一次。
compatibleoracle	isora	false	是否兼容ORACLE。
emptystringasnull	emptyStringAsNull	false	是否把空串当空处理。
rebuilconnection	rebuildConnection	false	是否在连接被卡断后重建连接。
curfetchsize	cursorFetchSize	1000	recv_mode=2时，每次从服务器读取记录条数。
xgversion	version	301	客户端协议版本，支持301协议，同时兼容201协议。
ddlprepare	ddlPrepare	false	是否支持DDL语句的PreparedStatement。
validatefrequency	validateFrequency	1	活性探测的时间间隔（分钟）。
validateconalive	validateConAlive	true	是否开启死链接探活功能。
validatetimes	validatePerTimes	500	一次task任务执行死链接探活的次数。
slowsqltime	slowSQLRecordTime	500	设置慢SQL执行时间。SQL语句执行时间超过该数值，日志则会输出执行SQL。
schemaon	return_schema	on	查询SQL是否返回模式信息。
closecurrresult	closeCurrResult	false	结果集数据全部读取完后，是否自动关闭。
resultkeepsize	resultkeepsize	false	每个Statement实例对象保留ResultSetList对象的队列大小。
benchmarkmode	benchmarkMode	false	是否开启benchmark优化模式。
benchmarkmodewid	benchmarkModeWid	false	是否开启benchmark分域优化模式（只有在benchmarkMode=true时，该参数才生效）。
cursorfirstsize	cursorFirstSize	10	recv_mode=2时，firstResult从服务器首次读取记录条数。
insertbatchmode	batchOrMoreResultMode	1	控制INSERT操作的结果接收方式。 1：多括号批量，将多个插入操作合并到一个批量操作中，使用单个 INSERT 语句完成。 0：多结果集，每次插入操作会返回一个独立的结果集。
identity_mode	identity_mode		数据库服务器端自增长使用模式。 DEFAULT：default自增。 NULL_AS_AUTO_INCREMENT：NULL自增。 ZERO_AS_AUTO_INCREMENT：0和NULL自增。
KEYWORD_FILTER	KEYWORD_FILTER		该参数需要大写，数据库连接配置连接上需要开放的关键字串，用逗号分隔，例如TABLE,FUNCTION,CONSTANT。
disable_binlog	disable_binlog		不记载binlog日志。
current_schema	current_schema		指定连接的模式名。
connect_timeout	sockeTimeOut	3600000	socket超时时间。
compatiblemode	compatiblemode	NONE	适配其他数据库（MYSQL/ORACLE）。
iskernel	iskernel	false	控制数据库元信息返回。
isSto	isSto	3600000	是否开启分分域功能。

说明：

连接参数使用SSL属性时，依赖程序包中提供的动态链接库，使用前需将动态链接库复制到操作系统指定位置方可正常使用SSL加密功能。

• Windows 32位操作系统，使用SSL属性前，需将程序包ssl/win32下xgssl.dll动态链接库复制拷贝到系统目录 C:/windows/system32目录位置。
• Windows 64位操作系统，使用SSL属性前，需将程序包ssl/win64下xgssl.dll动态链接库复制拷贝到系统目录 C:/windows/system32目录下。
• Linux X64位操作系统，使用SSL属性前，需将程序包ssl/linux64下libxgssl.so动态链接库复制拷贝到系统目录 /usr/lib或者 /usr/lib4目录下。

虚谷JDBC设置连接属性示例如下（版本号、大对象描述符、时区、关闭连接自动提交）：

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