数据连接

千桐科技2025/8/27大约 10 分钟

功能概览

功能定位

数据连接用于在当前项目中查看和管理可用的数据源连接，为数据集成、数据开发、作业等下游任务提供访问数据库、大数据平台、消息队列、文件服务或对象存储的连接基础。

简单理解：先在正确的项目中准备好数据连接，下游任务才能使用这些连接读取或写入数据。

使用建议

首次配置时，先确认顶部【所属项目】，再填写连接参数；可按需执行【测试连接】，也可以直接保存。准备关闭或删除连接前，应先确认没有下游任务正在引用该连接。

主要特性

项目化管理：在所属项目中查询、创建和维护项目自有连接。
来源边界保护：基础管理创建的连接可在项目中查看和使用，但不能在项目内修改、执行维护性状态变更或删除。
独立连通性验证：列表和新增弹窗均提供【测试连接】，测试不是保存前置条件。
关联保护：存在下游关联任务时，不允许关闭或删除项目自有连接。
详情查看：通过运行监控、读写日志、告警记录、告警规则和基本信息五个页签查看连接信息。
操作留痕：新增、修改、删除和查询按照系统现有机制记录操作日志。

作用范围

本页适用于数据研发项目中的连接查询、新增、修改、测试、状态维护、条件删除和详情查看。页面访问及按钮权限由后台配置，不固定到具体岗位角色。

项目内创建的连接由项目独立管理，并可在基础管理平台展示；基础管理创建的连接可以在项目中查看和使用，但不能在项目内修改、执行维护性状态变更或删除。

前置步骤

前置条件

已登录 qData 平台，并具备【数据研发】和【数据连接】菜单权限。
已在顶部切换到需要维护连接的所属项目。
新增、修改或测试连接前，已准备目标服务的地址、端口、账号和密码等连接信息。
关闭或删除连接前，已确认该连接没有被数据集成、数据开发、作业或其他下游任务引用。

导航路径

数据研发 > 数据连接

页面总览

进入【数据连接】后，页面顶部显示当前【所属项目】和“数据连接 — 统一管理多源异构数据接入”说明条；查询区提供数据连接名称、数据连接类型和 IP 条件；列表展示连接类型、状态、创建信息及行操作。每条记录可通过【测试连接】验证连通性，通过【详情】查看连接信息，并从【更多】进入维护操作。

功能操作说明

查询和浏览数据连接

确认顶部【所属项目】为目标项目。
在“数据连接名称”输入框填写目标连接名称。
在“数据连接类型”下拉框选择目标类型。
在“IP”输入框填写目标服务地址。
点击【查询】查看符合条件的连接。
点击【重置】恢复默认查询条件。
按需点击“编号”或“创建时间”列的排序入口调整列表顺序。
在列表中核对连接名称、类型、状态、创建人和创建时间。

新增项目数据连接

点击列表上方的【新增】。
查看【新增数据源】弹窗。

页面支持多种数据源，覆盖关系型数据库、大数据与计算组件。填写时以所选类型页面实际展示字段为准。

类型分组	数据连接类型
关系型数据库	MySql、DM8、Oracle、Oracle11、Kingbase8、SQL_Server、SQL_Server2008
大数据与计算组件	Doris

新增时重点填写以下字段：

字段名	说明	是否必填
数据连接名称	填写当前项目中便于识别的连接名称。	是
数据连接类型	选择连接驱动或协议类型。	是
IP	填写目标服务地址。	是
端口号	填写目标服务端口。	是
账号	填写连接认证账号。	是
密码	填写连接认证密码。	是
限制操作	选择“不限制”或“限制”，默认“不限制”；该字段当前仅作信息展示。	否
状态	选择【启用】或【禁用】，默认【禁用】。	否
描述	填写连接用途说明，界面显示 500 字符计数。	否
备注	填写补充信息，界面显示 500 字符计数。	否

在“数据连接名称”中填写连接名称。
在“数据连接类型”中选择目标类型。
在“IP”中填写目标服务地址。
在“端口号”中填写目标服务端口。
在“账号”中填写认证账号。
在“密码”中填写认证密码。
在“限制操作”中保留默认值或选择目标值。
在“状态”中保留默认值或选择目标状态。
按需填写“描述”。
按需填写“备注”。
如需验证当前参数，点击【测试连接】。
点击【确定】保存连接。
返回列表核对新增连接。

如需终止本次新增，可点击【取消】或弹窗右上角的关闭入口。

保存成功后，新连接在当前项目列表中可见，并可在基础管理平台展示；系统同时记录新增操作日志。

测试数据连接

在列表中定位目标连接，或打开新增数据源弹窗。
如在弹窗中测试，先准备测试所需的连接参数。
点击【测试连接】。
查看页面反馈。

测试成功后，页面显示绿色提示“数据库连接成功”。从列表或新增弹窗发起测试时，均以当前页面反馈为准。

测试与保存

【测试连接】是独立验证动作，不是保存前置条件。用户也可以不执行测试，直接点击【确定】保存。出现异常时，请以页面实际提示为准。

修改项目自有连接

在列表中定位由当前项目创建的连接。
点击目标记录的【更多】。
点击【修改】。
调整页面允许编辑的字段。
点击【确定】提交修改。
返回列表或详情核对最新信息。

修改成功后，系统更新列表和详情信息，并记录修改操作日志。基础管理创建的连接不能在项目内修改，请在其来源范围内进行维护。

将项目自有连接切换为禁用

在列表中定位由当前项目创建的连接。
确认该连接没有下游关联任务。
点击目标记录的状态开关。
将连接状态切换为【禁用】（即关闭连接）。
核对连接状态是否完成更新。

删除项目自有连接

确认目标连接由当前项目创建。
确认目标连接已经处于【禁用】（关闭）状态。
确认目标连接没有下游关联任务。
点击目标记录的【更多】。
点击【删除】。
在二次确认中核对删除对象。
点击确认按钮执行删除，或点击取消按钮终止操作。
返回列表核对目标连接是否已移除。

查看连接详情

在列表中定位目标连接。
点击【详情】。
查看连接摘要。
查看 SSL 认证状态。
查看限制操作和更新人。

基本信息页不展示密码。“限制操作”只保留“不限制/限制”的字段展示，不产生权限、读写或任务运行方面的具体业务约束。

常见问题

保存前必须先测试连接吗？
不必须。【测试连接】是独立验证动作，可以先测试，也可以直接点击【确定】保存。
为什么项目中的连接无法修改、切换状态或删除？
先确认连接来源。基础管理创建的连接可以在项目中查看和使用，但不能在项目内修改、执行维护性状态变更或删除。项目自有连接的操作还需要满足后台权限、状态和下游引用等条件。
为什么项目自有连接无法切换为禁用？
请检查后台权限和下游引用情况。存在下游关联任务时，系统不允许将状态切换为【禁用】，连接保持原状态。
运行监控、读写日志或告警中的数值可以作为真实判断依据吗？
不可以。相关页签中的数值、阈值、状态和操作结果为前端示例，本页只说明字段和入口。
读写日志就是数据连接操作日志吗？
不是。详情中的【读写日志】是前端示例页签；数据连接新增、修改、删除和查询的操作日志由系统现有日志机制记录。

总结

数据连接页面用于在项目范围内准备和维护下游任务所需的连接。使用时请重点核对所属项目、连接来源、连接参数、下游引用和删除条件；测试连接可以按需执行，基础管理连接在项目内只能查看和使用，监控、日志和告警示例不作为真实业务规则。