JDBC Agent Bridge (Oracle, Dameng, Kingbase)
Connect to databases that don't have a native Rust driver via a local Java sidecar.
Engines like Oracle, Dameng (达梦), and KingbaseES (人大金仓) only ship JDBC drivers — no native Rust driver exists. RaisDB connects to them via a small Java sidecar (agent.jar) running locally.
Which engines use it
Any engine marked Agent in Supported Databases. Currently: Oracle, Dameng, KingbaseES. You don't configure the bridge manually — the form picks it up from the engine.
First-run flow
1. Pick an agent engine
Select Oracle / Dameng / Kingbase in the connection form.
2. Banner prompts for driver
A banner appears because the JDBC driver JARs aren't installed yet.
3. Download
Click Download. RaisDB fetches the vendor JARs — a China mirror is used automatically when the primary Maven Central URL is slow or blocked.
4. Test / Save enable
The buttons unlock once installation completes.
Requirements
Java Runtime
Any JRE / JDK 11+. RaisDB looks for it in this order: $JAVA_HOME/bin/java → bundled JRE → ~/.raisdb/runtime/jre → /usr/libexec/java_home → java on PATH. Verify with java -version.
Disk space
A few MB per engine for vendor JARs (see tables below).
Where files live
Universal sidecar
~/.raisdb/agent/agent.jar — shared by all agent engines.
Vendor drivers
~/.raisdb/drivers/<agent_type>/ — e.g. ~/.raisdb/drivers/oracle/ojdbc11-*.jar.
Driver catalog
Oracle
| File | Driver class |
|---|---|
ojdbc11-21.5.0.0.jar | oracle.jdbc.OracleDriver |
orai18n-21.5.0.0.jar | (i18n support) |
xmlparserv2-21.5.0.0.jar | (XML type support) |
xdb-21.5.0.0.jar | (XML DB) |
Mirrors: Maven Central → aliyun.
KingbaseES
| File | Driver class |
|---|---|
kingbase8-8.6.0.jar | com.kingbase8.Driver |
No China mirror — single CDN URL.
Dameng
| File | Driver class |
|---|---|
DmJdbcDriver18-8.1.3.140.jar | dm.jdbc.driver.DmMethod |
Mirrors: Maven Central → aliyun.
Oracle specifics
Service name vs SID
Toggle in the form (defaults to service name).
Auto-detect service
If the database name is left blank, RaisDB tries XE → FREE → ORCL → XEPDB1 → FREEPDB1 in that order.
SYSDBA
When the username is SYS (case-insensitive), RaisDB automatically connects as SYSDBA.