Skip to main content
支持接入大多数符合 JDBC 协议的数据源。配置完成后可测试连通性，平台将自动解析表结构元数据。

​
支持的数据源

  • MySQL
  • PostgreSQL
  • Oracle
  • SQL Server
  • SQLite
  • MariaDB
  • H2
  • OceanBase
  • 达梦数据库
  • GaussDB

​
原理概览（Text2SQL）

在 Workflows 或 Agent 中关联数据源的表后，聊天阶段会将用户问题与关联表的 DDL 上下文一并提供给大模型：
  1. 大模型基于问题与 DDL 生成 SQL；
  2. 平台使用已配置的数据源连接执行该 SQL；
  3. 执行结果回传给大模型进行总结/回答。

​
新建与测试数据源

在平台进入：API 配置 -> 数据源配置，点击新建完成连接信息填写。 image-20250922164213287 保存后可直接测试连通性： image-20250922164752671

​
原始表DDL

点击已配置的数据源卡片，可浏览该数据源下的所有表与表结构： image-20251224162615880 在左侧可以看到这个数据源下面所有的表信息，包含字段信息等。

​
自定义DDL

选中左侧的表，可以点击导入到右侧的自定义面板中，在自定义DDL面板中可以随意修改表的字段信息和备注信息： image-20251224162824711
后续的系统中所有关于数据源的引用，都将仅展示配置的自定义DDL，不会再加载原始表的DDL信息。

​
引入更多驱动

当前内置仅包含 MySQL 与 PostgreSQL 的 Java 驱动。若需要接入其他数据库，请在后端工程中自行引入依赖并重新打包。 
<!-- MySQL -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.4.0</version>
<!-- PostgreSQL -->
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.7.3</version>
<!-- Oracle -->
<dependency>
    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc11</artifactId>
    <version>23.4.0.24.05</version>
<!-- SQL Server -->
<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
    <version>12.6.1.jre11</version>
<!-- SQLite -->
<dependency>
    <groupId>org.xerial</groupId>
    <artifactId>sqlite-jdbc</artifactId>
    <version>3.45.2.0</version>
<!-- MariaDB -->
<dependency>
    <groupId>org.mariadb.jdbc</groupId>
    <artifactId>mariadb-java-client</artifactId>
    <version>3.3.3</version>
<!-- H2 -->
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <version>2.2.224</version>
<!-- OceanBase -->
<dependency>
    <groupId>com.oceanbase</groupId>
    <artifactId>oceanbase-client</artifactId>
    <version>2.4.5</version>
<!-- 达梦数据库 -->
<dependency>
    <groupId>com.dameng</groupId>
    <artifactId>DmJdbcDriver18</artifactId>
    <version>8.1.3.14</version>
<!-- GaussDB -->
<dependency>
    <groupId>org.opengauss</groupId>
    <artifactId>opengauss-jdbc</artifactId>
    <version>5.0.0</version>
这些依赖通常由 langchat/langchat-common/langchat-common-bom\pom.xml 进行版本管理。

​
在 Agent 中使用 Text2SQL

完成数据源配置后，可在 Agent 构建时关联相应数据表： image-20250922172525572