Skip to content

t8y2/dbx-agents

Repository files navigation

DBX Agents

Agent drivers for DBX — database support via JDBC and native database drivers.

Each agent runs as a standalone process and communicates with DBX via stdin/stdout JSON-RPC 2.0.

Supported Databases

Agent Database JDBC Driver
access Microsoft Access UCanAccess
dameng 达梦 DM8 DM JDBC
kingbase 人大金仓 KingbaseES KingbaseES JDBC
vastbase Vastbase Vastbase JDBC
goldendb GoldenDB MySQL Connector/J
databend Databend Databend JDBC
databricks Databricks SQL Databricks JDBC
saphana SAP HANA SAP HANA JDBC
teradata Teradata Teradata JDBC
vertica Vertica Vertica JDBC
firebird Firebird Jaybird JDBC
exasol Exasol Exasol JDBC
oceanbase-oracle OceanBase Oracle Mode OceanBase JDBC
gbase8a GBase 8a External GBase 8a JDBC
gbase8s GBase 8s External GBase 8s JDBC
oracle Oracle 10g+ go-ora native agent
oracle-legacy Oracle 11g/12c/18c/19c ojdbc8 (compatibility fallback)
oracle-10g Oracle 10g ojdbc6 (compatibility fallback, JRE 8)
h2 H2 H2 JDBC
snowflake Snowflake Snowflake JDBC
trino Trino (Presto) Trino JDBC
hive Apache Hive Hive JDBC
db2 IBM DB2 DB2 JDBC
informix IBM Informix Informix JDBC
neo4j Neo4j Neo4j JDBC
cassandra Apache Cassandra Cassandra JDBC
bigquery Google BigQuery BigQuery JDBC
kylin Apache Kylin Kylin JDBC
sundb SunDB SunDB JDBC
gaussdb GaussDB GaussDB JDBC
tdengine TDengine taos-jdbcdriver (WebSocket)
yashandb 崖山 YashanDB YashanDB JDBC
xugu 虚谷 XuguDB XuguDB Go native agent
iotdb Apache IoTDB IoTDB JDBC
etcd etcd jetcd

Multi-JRE Support

Most Java agents target JRE 21. Native agents, such as oracle and xugu, do not require a JRE. Agents that still require legacy Java runtimes (e.g. compatibility fallback oracle-10g uses JRE 8) declare their JRE version in the registry. DBX downloads and manages multiple JRE installations automatically.

Build

Requires JDK 8 and 21 (Gradle toolchain auto-downloads if needed).

./gradlew shadowJar
(cd drivers/oracle-go && go build -o agent .)
(cd drivers/xugu && go build -o agent .)

Output JARs are in drivers/{module}/build/libs/. Native agents build from drivers/oracle-go and drivers/xugu.

Development

Architecture

DBX Main Process (Rust/Tauri)
    │ stdin/stdout (JSON-RPC 2.0)
    ▼
agent / java -jar dbx-agent-{type}.jar
    │
    ▼
Native driver / JDBC → Database

License

AGPL-3.0

About

Agent drivers for DBX — domestic database support via JDBC (DaMeng, KingBase, Vastbase, GoldenDB)

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors