Appearance
关系数据库
关系数据库用于通用的登记数据库连接,并供表单、列表、接口与后端脚本通过表、字段的 mapname 访问数据。
新增数据源
进入 数据管理 → 数据仓库(路由
/data-management/resource-management)。
单击工具栏【新增】按钮打开新增表单,选择数据库类型、填写数据源名称、主机地址、端口、用户名 、密码、数据库名、映射名称可快速创建。启用SSL、启用日志、表前缀、字段前缀、描述信息按需填写即可。

完成表单填写后点击确定,页面刷新后可见新增的数据源
提示: 映射名称(map_name)字段唯一,接口引擎多库调用时用该逻辑名。
支持的数据库类型:
| 值 | 类型 | 建议用途 |
|---|---|---|
0 | MySQL | 通用业务系统,当前平台使用该类型 |
1 | SQL Server | Microsoft 数据平台 |
2 | Oracle | Oracle 业务数据库 |
3 | SQLite | 本地或轻量场景 |
4 | 达梦 DM | 信创数据库 |
5 | 人大金仓 KingbaseES | 信创数据库 |
6 | PostgreSQL | 通用开源关系数据库 |
表单字段说明:
| 属性 | 名字 | 说明 |
|---|---|---|
| 数据库类型 | f_type | 见上文「支持的数据库类型」 |
| 名称 | f_name | 必填。列表展示名称 |
| 主机地址 | f_host | 必填。数据库服务地址 |
| 端口 | f_port | 必填。监听端口 |
| 用户名 | f_username | 必填。建议使用平台专用账号 |
| 密码 | f_password | 必填。勿写入文档或日志 |
| 数据库名 | f_database | 必填。物理库名 |
| 映射名称 | f_map_name | 必填、唯一。脚本多库路由用的逻辑名 |
| 启用 SSL | f_enable_tls | 是否 TLS |
| 启用日志 | f_enable_log | SQL 日志;排错时用 |
| 表前缀 | f_prefix_table | 新建物理表时使用 |
| 字段前缀 | f_prefix_column | 新建物理字段时使用 |
| 描述 | f_describe | 用途说明 |
| 同步标志 | f_sync_flag | 结构同步相关标记 |
编辑数据源
点击页面中的编辑按钮打开表单,编辑修改信息后点击确定按钮保存。
提示: 若改了主机、库名或账号,请再打开「操作」按钮用数据库管理器验证能否连上;已同步的表元数据不会因改连接而自动重建。
删除数据源
在列表中选中要删除的数据源。
单击操作列【删除】按钮,页面会弹出删除确认对话框防止误删数据,点击确认即可。

提示:
- 删除的是引擎库中的数据源登记(t_database等关联),不会自动删除物理库里的业务表数据。
- 删除前确认没有表单、列表、接口仍依赖该数据源的 id / map_name。
同步操作
创建数据源后并不能直接使用该数数据源的数据,需要将数据源中的物理表同步为平台的元数据。点击页面的【操作】按钮,打开全屏 数据库管理器,在这里进行同步操作。

同步表到引擎
1.选择需要同步的物理表所在的数据源。

2.选择需要同步的物理表,点击【同步该表】按钮即可,同步后可以看到表设计字段

新增字段
若同步后的表的字段不能满足需求,需要增加字段。操作步骤如下:
点击【新增字段】按钮,填写表单信息,下方会自动生成SQL。点击【执行并同步】即可增加字段,也可以点击【插入到SQL】到SQL中去执行操作。
编辑字段
同步后的表字段可做修改,点击【修改】弹出如图对话框,修改表单完成后点击【执行并同步】即可修改字段,也可以点击【插入到SQL】到SQL中去执行操作。

删除字段
表同步后一些字段是不需要的,存在冗余可以点击【删除】按钮对字段进行删除操作,点击【删除】按钮会弹出如图对话框,点击【执行并同步】即可删除字段,也可以点击【插入到SQL】到SQL中去执行删除操作。

SQL操作
查询同步后的表数据可以点击【查询模板】或是直接点击【SQL】页签,模块切换到SQL,可在此处用SQL语句查询或操作数据源。

常见问题
同步失败
检查数据源连接(主机、端口、账号、库名、SSL),以及数据库账号是否有读表结构权限。
表单里选不到表或字段
先在数据库管理器对该表执行【同步该表】,再刷新表单设计器。
后端脚本查询不到表
DatabaseService.Query 的 table 用表 map_name;多库还要传数据源 map_name,不要用显示名或记录 ID。
