Parameters

Hint

This article is generated by AI translation.

jdbc-mongo supports many JDBC URL parameters to control connection behavior, auth, timeouts, etc.

JDBC URL format

jdbc:dbvisitor:mongo://server:port?database=0&param1=value1&param2=value2

• Server address: if port is omitted, default is 27017. Format: ip or ip:port; cluster: ip:port;ip:port or ip;ip;ip.

Basic Parameters

Name	Description	Default
username	Database username	None
password	Database password	None
mechanism	Auth mechanism: PLAIN, SCRAM-SHA-1, SCRAM-SHA-256, GSSAPI, X-509	None (auto-negotiate)
clientName	Client name shown in MongoDB server logs	Mongo-JDBC-Client

Network & Timeouts

Name	Description	Default
connectTimeout	Connection timeout (ms)	Driver default
socketTimeout	Socket read timeout (ms)	Driver default
socketSndBuffer	Socket send buffer (bytes)	Driver default
socketRcvBuffer	Socket receive buffer (bytes)	Driver default

Read/Write Strategy

Name	Description	Default
retryWrites	Enable retry writes	true
retryReads	Enable retry reads	true

Pre-Read Settings

Control pre-reading for large files or datasets. When enabled, result sets expose all document fields (not just _ID, _JSON).

Name	Description	Default
preRead	Enable pre-read; exposes all fields in result sets.	true
preReadThreshold	Threshold to swap pre-read data to disk.	5mb
preReadMaxFileSize	Max pre-read file size	20mb
preReadCacheDir	Pre-read cache directory	(system temp)

• preReadMaxFileSize accepts units b, kb, mb, gb (e.g., 10mb). Without a unit, MB is assumed.

Other Parameters

Name	Description	Default
timeZone	Local time zone used by the driver when handling time-zone data.	UTC
customMongo	Customize MongoDB client creation; implement net.hasor.dbvisitor.adapter.mongo.CustomMongo.	None