跳到主要内容

数据源与结构扫描

扫描定义、创建数据集或开放 API 服务前,需要先创建数据源。

创建数据源​

  1. 打开 数据连接 → 数据源,新建数据源。
  2. 填写名称,选择 PostgreSQL、MySQL、MariaDB、SQL Server 或 Oracle。
  3. 填写主机、端口、数据库、用户名和密码。Oracle 填写 服务名,不是完整连接描述符。
  4. 设置 TLS,需要时提供 CA 证书。
  5. 点击 测试连接,检查配置。
  6. 保存。保存时会再次测试提交的配置,测试失败则无法保存。

数据库账号需要具备对应操作的权限。查询需要读取权限;API 新增、更新和删除还需要数据库授予相应权限。配置 API 角色不会给数据库账号增加权限。

编辑已有数据源时,密码留空会保留已保存的密码。密码加密存储,数据源详情不会返回密码原文。

TLS​

TLS 保护的是租户 Runtime 与来源数据库之间的连接,与浏览器或 API 客户端使用的 HTTPS 分别设置。

设置行为
开启请求加密连接,并验证数据库服务器证书和身份
关闭不请求 TLS,传输可能不加密
未填写 CA 证书使用驱动默认的证书信任配置
填写自定义 CA 证书使用提供的 PEM 证书验证服务器证书

数据库需要支持 TLS。证书过期、不受信任或主机名不匹配都可能导致连接失败;TLS 失败后不会自动改用明文连接。

使用私有 CA 或自签名证书时,请提供对应的可信证书,并使用与服务器证书匹配的主机名。Oracle 使用 TCPS 和服务器身份验证,其连接表单不提供 CA 证书上传。

扫描数据库结构​

  1. 打开数据源的结构页面。
  2. 发起结构扫描,等待完成。
  3. 浏览数据库模式和表,查看列、原生类型、主键及关系。
  4. 在变更视图中对比上次扫描结果。

快照保存结构描述,不复制业务记录。结构扫描不会修改来源表。

数据库结构经常变更时,可以配置定时扫描。保存后检查最近结果和下次执行时间。

来源变更后刷新​

来源数据库的列、键或表发生变化后:

  1. 重新扫描结构。
  2. 打开受影响的表单模型和数据集。
  3. 刷新结构,处理缺失或失效的字段、关联关系。
  4. 确认配置后保存,并进行数据预览。

已保存的数据集会保留其选定的结构,直到刷新确认并保存。若数据库变更导致原配置无法使用,查询可能被阻止,需要先修复配置。

常见问题​

现象检查内容
无法连接Runtime 到数据库的网络、主机、端口和数据库监听服务
身份验证失败用户名、密码和数据库登录策略
数据库不存在数据库名称或 Oracle 服务名
TLS 失败数据库 TLS 支持、证书链、有效期和主机名匹配
连接成功,但无法读取表或查询数据库账号对模式、表及操作的权限

接下来可以扫描表单定义,或直接从数据库表创建数据集。