切换主题
3.1.2 数据源管理
3.1.2.1 数据源管理
功能：数据源管理
功能说明 登记本项目可用的数据源：建连接、测连通、看详情。这里只做登记，真正用数据源的是建模、查询等模块。
适用场景 接入新的业务库；换了数据库密码后更新；任务连不上时先来测一下连通性。
操作步骤
- 左侧进入「数据源管理 > 数据源管理」。
- 点"新增数据源"，填写名称、选择类型后保存。
- 在列表行操作里点"测试连接"验证能不能通。
- 需要改配置时点"编辑"，看完整信息点"详情"。
列表字段说明
| 列名 | 说明 |
|---|---|
| 序号 | 行号 |
| 数据源名称 | 数据源显示名，项目内唯一 |
| 类型 | 数据库类型，如 MySQL、StarRocks、Paimon |
| 服务器 | 服务器地址 |
| 数据库 | 库名 |
| SSL | 是否启用 SSL |
| 创建人 | 创建该数据源的账号 |
| 创建时间 | 创建时间 |
| 操作 | 测试连接 / 详情 / 编辑 / 删除 |
左右滑动查看完整表格
新增数据源填写说明
| 字段 | 必填 | 说明 |
|---|---|---|
| 数据源名称 | 是 | 项目内唯一，限 50 字，建议写清"哪个库、什么用途" |
| 数据源类型 | 是 | 目标数据库类型，选错会导致后续连接失败 |
| 备注 | 否 | 补充说明 |
左右滑动查看完整表格
操作结果 保存后数据源出现在列表，建模与查询模块的下拉里能选到它；"测试连接"通过说明网络与账号都没问题。
注意事项
- 数据源名称在项目内唯一，重名保存不了。
- 被任务或查询引用后不要随意删除，删了会让相关任务直接失败。
- 连接账号建议只给需要的权限，不要用业务主账号。
常见问题
- 测试连接超时：九成是网络白名单没放行，找 DBA 确认。
- 提示认证失败：检查账号密码，以及该账号是否允许从当前网段登录。
3.1.2.2 认证文件管理
功能：认证文件管理
功能说明 集中管理数据源连接要用的证书与授权文件（如 SSL 证书、Kerberos 授权码）。数据源那边新建连接时，"证书"字段就是从这里的清单里选，不用每建一个连接就上传一次。
适用场景 连接启用了 SSL 的数据库；接入需要授权文件的外部系统；证书到期需要更换。
操作步骤
- 左侧进入「数据源管理 > 认证文件管理」。
- 用上方条件按关键字（证书名称 / 授权码）、证书类型筛选。
- 点"新增证书"，上传文件并填写名称、类型、用途描述后保存。
- 回到「数据源管理」，新建或编辑连接时在下拉里选择这张证书。
列表字段说明
| 列名 | 说明 |
|---|---|
| 证书名称 | 证书显示名，建议写清用途，如"shop 生产库 SSL" |
| 证书类型 | 证书分类，新建时选择，用于筛选与数据源侧的下拉分组 |
| 文件格式 | 上传文件的格式（如 pem、jks、crt） |
| 用途描述 | 这张证书用在哪，方便其他人判断能不能复用 |
| 创建人 | 上传人 |
| 创建时间 | 上传时间 |
| 操作 | 查看 / 删除等 |
左右滑动查看完整表格
新增证书填写说明
| 字段 | 必填 | 说明 |
|---|---|---|
| 证书名称 | 是 | 显示名，建议"环境 + 用途"，便于检索 |
| 证书类型 | 是 | 按实际用途选择，数据源侧按类型过滤 |
| 证书文件 | 是 | 上传证书或授权文件本体 |
| 用途描述 | 否 | 说明这张证书给哪些数据源用 |
左右滑动查看完整表格
操作结果 保存后证书出现在列表，并可在数据源连接的证书下拉中被选到。
注意事项
- 证书文件是凭证明文，不要外发；离职交接时由管理员统一更换。
- 已被数据源引用的证书不要删除，删了相关连接会直接连不上。
- 证书有有效期，到期前要更新，过期后连接会握手失败（表现为"认证失败"或"连接超时"）。
常见问题
- 数据源里选不到刚上传的证书：确认证书类型与数据源要求的类型一致，并刷新数据源页面。
- 连接报 SSL 相关错误：先确认证书是否过期，再确认证书与目标库的域名/IP 是否匹配。