数据连接
功能概览
功能定位
数据连接用于统一登记平台访问外部数据源所需的连接类型、服务地址和认证参数,并向元数据采集、数据研发、数据治理、数据资产与数据服务等功能提供可复用的接入基础。
简单理解:先把“平台怎样连接目标数据源”配置清楚,后续页面才能引用这条连接访问数据库、消息队列、文件服务或对象存储。
使用建议
新增连接时,建议按选择连接类型 -> 填写地址与认证参数 -> 使用【测试连接】核对参数 -> 确认保存的顺序操作。维护已有连接时,先确认目标记录名称和类型,避免修改到相似连接。
主要特性
- 多类型数据源接入:支持关系型数据库、大数据组件、NoSQL、消息队列、文件服务和对象存储等连接类型;
- 统一公共字段:集中维护数据连接名称、类型、IP、端口号、账号、密码、状态、描述和备注;
- 双测试入口:可在列表目标行或新增、修改弹窗中使用【测试连接】;
- 状态控制:启用连接可在其他引用位置显示和选择;禁用只影响其他引用位置的可见、可选范围;
- 删除引用保护:被其他业务引用的数据连接不允许删除,原记录继续保留。
作用范围
本页适用于数据连接的查询、新增、修改、测试、状态设置、详情查看和删除。页面负责保存访问参数,不负责配置下游采集任务、研发任务或数据服务。
前置步骤
前置条件
- 已登录 qData 平台并具备【数据资产】相关菜单权限。
- 已准备目标数据源的 IP、端口号、账号和密码。
- qData 所在网络可以访问目标数据源。
- 已确认需要选择的数据连接类型。
导航路径
数据资产 > 数据连接
页面总览
数据连接页面由查询区、连接列表、行操作和分页区组成。查询区可按数据连接名称、数据连接类型和 IP 定位记录;列表展示连接名称、描述、类型、状态和创建信息;每条记录提供【测试连接】【详情】和【更多】入口。

| 区域 | 主要内容 | 使用说明 |
|---|---|---|
| 查询区 | 数据连接名称、数据连接类型、IP、【查询】、【重置】 | 组合输入条件定位目标连接。 |
| 列表区 | 编号、数据连接名称、描述、数据连接类型、状态、创建人、创建时间 | 核对连接基础信息和状态。 |
| 行操作 | 【测试连接】【详情】【更多】 | 【更多】中包含【修改】和【删除】。 |
| 分页区 | 总条数、每页条数、页码 | 切换查看不同页记录。 |
推荐操作流程
新建连接:点击【新增】 -> 选择数据连接类型 -> 填写公共连接参数 -> 按需设置限制操作和状态 -> 使用【测试连接】 -> 点击【确定】。
核对连接:按名称、类型或 IP 查询 -> 在目标行点击【测试连接】 -> 如需调整参数,进入【更多】>【修改】。
停用或清理:先核对下游引用 -> 暂不使用时设置为禁用 -> 确认不再被业务引用后再进入删除流程。
功能操作说明
| 操作 | 使用场景 | 简化操作 |
|---|---|---|
| 查询 | 连接记录较多,需要快速定位目标连接。 | 填写名称、选择类型或输入 IP,点击【查询】;重新设置条件时点击【重置】。 |
| 新增 | 接入新的数据库、中间件、文件服务或对象存储。 | 点击【新增】,选择类型并填写连接参数,按需测试后点击【确定】。 |
| 测试连接 | 需要核对目标服务和认证参数是否可用。 | 在列表目标行点击【测试连接】,或在新增、修改弹窗底部点击【测试连接】。 |
| 详情 | 需要查看目标连接的完整配置和维护信息。 | 在目标记录右侧点击【详情】。 |
| 修改 | 地址、端口、认证信息、状态或说明需要调整。 | 点击目标行【更多】>【修改】,调整后点击【确定】。 |
| 删除 | 连接已废弃且不再被其他业务引用。 | 点击【更多】>【删除】,核对提示后确认删除。 |
查询和浏览数据连接
- 在【数据连接名称】中输入连接名称。
- 按需选择【数据连接类型】。
- 在【IP】中输入目标服务地址。
- 点击【查询】;需要重新设置条件时点击【重置】。
- 在列表中核对连接类型、状态、创建人和创建时间,并通过分页区切换记录。
新增数据源
点击页面中的【新增】按钮,在弹出框内填写数据源信息,并点击【确定】按钮,完成数据源新增。

新增时重点填写以下字段:
| 字段名 | 说明 | 是否必填 |
|---|---|---|
| 数据连接名称 | 连接在平台中的展示名称。 | 是 |
| 数据连接类型 | 目标数据源使用的驱动或协议类型。 | 是 |
| IP | 目标服务地址。 | 是 |
| 端口号 | 目标服务端口。 | 是 |
| 账号 | 连接认证账号。 | 是 |
| 密码 | 连接认证密码。 | 是 |
| 限制操作 | 选择【不限制】或【限制】,仅保存标记状态。 | 否 |
| 状态 | 设置为【启用】或【禁用】。 | 否 |
| 描述 | 连接用途说明,最多 500 个字符。 | 否 |
| 备注 | 补充维护信息,最多 500 个字符。 | 否 |
选择数据连接类型
页面支持多种数据源,覆盖关系型数据库、大数据与计算组件。填写时以所选类型页面实际展示字段为准。
| 类型分组 | 数据连接类型 |
|---|---|
| 关系型数据库 | MySql、DM8、Oracle、Oracle11、Kingbase8、SQL_Server、SQL_Server2008 |
| 大数据与计算组件 | Doris |
测试连接
选择需测试连接的数据源信息,在操作列中点击【测试连接】按钮,系统将测试数据源的连接情况,并返回测试结果。

测试前重点核对连接类型、IP、端口号、账号和密码;如果当前连接类型包含数据库名称、SSL 认证等专属参数,也需要一并核对。
数据源详情
选择需查看详情的数据源信息,在操作列中点击【详情】按钮,在弹出框中查看数据源信息详情。

详情页主要用于核对数据连接的基础信息、连接类型、网络地址、状态、描述、备注和创建更新信息。查看详情不会修改连接配置。
修改数据源
选择需修改的数据源信息,在操作列中点击【更多】->【修改】按钮,在出现的弹出框内修改已有数据源信息,并点击【确定】按钮,完成数据源信息修改。

修改时常见字段如下:
| 字段名 | 说明 | 是否必填 |
|---|---|---|
| 数据连接名称 | 当前连接的展示名称。 | 是 |
| 数据连接类型 | 当前连接类型,部分类型修改时不可编辑。 | 是 |
| IP | 目标服务地址。 | 是 |
| 端口号 | 目标服务端口。 | 是 |
| 账号 | 连接认证账号。 | 是 |
| 密码 | 连接认证密码。 | 是 |
| 状态 | 选择【启用】或【禁用】。 | 否 |
| 描述 | 连接用途说明。 | 否 |
| 备注 | 补充维护信息。 | 否 |
设置连接状态
- 在目标记录行使用状态开关设置启用或禁用。
- 也可以进入【修改】,在【状态】中选择【启用】或【禁用】后提交。
状态规则如下:
- 启用:连接可在其他引用位置或页面显示、选择;
- 禁用:连接从其他引用位置或页面的可见、可选范围中移除;
- 数据影响:禁用不会删除或修改当前连接及既有历史数据,也不会级联改变其他对象。
删除数据源
选择需删除的数据源信息,在操作列中点击【更多】->【删除】按钮,并点击【确定】按钮,系统将删除该数据源信息。

删除前请确认该连接不再被采集任务、数据研发任务、数据服务或其他业务配置引用。若系统检查到存在引用,通常不会执行删除,并保留原记录。
常见问题
可以选择哪些数据连接类型?
页面支持关系型数据库、大数据与计算组件、NoSQL、消息队列、文件服务和对象存储等类型,具体以新增弹窗中的类型列表为准。为什么不同类型显示的字段可能不同?
公共表单维护通用访问参数,具体类型可以显示额外参数;填写时以所选类型页面显示的字段为准。禁用连接会删除已有数据吗?
不会。禁用只影响该连接在其他引用位置中的显示和选择,不删除当前连接或历史数据,也不改变其他对象。被其他业务引用的连接可以删除吗?
不可以。系统检查到其他业务引用时不执行删除,并保留原记录。测试连接前应重点检查什么?
先核对连接类型、IP、端口号、账号和密码,再核对该类型显示的专属参数。
总结
维护数据连接时,应重点核对三项:连接类型与地址是否匹配、认证参数是否准确、禁用或删除前是否已确认下游引用。新增或修改后,可使用页面提供的【测试连接】入口核对参数,再交由下游页面引用。
