低代码方式将达梦数据库发布为RESTful API

随着信创产业的推进，达梦数据库在金融、电力、政务等核心领域的应用日益广泛。然而，在系统架构现代化的过程中，开发团队常面临一个痛点：如何快速将沉淀在达梦数据库中的核心业务数据，以标准的 HTTP 接口形式暴露给前端、移动端或第三方系统？

传统的做法是开发一套 Java (Spring Boot) 或 Go 的后端服务，引入 JDBC 驱动，编写 Controller/Service/Dao 层代码。这种方式虽然灵活，但在面对简单的查数需求或快速原型验证时，开发链路过长。

本文将介绍如何通过纯 SQL 的方式连接达梦数据库，并在分钟级内生成标准的 RESTful API。

1. 环境准备与架构说明

在开始之前，我们需要理解 QuickAPI 在架构中的角色。它充当了 API Gateway 与 SQL 执行引擎 的中间件：

• 连接： 通过 JDBC 协议连接达梦数据库（默认端口 5236）。
• 服务： 将 SQL 执行结果序列化为 JSON，并发布为 RESTful 接口。

前提条件：

• 已安装 QuickAPI 平台。
• 已部署达梦数据库（DM8 或 DM7 ），并确保网络连通。

2. 配置 QuickAPI 与达梦数据库的连接

步骤 1：配置数据源

登录 QuickAPI 控制台，进入 [数据源管理] 页面，点击 [添加新数据源]。在数据库类型列表中选择 DM，并填写如下连接信息：

• 主机地址 (Host)： 达梦数据库服务器 IP（例如：192.168.100.50）
• 端口 (Port)： 达梦默认端口为 5236（注意与 MySQL 的 3306 区分）。
• 用户名 (User)： 通常为 SYSDBA 或业务账号。
• 密码 (Password)： 对应的数据库密码。
• Schema (模式)： 建议填写默认模式名，如 SYSDBA。

点击 [测试连接]，显示“连接成功”后保存配置。

步骤 2：数据表准备 (DDL)

为了演示，我们需要在达梦数据库中创建一张员工表。 注意： 达梦的 SQL 语法遵循 ANSI 标准，但在自增主键等细节上与 MySQL 不同。MySQL 使用 AUTO_INCREMENT，而达梦通常使用 IDENTITY 属性。

在 QuickAPI 的 [SQL 编辑器] 或达梦管理工具中，执行以下 DDL 语句：

-- 创建员工表 (注意：达梦自增列使用 IDENTITY) CREATE TABLE "SYSDBA"."EMPLOYEE" ( "ID" INT IDENTITY(1,1) NOT NULL, -- 从1开始，步长为1 "FIRST_NAME" VARCHAR(50) NOT NULL, "LAST_NAME" VARCHAR(50) NOT NULL, "EMAIL" VARCHAR(100) NOT NULL, "HIRE_DATE" DATE NOT NULL, CLUSTER PRIMARY KEY("ID") ); -- 插入测试数据 INSERT INTO "SYSDBA"."EMPLOYEE" ("FIRST_NAME", "LAST_NAME", "EMAIL", "HIRE_DATE") VALUES ('John', 'Doe', '[email protected]', '2023-05-01'); INSERT INTO "SYSDBA"."EMPLOYEE" ("FIRST_NAME", "LAST_NAME", "EMAIL", "HIRE_DATE") VALUES ('Jane', 'Smith', '[email protected]', '2022-07-15'); COMMIT; 

3. 编写 SQL 逻辑并生成 API

配置好数据源后，我们直接通过 SQL 定义 API 的业务逻辑。

步骤 1：编写查询逻辑

进入 [数据 API] -> [API 配置] 页面。 在 SQL 脚本区域，编写查询语句。达梦数据库对标识符大小写较为敏感，虽不强制加双引号，但建议保持规范。

SELECT "ID", "FIRST_NAME", "LAST_NAME", "EMAIL", "HIRE_DATE" FROM "SYSDBA"."EMPLOYEE"; 

点击 [运行] 按钮，下方的结果栏应显示刚刚插入的 JSON 格式数据。

步骤 2：配置动态参数

在实际业务中，我们通常需要按 ID 查询。QuickAPI 支持使用 {{param}} 语法进行参数注入，这会自动处理预编译，防止 SQL 注入。

将 SQL 修改为：

SELECT "ID", "FIRST_NAME", "LAST_NAME", "EMAIL", "HIRE_DATE" FROM "SYSDBA"."EMPLOYEE" WHERE "ID" = {{emp_id}}; 

系统会自动识别 emp_id 为请求参数。你可以设置其类型为 Integer，并标记为“必填”。

步骤 3：数据格式映射

QuickAPI 会自动将达梦返回的 ResultSet 映射为标准的 JSON 对象：

{ "ID": 1, "FIRST_NAME": "John", "LAST_NAME": "Doe", "EMAIL": "[email protected]", "HIRE_DATE": "2023-05-01" } 

注：达梦默认返回的字段名通常为大写。如果前端需要小写驼峰命名（如 firstName），可在 SQL 中使用别名：SELECT "FIRST_NAME" AS "firstName" ...。

4. 定义接口规范与发布

步骤 1：路由配置

设置 API 的基本属性，使其符合 RESTful 规范：

• API 名称： 查询员工详情
• 请求方法：GET
• 接口路径：/api/dm/employee/info
• Content-Type：application/json

步骤 2：发布与鉴权

点击 [发布] 按钮，API 即刻上线。 为了安全起见，建议在 [API 管理] 页面开启鉴权（如 API Token 或 Basic Auth），防止接口被未授权访问。

5. 验证与监控

使用 Postman 或 curl 进行调用验证：

curl -X GET "http://localhost:8080/api/dm/employee/info?emp_id=1" 

同时，在 QuickAPI 的 [监控看板] 中，你可以实时查看到该接口针对达梦数据库的调用日志。

总结

通过 QuickAPI，我们将达梦数据库的表数据发布为 RESTful API 的过程缩短到了分钟级。这种方案规避了繁琐的后端工程搭建，特别适合数据中台取数、报表大屏对接以及遗留系统微服务化改造等场景。

开发者只需掌握基本的 SQL 语法，即可完成从数据存储到数据服务的全链路交付。