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。
TypeScript aicliclickhousedatabasedatabase-clientdatabase-managementdockerguimcpmongodbmysqlpostgresqlredisrustsql-serversqlitetaurivue
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.javaindex 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.javaindex 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.javaindex 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.tsvindex 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 typsnowflake 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.