数据库客户端数据库桌面应用CLI后端MCP 服务AI 应用【免费下载链接】dbx25 MB lightweight cross-platform database client for 90 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、达梦等 90 数据库提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。项目地址https://gitcode.com/gh_mirrors/dbx7/dbx点击查看免费下载plugins/connection-types/*.yaml是 DBX 项目连接类型注册的单一事实来源source of truth一套描述符文件同时驱动 Rust 后端枚举、前端类型系统与数据库驱动清单。本文围绕这一核心机制讲解描述符的字段语义、与前端catalog.yaml产品 profile 的分工、多运行时 profile 的建模方式以及pnpm generate:connection-types的代码生成链路与新增连接类型的决策路径帮助读者理解 DBX 如何以声明式 YAML 支撑 90 数据库/中间件的统一接入。一、连接类型描述符注册体系的单一事实来源DBX 将一个产品能连什么、怎么连、连上后能做什么统一建模为连接类型connection type。连接类型描述符目录 plugins/connection-types/ 下的每个.yaml文件都描述一个稳定的连接类型。这些类型覆盖的范围远超传统数据库客户端SQL 数据库MySQL、PostgreSQL、SQL Server、Oracle、达梦、GBase、openGauss 等文档与向量存储MongoDB、Elasticsearch、Meilisearch、Qdrant、Milvus、Weaviate、ChromaDB 等键值/配置/注册中心服务Redis、etcd、ZooKeeper、Nacos、Consul消息队列与 MQTT brokerKafka、RocketMQ、RabbitMQ、Pulsar、MQTT通用 JDBC 目标jdbc.yaml如 Dremio、JDBCX 等。职责边界是理解这套体系的关键描述符只负责连接注册即定义连接类型的稳定 ID、运行模式、默认参数与能力位而 SQL 语法、DDL 模板、类型目录、元数据查询细节全部留在 plugins/dialects/ 下的方言文件中。两者通过描述符中的dialect字段绑定如 mysql.yaml 的dialect: MySQL。由于历史原因dbTypeYAML 中的标识符与DatabaseType生成的 Rust 枚举保留了历史命名即使部分目标如 Redis、MQTT、ZooKeeper严格来说并非数据库其 ID 也不会变动以保证序列化 API 的兼容性。二、描述符核心字段详解以 mysql.yaml 为完整示例一个标准描述符如下schemaVersion: 1 order: 10 dbType: mysql rustVariant: Mysql label: MySQL dialect: MySQL runtimeMode: native mcpMode: direct singleConnectionPool: false metadataConnectionScoped: true skipTcpProbe: false defaultPort: 3306 traits: diagramSql: true supportLevel: operate capabilities: queryExecution: true metadataBrowse: true objectBrowser: true objectSource: true schemaSearch: true diagram: true tableDataEdit: true tableStructureEdit: true tableImport: true dataTransfer: true sqlFileExecution: true databaseCreate: true fieldLineage: true sqlExplain: true userAdmin: true driverManagement: false各字段的核心语义如下字段含义取值示例schemaVersion描述符 schema 版本当前为11order全局展示/生成顺序必须唯一10dbType稳定连接类型 ID用于序列化 API必须唯一mysqlrustVariant生成的 Rust 枚举变体名必须唯一Mysqllabel人类可读显示名MySQLdialect绑定的 SQL 方言可选非 SQL 类型可省略MySQLruntimeMode运行时模式native内建驱动或external外部/独立运行时native/externalmcpModeMCP 暴露模式direct、bridge或unsupporteddirect/bridge/unsupportedsingleConnectionPool是否使用单一连接池JDBC 类目标为truefalse/truemetadataConnectionScoped元数据是否按连接作用域管理true/falseskipTcpProbe是否跳过 TCP 连通性探测如消息队列、注册中心常跳过false/truedefaultPort连接表单默认端口3306formKind连接表单种类有限编码见下文mq/mqtt/jdbc等driverProfiles共享同一连接模型的多个运行时 profile见mq.yamltraits特性标记如diagramSql、schemaAware、treeSchemadiagramSql: truesupportLevel支持级别operate/browse/connect等operatespecializedSurface是否使用独立于共享能力矩阵的专用管理界面true/falsecapabilities16 项产品能力位见下表布尔值driverStoreOrder/storeOrder驱动商店显示顺序必须为正且在各生效驱动键下唯一正整数capabilities能力矩阵共 16 项queryExecution、metadataBrowse、objectBrowser、objectSource、schemaSearch、diagram、tableDataEdit、tableStructureEdit、tableImport、dataTransfer、sqlFileExecution、databaseCreate、fieldLineage、sqlExplain、userAdmin、driverManagement。对照真实描述符可以看到能力位如何刻画产品形态MySQLmysql.yaml除driverManagement外几乎全开supportLevel: operate是能力最完整的类型Redisredis.yaml仅queryExecution: true其余全部为falsemcpMode: bridgeElasticsearchelasticsearch.yaml同样仅queryExecution: trueJDBCjdbc.yamlruntimeMode: external、singleConnectionPool: true、formKind: jdbc能力集中在查询与浏览MQTTmqtt.yaml全部能力为false因为其交互完全走专用管理界面。值得注意的约束来自 Rust 侧的编译期校验crates/dbx-types/build.rs 在构建时解析全部描述符并强制执行schemaVersion必须为 1、dbType与rustVariant不得重复、order必须全局唯一任何违例都会直接导致构建失败——这保证了 YAML 即契约。三、产品 profile前端连接选择器的映射层描述符是类型层面的事实而用户实际看到的是产品product。profiles/catalog.yaml 就是前端连接选择器connection picker的 profile 目录它把产品名、默认参数、图标绑定到稳定的连接类型上。schemaVersion: 1 profiles: - id: mysql dbType: mysql label: MySQL icon: mysql port: 3306 user: root urlParams: category: sql - id: mariadb dbType: mysql label: MariaDB icon: mariadb port: 3306 user: root category: sql - id: tidb dbType: mysql label: TiDB icon: tidb port: 4000 user: root category: domestic # ...从 catalog.yaml 可以看到 profile 的关键设计多个产品可以共享同一个dbType。例如 MariaDB、TiDB、OceanBase、TDSQL、PolarDB、GreatSQL、Doris、SelectDB、StarRocks、Dolt 全部映射到dbType: mysql复用 MySQL 的连接模型与方言仅替换 label、icon、默认端口与用户名CockroachDB、Cloudberry、OpenTenBase 则共享dbType: postgres。这正是 DBX 以类型而非产品为单位管理连接的核心原因。profile 的category用于前端分组取值包括sql、analytics、domestic国产数据库、lightweight、document、graph_ai、timeseries、mq、registry_config等由 scripts/sync-connection-types.mjs 生成对应的 TypeScript 联合类型。某些 profile 还支持pickerLabel/pickerIcon覆盖选择器中的显示文案与图标以及host/urlParams提供默认主机与 URL 参数如 Kyuubi 的urlParams: authNONE、ArgoDB 的authnoSasl、DynamoDB 的默认主机dynamodb.us-east-1.amazonaws.com。四、多运行时 profile一个连接类型多个产品当多个产品共享同一套 DBX 连接模型与管理界面时描述符通过driverProfiles内置多个运行时 profile而不必拆成多个连接类型。mq.yaml 是典型范例schemaVersion: 1 order: 710 dbType: mq rustVariant: MessageQueue label: Message Queue runtimeMode: native mcpMode: unsupported singleConnectionPool: false metadataConnectionScoped: false skipTcpProbe: true defaultPort: 8080 formKind: mq driverProfiles: - profile: kafka label: Apache Kafka agentKey: kafka storeVisible: true storeOrder: 44 - profile: rocketmq label: Apache RocketMQ agentKey: rocketmq storeVisible: true storeOrder: 45 - profile: rabbitmq label: RabbitMQ agentKey: rabbitmq storeVisible: true storeOrder: 46 supportLevel: connect capabilities: queryExecution: false metadataBrowse: true objectBrowser: true # ...其余为 false driverManagement: trueKafka、RocketMQ、RabbitMQ 共享dbType: mq各自通过profile、agentKeyAgent 驱动映射、storeOrder区分。而在 catalog.yaml 中它们依然是独立的前端条目kafka、rocketmq、rabbitmq甚至还包括 Apache Pulsar 的mqprofile分别使用 9092、9876、5672 等不同默认端口。对比之下MQTT 是独立的连接类型mqtt.yaml因为其协议、配置模型与 UI 工作流订阅/发布、QoS、topic 管理与 Kafka/RocketMQ/RabbitMQ 完全不同无法共享mq的连接模型因此单独声明dbType: mqtt、formKind: mqtt、defaultPort: 1883并设置specializedSurface: true以使用独立的专用管理界面。五、specializedSurface 与驱动商店排序规则描述符规范对specializedSurface有明确约束仅当产品使用共享能力矩阵无法表达的专用管理界面时才应设为true否则至少必须启用一项产品能力。MQTT 是specializedSurface: true的代表——它的全部 16 项能力位均为false交互完全发生在专用界面中而 MySQL 等常规类型则通过能力矩阵表达功能范围。驱动商店条目driver store entries同样在 YAML 中声明稳定的显示顺序driverStoreOrder用于描述符的主 Agent 驱动storeOrder用于可见 profile 或被管理的驱动。两条排序规则的共同约束是顺序值必须为正且在各生效驱动键effective driver keys下唯一避免驱动商店出现排序歧义。六、代码生成链路一份 YAML三端同步描述符的价值在于一次声明、三端复用。前端开发/构建、类型检查、测试都会自动重新生成衍生文件但项目也保留了显式命令用于排障或手动刷新pnpm generate:connection-types该命令的实现在 scripts/sync-connection-types.mjs在 package.json 中注册为generate:connection-types: node scripts/sync-connection-types.mjs。它会校验全部 YAML 并重写以下三个提交入库的衍生文件crates/dbx-core/assets/database-drivers.manifest.json —— Rust 侧嵌入的驱动清单schemaVersion: 1drivers数组按描述符order排序apps/desktop/src/types/generated/databaseTypes.ts —— 前端DatabaseType类型列表apps/desktop/src/types/generated/connectionProfiles.ts —— 前端连接 profile 类型含ConnectionProfileCategory联合类型与CONNECTION_PROFILES常量。生成文件均带有 Do not edit manually 的头部注释不得手工编辑。前端类型检查pretypecheck与前端测试pretest钩子都会先自动执行生成见 package.json 中的pretypecheck: pnpm generate:connection-types、pretest: pnpm generate:connection-types确保衍生文件与 YAML 同步。Rust 侧则由构建脚本读取同一批 YAML。README 记载该逻辑位于crates/dbx-core/build.rs从仓库实际结构看实现位于 crates/dbx-types/build.rs它以crates/dbx-types为基准定位../../plugins/connection-types目录扫描全部.yaml/.yml文件cargo::rerun-if-changed监听目录与文件变更执行与前端一致的唯一性校验然后生成两个产物database_manifest.json剥离schemaVersion、order、rustVariant后的公开描述符清单嵌入为 Rust 侧 manifestdatabase_type.rs生成DatabaseType枚举每个变体带#[serde(rename dbType)]保证序列化名与 YAML 稳定 ID 一致并提供DatabaseType::ALL常量数组与as_str()方法。只读校验命令可用于不落盘地检查一致性pnpm check:connection-types它执行与生成相同的校验但不修改任何文件CI 中的pnpm check会自动运行这一只读检查因此即使提交了过期的衍生文件也会在验证阶段失败从流程上杜绝 YAML 与生成物漂移。七、新增连接类型的决策路径新增一个产品连接第一步是判断是否需要新的连接类型。规范给出的决策原则清晰务实只需要 catalog 条目和图标当一个产品与既有连接类型协议兼容、连接字段与 UI 工作流一致时例如在 catalog.yaml 中为既有dbType增加一个 profile 并配套图标即可无需任何代码。仓库中大量国产/兼容产品TDSQL、PolarDB、GreatSQL → mysqlGBase 8a/8s → gbaseCaché → irisH2 Legacy → h2 等正是以这种方式接入的。需要编写代码当新产品的协议、认证方式、连接字段、元数据提供器、查询执行器或 UI 工作流与现有实现不同时才需要新增连接类型及对应实现代码。formKind是有限编码它从一组预定义的连接表单中选择如mq、mqtt、jdbc不是任意 YAML 表单引擎因此不能通过 YAML 凭空发明新表单。优先复用协议兼容的产品应先绑定到现有方言dialect并复用最近的 connector 或 Agent再考虑引入独立实现——这与前文的 MySQL 生态产品全部复用dbType: mysql的模式一脉相承。结语DBX 的连接类型注册体系本质上是把类型注册、产品映射、能力声明、代码生成四件事解耦描述符 YAML 是权威契约catalog.yaml负责前端呈现能力矩阵与specializedSurface声明功能边界pnpm generate:connection-types与构建脚本把契约同步到 Rust 与前端三端。理解这套机制无论是排查连接问题、为既有产品补充 profile还是设计全新的连接类型都能快速定位到正确的修改点——而仓库中的 80 个描述符文件就是这套体系最完整的活文档。赞分享数据库客户端数据库桌面应用CLI后端MCP 服务AI 应用【免费下载链接】dbx25 MB lightweight cross-platform database client for 90 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、达梦等 90 数据库提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。项目地址https://gitcode.com/gh_mirrors/dbx7/dbx点击查看免费下载相关推荐在 Next.js 中集成 Mongoose连接管理、模型注册与双路由体系实战指南在 Next.js 中集成 Mongoose连接管理、模型注册与双路由体系实战指南 本文是一份面向 Next.js 全栈开发者的实战指南讲解如何在 Next数据库后端FLAN-T5-XXL 完全指南如何使用这个强大的110亿参数语言模型FLAN T5 XXL 完全指南如何使用这个强大的110亿参数语言模型 FLAN T5 XXL 是 Google 开发的一款强大的 110 亿参数语言模型它X6 连接器Connector完全指南内置连接器使用、自定义注册与 SVG 路径生成原理X6 连接器Connector完全指南内置连接器使用、自定义注册与 SVG 路径生成原理 导读 在 X6 中连接器Connector负责把边的起点、前端图形学创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考