Skip to content

armgit / dbx

Public Imported from GitHub
0

25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 100+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP。

fix(sundb): use driver DatabaseMetaData for schema introspection

zipg8d19034af9c4
diff --git a/agents/drivers/sundb/src/main/java/com/dbx/agent/sundb/SundbAgent.java b/agents/drivers/sundb/src/main/java/com/dbx/agent/sundb/SundbAgent.java
index b9481a9728..073cf0dbdd 100644
--- a/agents/drivers/sundb/src/main/java/com/dbx/agent/sundb/SundbAgent.java
+++ b/agents/drivers/sundb/src/main/java/com/dbx/agent/sundb/SundbAgent.java
@@ -1,499 +1,28 @@
package com.dbx.agent.sundb;
-import com.dbx.agent.AbstractJdbcAgent;
-import com.dbx.agent.ColumnInfo;
-import com.dbx.agent.ConnectParams;
-import com.dbx.agent.DatabaseInfo;
-import com.dbx.agent.ExecuteQueryOptions;
-import com.dbx.agent.ForeignKeyInfo;
-import com.dbx.agent.IndexInfo;
-import com.dbx.agent.JdbcExecutor;
-import com.dbx.agent.JdbcIdentifiers;
+import com.dbx.agent.ConfiguredJdbcAgent;
+import com.dbx.agent.JdbcAgentProfile;
import com.dbx.agent.MultiSessionJsonRpcServer;
-import com.dbx.agent.MetadataListConstraints;
-import com.dbx.agent.MetadataSqlSupport;
-import com.dbx.agent.ObjectInfo;
-import com.dbx.agent.ObjectSource;
-import com.dbx.agent.QueryResult;
-import com.dbx.agent.TableInfo;
-import com.dbx.agent.TriggerInfo;
-import java.sql.ResultSet;
-import java.sql.Types;
-import java.util.ArrayList;
-import java.util.Comparator;
-import java.util.HashMap;
-import java.util.HashSet;
-import java.util.LinkedHashMap;
-import java.util.List;
-import java.util.Locale;
-import java.util.Map;
-import java.util.Set;
-
-public final class SundbAgent extends AbstractJdbcAgent {
- @Override
- protected String driverClass() {
- return "csii.sundb.jdbc.SundbDriver";
- }
-
- @Override
- protected String buildJdbcUrl(ConnectParams params) {
- return buildUrl(params);
- }
-
- @Override
- public List<DatabaseInfo> listDatabases() {
- return unchecked(() -> {
- List<DatabaseInfo> result = new ArrayList<>();
- try (var stmt = requireConnected().createStatement();
- ResultSet rs = stmt.executeQuery("SHOW DATABASES")) {
- while (rs.next()) {
- result.add(new DatabaseInfo(rs.getString(1)));
- }
- }
- return result;
- });
- }
-
- @Override
- public List<String> listSchemas() {
- List<String> result = new ArrayList<>();
- for (DatabaseInfo database : listDatabases()) {
- result.add(database.getName());
- }
- return result;
- }
-
- @Override
- public List<TableInfo> listTables(String schema) {
- return unchecked(() -> {
- List<TableInfo> result = new ArrayList<>();
- try (var stmt = requireConnected().prepareStatement(
- "SELECT TABLE_NAME, TABLE_TYPE FROM information_schema.TABLES WHERE TABLE_SCHEMA = ? ORDER BY TABLE_NAME"
- )) {
- stmt.setString(1, schema);
- try (ResultSet rs = stmt.executeQuery()) {
- while (rs.next()) {
- String tableType = rs.getString("TABLE_TYPE");
- if ("BASE TABLE".equals(tableType)) {
- tableType = "TABLE";
- }
- result.add(new TableInfo(rs.getString("TABLE_NAME"), tableType, null));
- }
- }
- }
- return result;
- });
- }
-
- @Override
- public List<TableInfo> listTables(String schema, MetadataListConstraints constraints) {
- MetadataListConstraints normalized = MetadataListConstraints.orNone(constraints);
- if (isUnconstrained(normalized)) {
- return listTables(schema);
- }
- if (!normalized.includesTableLikeTypes()) {
- return List.of();
- }
- try {
- return queryConstrainedTables(schema, normalized);
- } catch (RuntimeException e) {
- return normalized.filterTables(listTables(schema));
- }
- }
-
- private List<TableInfo> queryConstrainedTables(String schema, MetadataListConstraints constraints) {
- return unchecked(() -> {
- List<TableInfo> result = new ArrayList<>();
- List<Object> args = new ArrayList<>();
- StringBuilder sql = new StringBuilder("SELECT TABLE_NAME, TABLE_TYPE FROM information_schema.TABLES WHERE TABLE_SCHEMA = ?");
- args.add(schema);
- appendInformationSchemaTableTypePredicate(sql, args, constraints);
- MetadataSqlSupport.appendNameFilter(sql, args, "TABLE_NAME", constraints);
- sql.append(" ORDER BY TABLE_NAME");
- MetadataSqlSupport.appendLiteralLimitOffset(sql, constraints);
- try (var stmt = requireConnected().prepareStatement(sql.toString())) {
- MetadataSqlSupport.bind(stmt, args);
- try (ResultSet rs = stmt.executeQuery()) {
- while (rs.next()) {
- result.add(new TableInfo(rs.getString("TABLE_NAME"), normalizeTableType(rs.getString("TABLE_TYPE")), null));
- }
- }
- }
- return constraints.withoutPaging().filterTables(result);
- });
- }
-
- @Override
- public List<ObjectInfo> listObjects(String schema) {
- return unchecked(() -> {
- List<ObjectInfo> result = new ArrayList<>();
- for (TableInfo table : listTables(schema)) {
- result.add(new ObjectInfo(table.getName(), table.getTable_type(), schema, table.getComment(), table.getValid()));
- }
-
- try (var stmt = requireConnected().prepareStatement(
- "SELECT ROUTINE_NAME, ROUTINE_TYPE FROM information_schema.ROUTINES WHERE ROUTINE_SCHEMA = ? ORDER BY ROUTINE_NAME"
- )) {
- stmt.setString(1, schema);
- try (ResultSet rs = stmt.executeQuery()) {
- while (rs.next()) {
- result.add(new ObjectInfo(rs.getString(1), rs.getString(2), schema, null));
- }
- }
- }
- return result;
- });
- }
-
- @Override
- public List<ObjectInfo> listObjects(String schema, MetadataListConstraints constraints) {
- MetadataListConstraints normalized = MetadataListConstraints.orNone(constraints);
- if (isUnconstrained(normalized)) {
- return listObjects(schema);
- }
- if (!includesSupportedObjects(normalized)) {
- return List.of();
- }
- try {
- return queryConstrainedObjects(schema, normalized);
- } catch (RuntimeException e) {
- return normalized.filterObjects(listObjects(schema));
- }
- }
-
- private List<ObjectInfo> queryConstrainedObjects(String schema, MetadataListConstraints constraints) {
- return unchecked(() -> {
- List<ObjectInfo> result = new ArrayList<>();
- List<String> branches = new ArrayList<>();
- List<Object> args = new ArrayList<>();
- if (constraints.includesTableLikeTypes()) {
- StringBuilder tableSql = new StringBuilder("SELECT TABLE_NAME AS OBJECT_NAME, TABLE_TYPE AS OBJECT_TYPE FROM information_schema.TABLES WHERE TABLE_SCHEMA = ?");
- args.add(schema);
- appendInformationSchemaTableTypePredicate(tableSql, args, constraints);
- MetadataSqlSupport.appendNameFilter(tableSql, args, "TABLE_NAME", constraints);
- branches.add(tableSql.toString());
- }
- if (constraints.objectTypeAllowed("PROCEDURE") || constraints.objectTypeAllowed("FUNCTION")) {
- StringBuilder routineSql = new StringBuilder("SELECT ROUTINE_NAME AS OBJECT_NAME, ROUTINE_TYPE AS OBJECT_TYPE FROM information_schema.ROUTINES WHERE ROUTINE_SCHEMA = ?");
- args.add(schema);
- appendRoutineTypePredicate(routineSql, args, constraints);
- MetadataSqlSupport.appendNameFilter(routineSql, args, "ROUTINE_NAME", constraints);
- branches.add(routineSql.toString());
- }
- if (branches.isEmpty()) {
- return List.of();
- }
- StringBuilder sql = new StringBuilder("SELECT OBJECT_NAME, OBJECT_TYPE FROM (")
- .append(String.join(" UNION ALL ", branches))
- .append(") metadata_objects ORDER BY CASE OBJECT_TYPE WHEN 'BASE TABLE' THEN 0 WHEN 'TABLE' THEN 0 WHEN 'VIEW' THEN 1 WHEN 'PROCEDURE' THEN 2 WHEN 'FUNCTION' THEN 3 ELSE 9 END, OBJECT_NAME");
- MetadataSqlSupport.appendLiteralLimitOffset(sql, constraints);
- try (var stmt = requireConnected().prepareStatement(sql.toString())) {
- MetadataSqlSupport.bind(stmt, args);
- try (ResultSet rs = stmt.executeQuery()) {
- while (rs.next()) {
- result.add(new ObjectInfo(rs.getString(1), normalizeTableType(rs.getString(2)), schema, null));
- }
- }
- }
- return constraints.withoutPaging().filterObjects(result);
- });
- }
-
- @Override
- public ObjectSource getObjectSource(String schema, String name, String objectType) {
- return unchecked(() -> {
- String sql = switch (objectType.toUpperCase(Locale.ROOT)) {
- case "VIEW" -> "SHOW CREATE VIEW `" + name.replace("`", "``") + "`";
- case "PROCEDURE" -> "SHOW CREATE PROCEDURE `" + name.replace("`", "``") + "`";
- case "FUNCTION" -> "SHOW CREATE FUNCTION `" + name.replace("`", "``") + "`";
- default -> throw new IllegalArgumentException("Unsupported object type: " + objectType);
- };
-
- String source = "";
- try (var stmt = requireConnected().createStatement();
- ResultSet rs = stmt.executeQuery(sql)) {
- if (rs.next()) {
- int index = "VIEW".equals(objectType.toUpperCase(Locale.ROOT)) ? 1 : 2;
- String value = rs.getString(index + 1);
- source = value == null ? "" : value;
- }
- }
- return new ObjectSource(name, objectType, schema, source);
- });
- }
-
- @Override
- public List<ColumnInfo> getColumns(String schema, String table) {
- return unchecked(() -> {
- Set<String> primaryKeys = new HashSet<>();
- try (var stmt = requireConnected().prepareStatement(
- """
- SELECT COLUMN_NAME
- FROM information_schema.KEY_COLUMN_USAGE
- WHERE TABLE_SCHEMA = ?
- AND TABLE_NAME = ?
- AND CONSTRAINT_NAME = 'PRIMARY'
- """
- )) {
- stmt.setString(1, schema);
- stmt.setString(2, table);
- try (ResultSet rs = stmt.executeQuery()) {
- while (rs.next()) {
- primaryKeys.add(rs.getString("COLUMN_NAME"));
- }
- }
- }
-
- List<ColumnInfo> result = new ArrayList<>();
- try (var stmt = requireConnected().prepareStatement(
- """
- SELECT COLUMN_NAME, COLUMN_TYPE, IS_NULLABLE, COLUMN_DEFAULT, EXTRA, COLUMN_COMMENT,
- NUMERIC_PRECISION, NUMERIC_SCALE, CHARACTER_MAXIMUM_LENGTH
- FROM information_schema.COLUMNS
- WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ?
- ORDER BY ORDINAL_POSITION
- """
- )) {
- stmt.setString(1, schema);
- stmt.setString(2, table);
- try (ResultSet rs = stmt.executeQuery()) {
- while (rs.next()) {
- String columnName = rs.getString("COLUMN_NAME");
- result.add(new ColumnInfo(
- columnName,
- rs.getString("COLUMN_TYPE"),
- "YES".equals(rs.getString("IS_NULLABLE")),
- rs.getString("COLUMN_DEFAULT"),
- primaryKeys.contains(columnName),
- rs.getString("EXTRA"),
- emptyToNull(rs.getString("COLUMN_COMMENT")),
- integerOrNull(rs, "NUMERIC_PRECISION"),
- integerOrNull(rs, "NUMERIC_SCALE"),
- numberToIntOrNull(rs, "CHARACTER_MAXIMUM_LENGTH")
- ));
- }
- }
- }
- return result;
- });
- }
-
- @Override
- public List<IndexInfo> listIndexes(String schema, String table) {
- return unchecked(() -> {
- try (var stmt = requireConnected().createStatement();
- ResultSet rs = stmt.executeQuery(
- "SHOW INDEX FROM " + JdbcIdentifiers.INSTANCE.backtick(table)
- + " FROM " + JdbcIdentifiers.INSTANCE.backtick(schema)
- )) {
- Map<String, List<IndexColumn>> indexMap = new LinkedHashMap<>();
- Map<String, Boolean> uniqueMap = new HashMap<>();
- Map<String, String> typeMap = new HashMap<>();
-
- while (rs.next()) {
- String indexName = rs.getString("Key_name");
- String columnName = rs.getString("Column_name");
- int sequence = rs.getInt("Seq_in_index");
- int nonUnique = rs.getInt("Non_unique");
- String indexType = rs.getString("Index_type");
-
- indexMap.computeIfAbsent(indexName, ignored -> new ArrayList<>())
- .add(new IndexColumn(sequence, columnName));
- uniqueMap.put(indexName, nonUnique == 0);
- typeMap.put(indexName, indexType);
- }
-
- List<IndexInfo> result = new ArrayList<>();
- for (Map.Entry<String, List<IndexColumn>> entry : indexMap.entrySet()) {
- String name = entry.getKey();
- List<String> columns = entry.getValue().stream()
- .sorted(Comparator.comparingInt(IndexColumn::sequence))
- .map(IndexColumn::name)
- .toList();
- result.add(new IndexInfo(
- name,
- columns,
- uniqueMap.getOrDefault(name, false),
- "PRIMARY".equals(name),
- null,
- typeMap.get(name),
- null,
- null
- ));
- }
- return result;
- }
- });
- }
-
- @Override
- public List<ForeignKeyInfo> listForeignKeys(String schema, String table) {
- return unchecked(() -> {
- List<ForeignKeyInfo> result = new ArrayList<>();
- try (var stmt = requireConnected().prepareStatement(
- """
- SELECT CONSTRAINT_NAME, COLUMN_NAME, REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME
- FROM information_schema.KEY_COLUMN_USAGE
- WHERE TABLE_SCHEMA = ?
- AND TABLE_NAME = ?
- AND REFERENCED_TABLE_NAME IS NOT NULL
- ORDER BY CONSTRAINT_NAME
- """
- )) {
- stmt.setString(1, schema);
- stmt.setString(2, table);
- try (ResultSet rs = stmt.executeQuery()) {
- while (rs.next()) {
- result.add(new ForeignKeyInfo(
- rs.getString("CONSTRAINT_NAME"),
- rs.getString("COLUMN_NAME"),
- rs.getString("REFERENCED_TABLE_NAME"),
- rs.getString("REFERENCED_COLUMN_NAME")
- ));
- }
- }
- }
- return result;
- });
- }
-
- @Override
- public List<TriggerInfo> listTriggers(String schema, String table) {
- return unchecked(() -> {
- List<TriggerInfo> result = new ArrayList<>();
- try (var stmt = requireConnected().prepareStatement(
- """
- SELECT TRIGGER_NAME, EVENT_MANIPULATION, ACTION_TIMING
- FROM information_schema.TRIGGERS
- WHERE TRIGGER_SCHEMA = ? AND EVENT_OBJECT_TABLE = ?
- ORDER BY TRIGGER_NAME
- """
- )) {
- stmt.setString(1, schema);
- stmt.setString(2, table);
- try (ResultSet rs = stmt.executeQuery()) {
- while (rs.next()) {
- result.add(new TriggerInfo(
- rs.getString("TRIGGER_NAME"),
- rs.getString("EVENT_MANIPULATION"),
- rs.getString("ACTION_TIMING")
- ));
- }
- }
- }
- return result;
- });
- }
-
- @Override
- public QueryResult executeQuery(String sql, String schema, ExecuteQueryOptions options) {
- return JdbcExecutor.current().execute(
- requireConnected(),
- sql,
- schema,
- this::setSchemaSQL,
- options.getMaxRows(),
- options.getFetchSize(),
- options.getTimeoutSecs(),
- this::resultValue
- );
- }
-
- @Override
- public String setSchemaSQL(String schema) {
- return "USE " + JdbcIdentifiers.INSTANCE.backtick(schema);
- }
-
- private static String buildUrl(ConnectParams params) {
- return "jdbc:sundb://" + params.getHost() + ":" + params.getPort() + "/" + params.getDatabase();
- }
-
- private static boolean isUnconstrained(MetadataListConstraints constraints) {
- return !constraints.hasFilter() && !constraints.hasLimit() && !constraints.hasOffset() && !constraints.hasObjectTypes();
- }
-
- private static boolean includesSupportedObjects(MetadataListConstraints constraints) {
- return constraints.includesTableLikeTypes()
- || constraints.objectTypeAllowed("PROCEDURE")
- || constraints.objectTypeAllowed("FUNCTION");
- }
-
- private static void appendInformationSchemaTableTypePredicate(StringBuilder sql, List<Object> args, MetadataListConstraints constraints) {
- if (!constraints.hasObjectTypes()) {
- return;
- }
- List<String> types = new ArrayList<>();
- if (constraints.tableTypeAllowed("TABLE")) {
- types.add("BASE TABLE");
- }
- if (constraints.tableTypeAllowed("VIEW")) {
- types.add("VIEW");
- }
- if (types.isEmpty()) {
- sql.append(" AND 1 = 0");
- return;
- }
- sql.append(" AND TABLE_TYPE IN (").append(MetadataSqlSupport.placeholders(types.size())).append(")");
- args.addAll(types);
- }
-
- private static void appendRoutineTypePredicate(StringBuilder sql, List<Object> args, MetadataListConstraints constraints) {
- if (!constraints.hasObjectTypes()) {
- return;
- }
- List<String> types = new ArrayList<>();
- if (constraints.objectTypeAllowed("PROCEDURE")) {
- types.add("PROCEDURE");
- }
- if (constraints.objectTypeAllowed("FUNCTION")) {
- types.add("FUNCTION");
- }
- if (types.isEmpty()) {
- sql.append(" AND 1 = 0");
- return;
- }
- sql.append(" AND ROUTINE_TYPE IN (").append(MetadataSqlSupport.placeholders(types.size())).append(")");
- args.addAll(types);
- }
-
- private static String normalizeTableType(String tableType) {
- return "BASE TABLE".equals(tableType) ? "TABLE" : tableType;
- }
-
- private static Integer integerOrNull(ResultSet rs, String column) throws Exception {
- Object value = rs.getObject(column);
- return value instanceof Integer ? (Integer) value : null;
- }
-
- private static Integer numberToIntOrNull(ResultSet rs, String column) throws Exception {
- Object value = rs.getObject(column);
- return value instanceof Number ? ((Number) value).intValue() : null;
- }
-
- private static String emptyToNull(String value) {
- return value == null || value.isEmpty() ? null : value;
- }
-
- @Override
- protected Object resultValue(ResultSet rs, int index, int sqlType) {
- try {
- Object value = switch (sqlType) {
- case Types.BIGINT -> rs.getLong(index);
- case Types.INTEGER, Types.SMALLINT, Types.TINYINT -> rs.getInt(index);
- case Types.FLOAT, Types.REAL -> rs.getFloat(index);
- case Types.DOUBLE -> rs.getDouble(index);
- case Types.DECIMAL, Types.NUMERIC -> rs.getBigDecimal(index);
- case Types.BOOLEAN, Types.BIT -> rs.getBoolean(index);
- default -> rs.getString(index);
- };
- return rs.wasNull() ? null : value;
- } catch (Exception e) {
- throw new RuntimeException(e);
- }
- }
-
- private record IndexColumn(int sequence, String name) {
+/**
+ * 科蓝 SUNDB Agent。
+ *
+ * <p>SUNDB 不是 MySQL 兼容库:服务端会以 16062(SQLState 42000)拒绝
+ * {@code SHOW DATABASES}、{@code SHOW INDEX} 这类 MySQL 专有语句,因此元数据
+ * 统一交给厂商 JDBC 驱动实现的 {@link java.sql.DatabaseMetaData}(驱动内部使用
+ * SUNDB 的 {@code INFORMATION_SCHEMA.DBC_*} 视图)读取,不再手写 MySQL 风格的
+ * information_schema 查询。schema 切换沿用驱动的 {@code SET SCHEMA}。
+ */
+public final class SundbAgent extends ConfiguredJdbcAgent {
+ /** 默认端口与 plugins/connection-types/sundb.yaml 的 defaultPort 保持一致。 */
+ public static final JdbcAgentProfile SUNDB_PROFILE = new JdbcAgentProfile(
+ "csii.sundb.jdbc.SundbDriver",
+ "jdbc:sundb://{host}:{port}/{database}",
+ 22581
+ );
+
+ public SundbAgent() {
+ super(SUNDB_PROFILE);
}
public static void main(String[] args) {
diff --git a/agents/drivers/sundb/src/test/java/com/dbx/agent/sundb/SundbAgentMetadataTest.java b/agents/drivers/sundb/src/test/java/com/dbx/agent/sundb/SundbAgentMetadataTest.java
index 2fd7c91f9f..eb32dd430c 100644
--- a/agents/drivers/sundb/src/test/java/com/dbx/agent/sundb/SundbAgentMetadataTest.java
+++ b/agents/drivers/sundb/src/test/java/com/dbx/agent/sundb/SundbAgentMetadataTest.java
@@ -1,53 +1,278 @@
package com.dbx.agent.sundb;
-import com.dbx.agent.MetadataListConstraints;
+import com.dbx.agent.ConfiguredJdbcAgent;
+import com.dbx.agent.ConnectParams;
+import com.dbx.agent.DatabaseInfo;
+import com.dbx.agent.TableInfo;
import com.dbx.agent.test.TestSupport;
-import com.dbx.agent.test.JdbcAgentFake;
-import com.dbx.agent.test.JdbcMetadataSqlFake;
-import java.util.Collections;
+import java.lang.reflect.Field;
+import java.lang.reflect.InvocationHandler;
+import java.lang.reflect.Method;
+import java.lang.reflect.Proxy;
+import java.sql.Connection;
+import java.sql.DatabaseMetaData;
+import java.sql.PreparedStatement;
+import java.sql.ResultSet;
+import java.sql.Statement;
+import java.util.ArrayList;
+import java.util.Arrays;
import java.util.List;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;
+/**
+ * SUNDB 服务端只接受自家语法({@code SHOW DATABASES} 会以 16062 报错),
+ * 因此元数据必须交给厂商驱动的 {@link DatabaseMetaData}(内部查询
+ * {@code INFORMATION_SCHEMA.DBC_*} 视图),而不是手写 MySQL 语句。
+ */
class SundbAgentMetadataTest {
@Test
- void quotesSchemaAndTableIdentifiersInIndexMetadataSql() {
+ void loadsDatabasesAndSchemasFromDriverMetadata() {
+ List<String> statements = new ArrayList<>();
+ List<String> metadataRequests = new ArrayList<>();
SundbAgent agent = new SundbAgent();
- TestSupport.setPrivateConnection(agent, JdbcMetadataSqlFake.connection());
+ TestSupport.setPrivateConnection(
+ agent,
+ connection(statements, metadata(emptyRows(), schemas("APP", "PUBLIC"), emptyRows(), emptyRows(), metadataRequests))
+ );
+ setConfiguredDatabase(agent, "SUNDB");
- agent.listIndexes("bad`schema", "bad`table");
+ List<String> databases = agent.listDatabases().stream().map(DatabaseInfo::getName).toList();
+ List<String> schemas = agent.listSchemas();
- Assertions.assertEquals(
- Collections.singletonList("SHOW INDEX FROM `bad``table` FROM `bad``schema`"),
- JdbcMetadataSqlFake.statements
- );
+ // 驱动的 getCatalogs() 是 WHERE 1=0 的占位查询,数据库名来自连接上的 database。
+ Assertions.assertEquals(List.of("SUNDB"), databases);
+ Assertions.assertEquals(List.of("APP", "PUBLIC"), schemas);
+ Assertions.assertEquals(List.of("getSchemas:SUNDB"), metadataRequests);
+ Assertions.assertTrue(statements.isEmpty(), "元数据不应执行手写 SQL: " + statements);
}
@Test
- void constrainedTableMetadataPushesFilterTypesAndPaging() {
+ void listsTablesThroughDriverMetadataWithSunDbTableTypes() {
+ List<String> statements = new ArrayList<>();
+ List<String> metadataRequests = new ArrayList<>();
SundbAgent agent = new SundbAgent();
- TestSupport.setPrivateConnection(agent, JdbcMetadataSqlFake.connection());
+ TestSupport.setPrivateConnection(
+ agent,
+ connection(
+ statements,
+ metadata(
+ emptyRows(),
+ emptyRows(),
+ rows(new String[] {"TABLE_TYPE"}, new Object[][] {{"BASE TABLE"}, {"VIEW"}}),
+ rows(
+ new String[] {"TABLE_NAME", "TABLE_TYPE", "REMARKS"},
+ new Object[][] {{"ITEMS", "BASE TABLE", null}, {"ITEM_VIEW", "VIEW", "视图"}}
+ ),
+ metadataRequests
+ )
+ )
+ );
+ setConfiguredDatabase(agent, "SUNDB");
- agent.listTables("app", new MetadataListConstraints("ord", 25, 50, List.of("TABLE", "VIEW")));
+ List<TableInfo> tables = agent.listTables("APP");
- String sql = JdbcMetadataSqlFake.statements.get(0);
- Assertions.assertTrue(sql.contains("FROM information_schema.TABLES"), sql);
- Assertions.assertTrue(sql.contains("TABLE_TYPE IN (?, ?)"), sql);
- Assertions.assertTrue(sql.contains("UPPER(TABLE_NAME) LIKE ? ESCAPE '\\\\'"), sql);
- Assertions.assertTrue(sql.endsWith("LIMIT 25 OFFSET 50"), sql);
+ // 只有 DBC_TABLE_TYPE 真实支持的取值才会传给驱动。
+ Assertions.assertEquals(List.of("getTables:BASE TABLE", "getTables:VIEW"), metadataRequests);
+ Assertions.assertEquals(List.of("ITEMS", "ITEM_VIEW"), tables.stream().map(TableInfo::getName).toList());
+ Assertions.assertEquals(List.of("TABLE", "VIEW"), tables.stream().map(TableInfo::getTable_type).toList());
+ Assertions.assertEquals("视图", tables.get(1).getComment());
+ Assertions.assertTrue(statements.isEmpty(), "元数据不应执行手写 SQL: " + statements);
}
@Test
- void constrainedObjectMetadataPushesRoutineTypesAndPaging() {
+ void switchesSchemaWithSetSchemaInsteadOfMysqlUse() {
SundbAgent agent = new SundbAgent();
- TestSupport.setPrivateConnection(agent, JdbcMetadataSqlFake.connection());
+ TestSupport.setPrivateConnection(agent, connection(new ArrayList<>(), metadata(
+ emptyRows(), emptyRows(), emptyRows(), emptyRows(), new ArrayList<>()
+ )));
+
+ Assertions.assertEquals("SET SCHEMA \"APP\"", agent.setSchemaSQL("APP"));
+ }
+
+ @Test
+ void buildsSunDbJdbcUrlFromProfileTemplate() {
+ Assertions.assertEquals("csii.sundb.jdbc.SundbDriver", SundbAgent.SUNDB_PROFILE.getDriverClass());
+ Assertions.assertEquals(22581, SundbAgent.SUNDB_PROFILE.getDefaultPort());
+
+ ConnectParams params = new ConnectParams();
+ params.setHost("10.0.0.1");
+ params.setPort(22581);
+ params.setDatabase("SUNDB");
- agent.listObjects("app", new MetadataListConstraints("sync", 10, null, List.of("PROCEDURE", "FUNCTION")));
+ Assertions.assertEquals("jdbc:sundb://10.0.0.1:22581/SUNDB", SundbAgent.SUNDB_PROFILE.buildUrl(params));
+ }
+
+ private static void setConfiguredDatabase(SundbAgent agent, String database) {
+ try {
+ Field field = ConfiguredJdbcAgent.class.getDeclaredField("configuredDatabase");
+ field.setAccessible(true);
+ field.set(agent, database);
+ } catch (ReflectiveOperationException e) {
+ throw new IllegalStateException(e);
+ }
+ }
+
+ private static DatabaseMetaData metadata(
+ ResultSet catalogs,
+ ResultSet schemas,
+ ResultSet tableTypes,
+ ResultSet tables,
+ List<String> metadataRequests
+ ) {
+ return proxy(DatabaseMetaData.class, (proxy, method, args) -> {
+ switch (method.getName()) {
+ case "getCatalogs":
+ return catalogs;
+ case "getSchemas":
+ metadataRequests.add("getSchemas:" + args[0]);
+ return schemas;
+ case "getTableTypes":
+ return tableTypes;
+ case "getTables":
+ for (Object type : (String[]) args[3]) {
+ metadataRequests.add("getTables:" + type);
+ }
+ return tables;
+ case "getIdentifierQuoteString":
+ return "\"";
+ default:
+ return defaultValue(method.getReturnType());
+ }
+ });
+ }
+
+ private static Connection connection(List<String> statements, DatabaseMetaData metadata) {
+ return proxy(Connection.class, (proxy, method, args) -> {
+ switch (method.getName()) {
+ case "createStatement":
+ return statement(statements);
+ case "prepareStatement":
+ statements.add((String) args[0]);
+ return preparedStatement(statements);
+ case "getMetaData":
+ return metadata;
+ case "getAutoCommit":
+ return true;
+ case "isClosed":
+ return false;
+ case "close":
+ return null;
+ default:
+ return defaultValue(method.getReturnType());
+ }
+ });
+ }
+
+ private static Statement statement(List<String> statements) {
+ ResultSet resultSet = emptyRows();
+ return proxy(Statement.class, (proxy, method, args) -> {
+ switch (method.getName()) {
+ case "execute":
+ statements.add((String) args[0]);
+ return false;
+ case "executeQuery":
+ statements.add((String) args[0]);
+ return resultSet;
+ case "getResultSet":
+ return resultSet;
+ case "getUpdateCount":
+ return 0;
+ case "close":
+ return null;
+ default:
+ return defaultValue(method.getReturnType());
+ }
+ });
+ }
+
+ private static PreparedStatement preparedStatement(List<String> statements) {
+ ResultSet resultSet = emptyRows();
+ return proxy(PreparedStatement.class, (proxy, method, args) -> {
+ switch (method.getName()) {
+ case "executeQuery":
+ return resultSet;
+ case "getResultSet":
+ return resultSet;
+ case "getUpdateCount":
+ return 0;
+ case "close":
+ return null;
+ default:
+ return defaultValue(method.getReturnType());
+ }
+ });
+ }
+
+ private static ResultSet schemas(String... names) {
+ Object[][] data = new Object[names.length][];
+ for (int i = 0; i < names.length; i++) {
+ data[i] = new Object[] {names[i]};
+ }
+ return rows(new String[] {"TABLE_SCHEM"}, data);
+ }
+
+ private static ResultSet rows(String[] columns, Object[][] data) {
+ final int[] index = {-1};
+ return proxy(ResultSet.class, (proxy, method, args) -> {
+ switch (method.getName()) {
+ case "next":
+ index[0]++;
+ return index[0] < data.length;
+ case "getString": {
+ Object cell = cell(data[index[0]], columns, args[0]);
+ return cell == null ? null : cell.toString();
+ }
+ case "wasNull":
+ return false;
+ case "close":
+ return null;
+ default:
+ return defaultValue(method.getReturnType());
+ }
+ });
+ }
+
+ private static Object cell(Object[] row, String[] columns, Object selector) {
+ int position = selector instanceof Number
+ ? ((Number) selector).intValue() - 1
+ : Arrays.asList(columns).indexOf((String) selector);
+ return row[position];
+ }
+
+ private static ResultSet emptyRows() {
+ return rows(new String[0], new Object[0][]);
+ }
+
+ private static <T> T proxy(Class<T> type, InvocationHandler handler) {
+ return type.cast(Proxy.newProxyInstance(type.getClassLoader(), new Class<?>[] {type}, handler));
+ }
- String sql = JdbcMetadataSqlFake.statements.get(0);
- Assertions.assertTrue(sql.contains("FROM information_schema.ROUTINES"), sql);
- Assertions.assertTrue(sql.contains("ROUTINE_TYPE IN (?, ?)"), sql);
- Assertions.assertTrue(sql.contains("ORDER BY CASE OBJECT_TYPE"), sql);
- Assertions.assertTrue(sql.endsWith("LIMIT 10"), sql);
+ private static Object defaultValue(Class<?> type) {
+ if (Boolean.TYPE.equals(type)) {
+ return false;
+ }
+ if (Byte.TYPE.equals(type)) {
+ return (byte) 0;
+ }
+ if (Short.TYPE.equals(type)) {
+ return (short) 0;
+ }
+ if (Integer.TYPE.equals(type)) {
+ return 0;
+ }
+ if (Long.TYPE.equals(type)) {
+ return 0L;
+ }
+ if (Float.TYPE.equals(type)) {
+ return 0f;
+ }
+ if (Double.TYPE.equals(type)) {
+ return 0.0d;
+ }
+ if (Character.TYPE.equals(type)) {
+ return '\0';
+ }
+ return null;
}
}
diff --git a/agents/drivers/sundb/src/test/java/com/dbx/agent/sundb/SundbAgentTest.java b/agents/drivers/sundb/src/test/java/com/dbx/agent/sundb/SundbAgentTest.java
index e05e6661c0..f610ad868c 100644
--- a/agents/drivers/sundb/src/test/java/com/dbx/agent/sundb/SundbAgentTest.java
+++ b/agents/drivers/sundb/src/test/java/com/dbx/agent/sundb/SundbAgentTest.java
@@ -2,7 +2,6 @@ package com.dbx.agent.sundb;
import com.dbx.agent.DatabaseAgent;
import com.dbx.agent.test.JdbcFakeExecutionBehaviorTest;
-import java.lang.reflect.Method;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;
@@ -18,13 +17,11 @@ class SundbAgentTest extends JdbcFakeExecutionBehaviorTest {
}
@Test
- void usesTheSunDbJdbcDriverClass() throws Exception {
- Method driverClass = SundbAgent.class.getDeclaredMethod("driverClass");
- driverClass.setAccessible(true);
-
+ void usesTheSunDbJdbcDriverClass() {
+ Assertions.assertEquals("csii.sundb.jdbc.SundbDriver", SundbAgent.SUNDB_PROFILE.getDriverClass());
Assertions.assertEquals(
"csii.sundb.jdbc.SundbDriver",
- driverClass.invoke(new SundbAgent())
+ ((SundbAgent) createAgent()).getProfile().getDriverClass()
);
}
}
diff --git a/agents/metadata-constraint-coverage.tsv b/agents/metadata-constraint-coverage.tsv
index 0a8cccc525..e807988651 100644
--- a/agents/metadata-constraint-coverage.tsv
+++ b/agents/metadata-constraint-coverage.tsv
@@ -28,7 +28,7 @@ oracle-go native-pushdown native-go Uses Oracle-compatible metadata SQL with typ
snowflake native-pushdown java-sql Uses INFORMATION_SCHEMA with type, filter, stable order, and literal LIMIT/OFFSET.
spanner intentional-fallback java-jdbc-metadata Uses the dialect-aware Spanner JDBC metadata with the schema passed through verbatim because GoogleSQL names the user schema with an empty string; JDBC exposes no portable server-side paging API, common constraints filter locally.
spark intentional-fallback java-show-metadata Uses SHOW TABLES/SHOW DATABASES; stable server-side fuzzy paging is not portable, common constraints filter locally.
-sundb native-pushdown java-sql Uses information_schema with type, filter, stable order, and LIMIT/OFFSET.
+sundb intentional-fallback java-jdbc-metadata Uses the vendor driver's DatabaseMetaData (INFORMATION_SCHEMA.DBC_* views) because the server rejects MySQL-only statements such as SHOW DATABASES; JDBC exposes no portable server-side paging API, common constraints filter locally.
tdengine shared-fallback native-rust Uses SHOW STABLES/TABLES with information_schema parent enrichment, then applies stable filtering and paging in the native agent.
trino native-pushdown java-sql Uses information_schema.tables with type, filter, stable order, and literal LIMIT/OFFSET.
transwarp shared-fallback java-sql Uses system catalog views with stable ordering and shared filtering/paging; the vendor SDK has no verified portable server-side paging contract.